> ## Documentation Index
> Fetch the complete documentation index at: https://docs.devinenterprise.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Servidores MCP de plugins en Devin

> Declara servidores MCP en un plugin de Devin y decide quién aporta la credencial: cada miembro, una cuenta de servicio de la organización o la empresa.

Un plugin puede incluir servidores MCP (por ejemplo, un gestor de incidencias) para que todos los que lo instalen obtengan la misma configuración del servidor sin tener que configurarlo desde cero. Después de instalarlo, proporcionas las credenciales que necesite el servidor, como una clave de API o un inicio de sesión con OAuth. Una conexión puede ser personal o compartida, según dónde esté instalado el plugin y el ajuste **Acceso** de la instalación.

## La declaración

Declara los servidores en un archivo `.mcp.json` ubicado en la raíz, como un mapa `mcpServers`. El campo inline `mcpServers` del manifest admite el mismo mapa, pero sin el contenedor.

```json theme={null}
{
  "mcpServers": {
    "example-mcp": {
      "url": "https://mcp.example.com/mcp",
      "tokenScope": "user"
    },
    "example-mcp-service-account": {
      "url": "https://mcp.example.com/mcp",
      "headers": {
        "Authorization": "Bearer ${EXAMPLE_MCP_SERVICE_ACCOUNT_TOKEN}"
      }
    }
  }
}
```

| Campo | Tipo | Qué hace |
| - | - | - |
| `url` | string | El endpoint del servidor. Obligatorio. |
| `transport` | string | Establece `"sse"` para un endpoint de SSE heredado. Omítelo para Streamable HTTP. |
| `headers` | object | Cabeceras HTTP que se envían con cada solicitud. Los valores pueden contener marcadores de posición. |
| `oauthClientId` | string | Un cliente OAuth prerregistrado, para proveedores sin registro dinámico de clientes. Si se establece, el servidor pasa a ser OAuth, independientemente de sus cabeceras. |
| `oauthClientSecret` | string | No se admite desde un plugin: la declaración se rechaza. El administrador que realiza la instalación introduce el secreto en la configuración del servidor. |
| `oauthScopes` | string\[] | Ámbitos que se solicitan. Requiere `oauthClientId`. |
| `oauthResource` | string | Anula el parámetro `resource` de RFC 8707 (predeterminado: la URL del servidor). `""` lo omite; cualquier otro valor debe identificar a este servidor. |
| `tokenScope` | string | **Acceso** predeterminado para una instalación de organización o de empresa de un servidor OAuth: `"user"` (cada miembro inicia sesión) o `"org"` (una conexión compartida). Si no se establece, se aplica el ámbito de la entrada del mercado de aplicaciones o, en su defecto, una conexión compartida. Un valor declarado se vuelve a aplicar cada vez que se reconcilia el plugin. Una instalación personal siempre usa la conexión del propio miembro. |
| `disabled` | boolean | Con `true`, se omite el servidor. |
| `disabledTools` | string\[] | Nombres de las herramientas de este servidor que se ocultan a Devin. |
| `description` | string | Se muestra junto al servidor en Personalizar. |

**Marcadores de posición.** El instalador rellena `${NAME}` en `url` o `headers` desde la hoja Conectar del servidor. `${NAME:-default}` proporciona un valor de fallback cuando no hay nada guardado. Un servidor de plugin solo lee los valores guardados en su instalación, no los [secretos de sesión](https://docs.devinenterprise.com/es/product-guides/secrets.md) con el mismo nombre. Nunca escribas un token real en una declaración: se almacena tal cual.

Un servidor también puede ejecutar un comando local (`command`, `args`, `env`); en ese caso no admite ninguno de los campos de credenciales HTTP anteriores.

> [!NOTE]
>
> La página de [servidores MCP](https://docs.devinenterprise.com/es/work-with-devin/mcp.md#configuration-format) documenta el formulario de Personalizar para un servidor independiente. El servidor de un plugin usa los nombres de campo anteriores, y su URL, transporte y cabeceras se muestran como de solo lectura en la fila instalada.

## Quién tiene la credencial

| Instalado por | La credencial pertenece a | Quién se conecta |
| - | - | - |
| Un miembro (ámbito personal) | Ese miembro | El propio miembro, desde Personalizar → MCPs |
| Una organización | La organización (`Access: Organization`) o cada miembro (`Access: Personal`) | Un Admin de org o cada miembro |
| La empresa | La empresa (`Access: Enterprise`) o cada miembro de todas las organizaciones (`Access: Personal`) | Un administrador empresarial o cada miembro |

## Configuraciones

Cada configuración combina una entrada de la declaración anterior con el lugar donde se instala el plugin y la forma en que se distribuye: **Obligatorio** lo instala para todos los usuarios del ámbito, mientras que **Ofrecido** permite que cada organización o miembro decida si instalarlo. Ambas opciones se configuran en el plugin desde [Personalizar](https://docs.devinenterprise.com/es/product-guides/plugins.md#mcps).

### OAuth por usuario para todos

Si el servidor admite OAuth, usa la entrada `example-mcp` e instala el plugin como **Obligatorio** a nivel de empresa u organización.

`tokenScope: "user"` establece **Personal** como valor predeterminado de Acceso, de modo que cada miembro inicia sesión una sola vez, ya sea desde Personalizar → MCPs o desde la primera sesión que lo requiera.

### Una cuenta de servicio de organización

Usa la entrada `example-mcp-service-account` e instala el plugin a nivel de organización.

* El encabezado `Authorization` contiene un marcador de posición, así que la fila muestra **Conectar**. Un admin de org introduce el token; los miembros nunca lo ven.
* Si el servidor rechaza el token (401), la fila muestra **Comprueba la credencial**. Si el servidor también admite OAuth, la fila añade **Iniciar sesión con OAuth en su lugar**.
* Si la cuenta de servicio inicia sesión con OAuth, elimina el encabezado, establece `tokenScope: "org"` y conecta el inicio de sesión de esa cuenta.

### Una clave por organización

Incluye la entrada `example-mcp-service-account` en un plugin de empresa y configúralo como **Ofrecido a las organizaciones**.

* Cada organización que lo instala es propietaria de su instalación, por lo que su administrador rellena `${EXAMPLE_MCP_SERVICE_ACCOUNT_TOKEN}` con la clave de esa organización.
* No se conecta nada a nivel de empresa y ninguna organización puede ver la clave de otra.
* En cambio, un plugin de empresa **Obligatorio** crea una única instalación propiedad de la empresa: una sola clave para todas las organizaciones.

### Ambas en un plugin

Incluye ambas entradas, como en la declaración anterior, y ofrece el plugin. Cada organización que lo instale obtendrá dos filas: una con la que los miembros inician sesión y otra que conecta el Admin de org. Al usar nombres de servidor distintos, las skills del plugin pueden indicar qué servidor usar.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.