Configuración de MCP

Agregar servidores MCP

Desde la línea de comandos

La forma más rápida de agregar un servidor MCP:

# servidor stdio — simplemente pasa el comando después de --
devin mcp add <name> -- <command> [args...]

# servidor HTTP — pasa la URL como argumento posicional
devin mcp add <name> <URL>

# servidor HTTP — o usa el flag --url
devin mcp add <name> --url <URL>

El tipo de transporte se infiere automáticamente: una URL implica HTTP (Streamable HTTP), y los argumentos al final (o --command) implican stdio.

Los servidores MCP remotos usan Streamable HTTP de forma predeterminada. Si el servidor responde con un error HTTP 4xx, la CLI recurre a SSE en la misma URL. Establece "transport": "sse" explícitamente si es necesario; consulta fallback heredado a SSE más abajo.

De forma predeterminada, los servidores se guardan en el ámbito local (.devin/config.local.json, gitignored). Usa -s/--scope para cambiarlo:

devin mcp add -s project <name> <URL>   # compartido mediante .devin/config.json
devin mcp add -s user <name> <URL>      # global (~/.config/devin/config.json; %APPDATA%\devin\config.json en Windows)

También puedes gestionar servidores desde la línea de comandos:

devin mcp list              # List all configured servers
devin mcp get <name>        # Show details for a specific server
devin mcp remove <name>     # Remove a configured server
devin mcp login <name>      # Authenticate with a server via OAuth
devin mcp logout <name>     # Remove stored credenciales OAuth
devin mcp enable <name>     # Habilitar un servidor deshabilitado
devin mcp disable <name>    # Deshabilitar un servidor sin eliminarlo

Mediante el archivo de configuración

Agrega servidores directamente a la sección mcpServers de tu archivo de configuración:

Configuración del proyecto
Configuración de usuario
Anulación local

// .devin/config.json
{
  "mcpServers": {
    "server-name": {
      "command": "npx",
      "args": ["-y", "@company/mcp-server"],
      "env": {
        "API_KEY": "your-key"
      }
    }
  }
}

Los servidores del proyecto se comparten con tu equipo a través del control de versiones.

// ~/.config/devin/config.json
{
  "mcpServers": {
    "my-server": {
      "command": "node",
      "args": ["/path/to/my-server.js"],
      "env": {}
    }
  }
}

Los servidores de usuario se aplican a todos tus proyectos.

// .devin/config.local.json
{
  "mcpServers": {
    "server-name": {
      "command": "npx",
      "args": ["-y", "@company/mcp-server"],
      "env": {
        "API_KEY": "my-personal-key"
      }
    }
  }
}

Los archivos de configuración locales están en .gitignore; úsalos para claves de API personales.

Opciones de configuración de servidores

Los servidores MCP se pueden configurar de dos maneras: como un comando local (transporte stdio) o como un servidor remoto (transporte HTTP).

Comando local (stdio)

Campo	Tipo	Obligatorio	Descripción
`command`	string	Sí	El ejecutable que se ejecutará
`args`	string[]	No	Argumentos de la línea de comandos
`env`	object	No	Variables de entorno que se deben establecer
`disabled`	boolean	No	Establécelo en `true` para omitir este servidor (consulta Habilitar y deshabilitar servidores)

Servidor remoto (Streamable HTTP)

Campo	Tipo	Requerido	Descripción
`url`	string	Sí	La URL del endpoint del servidor MCP
`transport`	string	No	`"http"` (Streamable HTTP, predeterminado para servidores con URL) o `"sse"` (SSE heredado). Cuando se establece como `"http"` o se omite, la CLI primero intenta usar Streamable HTTP y, si recibe errores 4xx, recurre a SSE (según la especificación). Establece `"sse"` explícitamente si el endpoint SSE del servidor está en una ruta distinta.
`headers`	object	No	Encabezados HTTP personalizados que se incluirán en las solicitudes
`oauthClientId`	string	No	ID de cliente OAuth prerregistrado, para servidores que no admiten el registro dinámico de clientes (DCR), p. ej., GitHub. Consulta la sección “Clientes OAuth prerregistrados” más abajo.
`oauthClientSecret`	string	No	Secreto de cliente OAuth, para clientes confidenciales. Úsalo junto con `oauthClientId`.
`oauthResource`	string	No	Anulación del parámetro `resource` de RFC 8707 enviado en las solicitudes OAuth (predeterminado: la URL del servidor MCP). Establécelo como una cadena vacía (`""`) para omitir el parámetro por completo, en proveedores que lo rechazan. Consulta anulación del recurso de OAuth.
`disabled`	boolean	No	Establécelo en `true` para omitir este servidor (consulta Habilitar y deshabilitar servidores)

Ejemplos

GitHub (stdio)

{
  "mcpServers": {
    "github": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-github"],
      "env": {
        "GITHUB_TOKEN": "ghp_..."
      }
    }
  }
}

Notion (HTTP con OAuth)

{
  "mcpServers": {
    "notion": {
      "url": "https://mcp.notion.com/mcp",
      "transport": "http"
    }
  }
}

Después de agregar un servidor con OAuth, ejecuta devin mcp login notion para autenticarte. Consulta Autenticación a continuación.

Linear (HTTP con OAuth)

{
  "mcpServers": {
    "linear": {
      "url": "https://mcp.linear.app/mcp",
      "transport": "http"
    }
  }
}

Atlassian / Jira (HTTP con OAuth)

{
  "mcpServers": {
    "atlassian": {
      "url": "https://mcp.atlassian.com/v1/mcp",
      "transport": "http"
    }
  }
}

Después de agregarlo, ejecuta devin mcp login atlassian para autenticarte. Cada cliente MCP (Windsurf, Claude Code, Devin CLI) mantiene su propia sesión de OAuth, así que debes iniciar sesión por separado aunque ya te hayas autenticado en otra herramienta.

Servidor personalizado (stdio)

{
  "mcpServers": {
    "my-tools": {
      "command": "python",
      "args": ["./scripts/mcp-server.py"],
      "env": {
        "DB_URL": "postgres://localhost/mydb"
      }
    }
  }
}

Autenticación

Algunos servidores MCP remotos requieren autenticación mediante OAuth. Después de agregar a tu configuración un servidor basado en OAuth, autentícate con el comando login:

devin mcp login <server-name>

Por ejemplo:

devin mcp login notion    # Autenticar con Notion
devin mcp login linear    # Autenticar con Linear

Se abre una ventana del navegador en la que puedes autorizar el acceso. Los tokens de OAuth se almacenan localmente y se actualizan automáticamente. Opcionalmente, puedes solicitar ámbitos específicos de OAuth:

devin mcp login notion --scopes read,write

Para eliminar las credenciales OAuth almacenadas para un servidor:

devin mcp logout <server-name>

Si el servidor admite OAuth, también se te pedirá que te autentiques automáticamente la primera vez que se use.

Clientes OAuth prerregistrados

La mayoría de los servidores MCP basados en OAuth admiten el registro dinámico de clientes (DCR), por lo que Devin CLI se registra automáticamente y no tienes que proporcionar ninguna credencial del cliente. Algunos proveedores (p. ej., GitHub) no admiten DCR y, en su lugar, requieren un cliente OAuth prerregistrado. En esos casos, proporciona el ID del cliente —y el secreto del cliente, si es un cliente confidencial— mediante oauthClientId / oauthClientSecret:

{
  "mcpServers": {
    "my-server": {
      "url": "https://mcp.example.com/mcp",
      "transport": "http",
      "oauthClientId": "Iv1.abc123def456",
      "oauthClientSecret": "${env:MY_MCP_CLIENT_SECRET}"
    }
  }
}

Cuando se establece oauthClientId, Devin CLI omite el registro dinámico de clientes y usa tu cliente prerregistrado durante el flujo de OAuth. Ejecuta devin mcp login <name> (o deja que se active en el primer uso) para autenticarte como de costumbre. También puedes configurarlos desde la línea de comandos al agregar un servidor o iniciar sesión en él:

devin mcp add my-server <URL> --oauth-client-id <ID> --oauth-client-secret <SECRET>
devin mcp login my-server --oauth-client-id <ID> --oauth-client-secret <SECRET>

oauthClientId / oauthClientSecret son credenciales de cliente de OAuth que se usan durante el flujo de autorización. No son credenciales genéricas por solicitud; si un servidor espera un token estático, usa headers (HTTP) o env (stdio) en su lugar.

No confirmes un client secret en una configuración compartida. Haz referencia a él desde una variable de entorno (${env:VAR}), léelo desde un archivo (${file:/path}) o colócalo en .devin/config.local.json (ignorado por git). Consulta la sección “Gestión de secretos” más abajo.

Anulación del recurso de OAuth

Durante la autorización de OAuth y el intercambio de tokens, Devin CLI envía el parámetro resource de RFC 8707 para que el servidor de autorización pueda emitir tokens restringidos por audiencia. De forma predeterminada, el valor es la URL del servidor MCP. Puedes anularlo con oauthResource:

{
  "mcpServers": {
    "my-server": {
      "url": "https://my-server.example.com/mcp",
      "transport": "http",
      "oauthResource": ""
    }
  }
}

El campo tiene tres comportamientos:

Sin establecer (predeterminado): envía resource con la URL del servidor MCP.
Valor no vacío: reemplaza el valor predeterminado por tu valor (p. ej., un URI de ID de aplicación específico).
Cadena vacía (""): omite por completo el parámetro resource tanto de la URL de autorización como del intercambio del token.

También puedes establecerlo desde la línea de comandos al agregar un servidor o iniciar sesión en él:

devin mcp add my-server <URL> --oauth-resource ""
devin mcp login my-server --oauth-resource ""

Al igual que otros campos de OAuth, oauthResource permite expandir ${env:VAR} y ${file:/path}.

Habilitar y deshabilitar servidores

Puede deshabilitar temporalmente un servidor MCP sin eliminar su configuración. Un servidor deshabilitado se omite durante el descubrimiento de herramientas: sus herramientas no aparecerán y no se iniciará el proceso del servidor.

devin mcp disable <name>    # Deshabilitar un servidor
devin mcp enable <name>     # Volver a habilitarlo

Esto establece el indicador "disabled": true en la entrada del servidor del archivo de configuración. Usa -s/--scope para seleccionar un ámbito específico:

devin mcp disable -s project my-server
devin mcp enable -s user my-server

También puedes establecer este indicador directamente en tu archivo de configuración:

{
  "mcpServers": {
    "my-server": {
      "command": "npx",
      "args": ["-y", "@company/mcp-server"],
      "disabled": true
    }
  }
}

Desactivarlo es útil cuando quieres conservar la configuración de un servidor (incluidas las variables de entorno y las credenciales OAuth) y dejar de usarlo temporalmente; por ejemplo, para reducir el tiempo de arranque o aislar un problema.

Gestión de secretos

Nunca hagas commit de claves de API ni secretos en el control de versiones. Usa .devin/config.local.json para los valores sensibles.

Para proyectos en equipo, el patrón recomendado es:

Define el servidor en .devin/config.json con variables de entorno de ejemplo o sin variables de entorno
Cada miembro del equipo agrega sus claves personales en .devin/config.local.json

El archivo de configuración local se excluye automáticamente de git.

Permisos de MCP

Puedes aprobar previamente, denegar o hacer que siempre se solicite confirmación para herramientas específicas de MCP en tu configuración de permisos:

{
  "permissions": {
    "allow": [
      "mcp__github__list_issues",
      "mcp__github__create_issue"
    ],
    "deny": [
      "mcp__github__delete_repo"
    ],
    "ask": [
      "mcp__linear__*"
    ]
  }
}

Patrones de coincidencia de permisos:

Patrón	Coincide con
`mcp__server__tool`	Una herramienta concreta en un servidor concreto
`mcp__server__*`	Todas las herramientas de un servidor concreto
`mcp__*`	Todas las herramientas MCP en todos los servidores

Restricciones de la organización

Si estás en un equipo Enterprise, tu Admin puede restringir a qué servidores MCP puedes conectarte. Un servidor que hayas configurado puede quedar bloqueado si MCP está deshabilitado para tu equipo o si no está en la lista de permitidos de tu equipo ni en un registro de MCP impuesto; en ese caso, no se conectará y sus herramientas no estarán disponibles. Consulta Team Settings — MCP Registry para obtener más información.

Solución de problemas

Autenticación obligatoria / errores de OAuth con servidores remotos

Si ves errores como Auth required o AuthRequired al conectarte a un servidor MCP remoto, significa que el servidor requiere autenticación OAuth.Ejecuta:

devin mcp login <server-name>

Cada cliente MCP se autentica de forma independiente. Aunque ya te hayas autenticado en Windsurf o Claude Code, debes ejecutar devin mcp login por separado para Devin CLI.Para comprobar tu estado de autenticación, prueba a eliminar y volver a agregar las credenciales:

devin mcp logout <server-name>
devin mcp login <server-name>

El servidor no se inicia

Verifica que el comando funcione fuera de Devin CLI:

npx -y @modelcontextprotocol/server-github

Comprueba que todas las variables de entorno necesarias estén configuradas.

Las herramientas no aparecen

Pídele al agente que liste los servidores MCP y las herramientas. Puede que el servidor necesite un momento para inicializarse.

Permiso denegado

Revisa tu configuración de permisos. De forma predeterminada, las herramientas MCP solicitan aprobación. Agrégalas a permissions.allow para aprobarlas automáticamente.

Errores de OAuth debido al parámetro resource

Algunos servidores de autorización rechazan solicitudes de OAuth que incluyen el parámetro resource de RFC 8707. Establece oauthResource como una cadena vacía para omitir el parámetro:

{
  "mcpServers": {
    "my-server": {
      "url": "https://my-server.example.com/mcp",
      "oauthResource": ""
    }
  }
}

Luego vuelve a autenticarte:

devin mcp logout my-server
devin mcp login my-server

Consulta anulación del recurso de OAuth para conocer el conjunto completo de comportamientos de oauthResource.

fallback heredado a SSE

Al conectarte a un servidor HTTP, Devin CLI intenta primero Streamable HTTP. Si el servidor responde con un error HTTP 4xx (p. ej., 404 o 405), cambia automáticamente a SSE heredado en la misma URL configurada. Esto sigue la guía de compatibilidad con versiones anteriores de la spec de MCP.El cambio automático solo se activa con respuestas 4xx: los errores de conexión, los tiempos de espera y las respuestas 5xx se informan directamente sin intentar SSE.Si el endpoint SSE de tu servidor está en una ruta distinta (p. ej., /sse en lugar de /mcp), establece "transport": "sse" con la URL de SSE para conectarte directamente sin intentar Streamable HTTP.Si ambos transportes fallan, el mensaje de error incluye detalles de ambos intentos para facilitar la solución de problemas.

​Agregar servidores MCP

​Desde la línea de comandos

​Mediante el archivo de configuración

​Opciones de configuración de servidores

​Comando local (stdio)

​Servidor remoto (Streamable HTTP)

​Ejemplos

​Autenticación

​Clientes OAuth prerregistrados

​Anulación del recurso de OAuth

​Habilitar y deshabilitar servidores

​Gestión de secretos

​Permisos de MCP

​Restricciones de la organización

​Solución de problemas

Agregar servidores MCP

Desde la línea de comandos

Mediante el archivo de configuración

Opciones de configuración de servidores

Comando local (stdio)

Servidor remoto (Streamable HTTP)

Ejemplos

Autenticación

Clientes OAuth prerregistrados

Anulación del recurso de OAuth

Habilitar y deshabilitar servidores

Gestión de secretos

Permisos de MCP

Restricciones de la organización

Solución de problemas