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              # Listar todos los servidores configurados
devin mcp get <name>        # Mostrar detalles de un servidor específico
devin mcp remove <name>     # Eliminar un servidor configurado
devin mcp login <name>      # Autenticarse con un servidor mediante OAuth
devin mcp logout <name>     # Eliminar las credenciales OAuth almacenadas

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

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

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.

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

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.

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.

Documentation Index

​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

​Gestión de secretos

​Permisos de MCP

​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

Gestión de secretos

Permisos de MCP

Solución de problemas