Saltar al contenido principal

Documentation Index

Fetch the complete documentation index at: https://docs.devin.ai/llms.txt

Use this file to discover all available pages before exploring further.

MCP (Model Context Protocol) es un protocolo que permite a los LLM acceder a herramientas y servicios personalizados. Un cliente MCP (Cascade, en este caso) puede enviar solicitudes a servidores MCP para acceder a las herramientas que proporcionan. Cascade ahora se integra de forma nativa con MCP, lo que te permite usar tus propios servidores MCP con Cascade. Consulta la documentación oficial de MCP para obtener más información.
Los usuarios de Enterprise deben activar esto manualmente desde Settings

​
Agregar un nuevo MCP

Se pueden agregar nuevos MCP desde MCP Marketplace, al que accedes haciendo clic en el icono MCPs del menú superior derecho del panel Cascade, o desde la sección Windsurf Settings > Cascade > MCP Servers. Si no encuentras el MCP que buscas, puedes agregarlo manualmente editando directamente el archivo mcp_config.json. Los MCP oficiales aparecerán con una marca de verificación azul, lo que indica que fueron creados por la empresa responsable del servicio principal. Cuando hagas clic en un MCP, simplemente haz clic en Install para poner el servidor y sus herramientas a disposición de Cascade. Devin Desktop admite la instalación de MCP con un clic mediante deeplinks. Puedes usar estos enlaces para abrir directamente en Devin Desktop la página del registro de MCP, lo que resulta útil para compartir recomendaciones de servidores MCP o incluir botones de instalación en la documentación. El formato del deeplink es: 
windsurf://windsurf-mcp-registry?serverName=<server-name>
  • Con serverName: Abre la página del registro de MCP del servidor especificado, donde el usuario puede consultarlo e instalarlo.
  • Sin serverName: Abre la página de MCP Marketplace.
Por ejemplo, windsurf://windsurf-mcp-registry?serverName=github-mcp-server abrirá la página del registro del servidor MCP de GitHub en Devin Desktop.
Los enlaces directos de instalación con un clic requieren que el equipo del usuario tenga habilitado el acceso a MCP. Si un Admin deshabilita el acceso a MCP, el enlace directo no abrirá la página del registro.
Devin Desktop admite tres tipos de transporte para servidores MCP: stdio, Streamable HTTP y SSE. Devin Desktop también admite OAuth para cada tipo de transporte. Para los servidores http, la URL debe corresponder a la del endpoint y tener un formato similar a https://<your-server-url>/mcp.

​
Configurar herramientas MCP

Cada MCP tiene acceso a una cantidad determinada de herramientas. Cascade tiene un límite de 100 herramientas en total a las que puede acceder en un momento dado. En la página de Settings de cada MCP, puedes activar o desactivar las herramientas que quieras habilitar. Para abrir la configuración de un MCP, haz clic en el icono MCPs del menú superior derecho del panel de Cascade y haz clic en el MCP que desees.

​
mcp_config.json

El archivo ~/.codeium/windsurf/mcp_config.json es un archivo JSON que contiene una lista de servidores a los que Cascade puede conectarse. A continuación se muestra una configuración de ejemplo que configura un único servidor para GitHub: 
{
  "mcpServers": {
    "github": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-github"
      ],
      "env": {
        "GITHUB_PERSONAL_ACCESS_TOKEN": "<YOUR_PERSONAL_ACCESS_TOKEN>"
      }
    }
  }
}
Asegúrate de proporcionar los argumentos requeridos y las variables de entorno para los servidores que quieras usar. Consulta el repositorio oficial de referencia de servidores MCP o OpenTools para ver algunos servidores de ejemplo. A continuación se muestran ejemplos de configuración de algunos servidores MCP de uso frecuente. Se pueden agregar a tu archivo mcp_config.json.
El servidor MCP de GitHub proporciona herramientas para la gestión de repositorios, operaciones con archivos, seguimiento de issues y gestión de pull requests.Con npx:
{
  "mcpServers": {
    "github": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-github"],
      "env": {
        "GITHUB_PERSONAL_ACCESS_TOKEN": "<YOUR_PERSONAL_ACCESS_TOKEN>"
      }
    }
  }
}
Con Docker:
{
  "mcpServers": {
    "github": {
      "command": "docker",
      "args": [
        "run", "-i", "--rm",
        "-e", "GITHUB_PERSONAL_ACCESS_TOKEN",
        "ghcr.io/github/github-mcp-server"
      ],
      "env": {
        "GITHUB_PERSONAL_ACCESS_TOKEN": "<YOUR_PERSONAL_ACCESS_TOKEN>"
      }
    }
  }
}
Para crear un Personal Access Token, visita GitHub Settings > Developer settings > Personal access tokens.
El servidor MCP de Slack permite gestionar canales, enviar mensajes e interactuar con el espacio de trabajo.
{
  "mcpServers": {
    "slack": {
      "command": "npx",
      "args": ["-y", "@anthropic/mcp-server-slack"],
      "env": {
        "SLACK_BOT_TOKEN": "<YOUR_SLACK_BOT_TOKEN>",
        "SLACK_TEAM_ID": "<YOUR_SLACK_TEAM_ID>"
      }
    }
  }
}
Para configurar un token de bot de Slack:
  1. Crea una Slack App en api.slack.com/apps
  2. Agrega los permisos de OAuth requeridos (p. ej., channels:read, chat:write, users:read)
  3. Instala la app en tu espacio de trabajo y copia el Bot User OAuth Token
El servidor MCP de PostgreSQL proporciona acceso de solo lectura a bases de datos PostgreSQL, incluida la inspección de esquemas y la ejecución de consultas.
{
  "mcpServers": {
    "postgres": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-postgres"],
      "env": {
        "POSTGRES_CONNECTION_STRING": "postgresql://user:password@localhost:5432/database"
      }
    }
  }
}
El servidor de PostgreSQL proporciona acceso de solo lectura de forma predeterminada por seguridad. Asegúrate de que tu cadena de conexión use credenciales adecuadas con permisos limitados.
El servidor MCP de Filesystem proporciona acceso seguro a archivos y directorios locales con controles de acceso configurables.
{
  "mcpServers": {
    "filesystem": {
      "command": "npx",
      "args": [
        "-y", "@modelcontextprotocol/server-filesystem",
        "/path/to/allowed/directory"
      ]
    }
  }
}
Puedes especificar varios directorios permitidos agregando argumentos de ruta adicionales. Solo se podrá acceder a los archivos dentro de estos directorios.
El servidor MCP de Memory proporciona un sistema de memoria persistente que usa un grafo de conocimiento, lo que permite a Cascade recordar información entre sesiones.
{
  "mcpServers": {
    "memory": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-memory"]
    }
  }
}
El servidor de memoria almacena datos localmente y persiste entre sesiones, por lo que resulta útil para mantener el contexto sobre proyectos, preferencias e información aprendida.

​
MCP HTTP remotos

Es importante tener en cuenta que, en el caso de los MCP HTTP remotos, la configuración es ligeramente distinta y requiere un campo serverUrl o url. A continuación, se muestra un ejemplo de configuración para un servidor HTTP: 
{
  "mcpServers": {
    "remote-http-mcp": {
      "serverUrl": "<your-server-url>/mcp",
      "headers": {
        "API_KEY": "value"
      }
    }
  }
}

​
Interpolación de la configuración

El archivo ~/.codeium/windsurf/mcp_config.json admite la interpolación de variables en los siguientes campos: command, args, env, serverUrl, url y headers. Esto te permite evitar incluir secretos directamente en el archivo de configuración. Se admiten dos patrones de interpolación:
  • ${env:VAR_NAME} — se sustituye por el valor de la variable de entorno VAR_NAME. Si la variable no está definida, se resuelve como una cadena vacía.
  • ${file:/path/to/file} — se sustituye por el contenido del archivo en la ruta indicada, sin espacios en blanco al principio ni al final. Se admiten rutas con tilde (p. ej., ~/secrets/key.txt). Si no se puede leer el archivo, el patrón se deja sin cambios.
Aquí tienes un ejemplo de cómo usar una variable de entorno en headers: 
{
  "mcpServers": {
    "remote-http-mcp": {
      "serverUrl": "<your-server-url>/mcp",
      "headers": {
        "API_KEY": "Bearer ${env:AUTH_TOKEN}"
      }
    }
  }
}
A continuación se muestra un ejemplo de cómo leer una API key de un archivo: 
{
  "mcpServers": {
    "my-server": {
      "command": "node",
      "args": ["server.js"],
      "env": {
        "API_KEY": "${file:~/.secrets/api_key.txt}"
      }
    }
  }
}

​
Controles de Admin (Equipos y empresas)

Los Admin del equipo pueden activar o desactivar el acceso a MCP para su equipo, así como definir una lista de permitidos de servidores MCP aprobados que el equipo puede usar:

​
Registro de MCP

Los equipos Enterprise pueden configurar registros de MCP personalizados para reemplazar el MCP Marketplace predeterminado de Devin Desktop. Los equipos pueden vincular las URL de sus propios registros para controlar qué MCP están disponibles para sus usuarios.
Los registros son la opción preferida para gestionar el acceso a los MCP, aunque las listas de permitidos también funcionan.

​
Configurar registros personalizados

  1. Ve a la configuración de tu equipo
  2. Busca la opción MCP Registry URLs
  3. Agrega una o más URL de registro
Cuando se configuran múltiples URL de registro, Devin Desktop usa la unión de todos los registros: los usuarios verán los MCP de todas las fuentes configuradas en conjunto. El MCP Marketplace del equipo consultará estos registros internos en lugar del registro predeterminado de Devin Desktop.
Los registros personalizados deben seguir el esquema oficial de registro de MCP. Esto garantiza la compatibilidad y definiciones de servidor estandarizadas.

​
Lista de permitidos de MCP

MCP Team Settings

Configuración de MCP para tu equipo.
El enlace anterior solo funcionará si tienes privilegios de Admin para tu equipo.
De forma predeterminada, los usuarios de un equipo podrán configurar sus propios servidores MCP. Sin embargo, en cuanto incluyas хотя sea un solo servidor MCP en la lista de permitidos, todos los servidores que no estén en la lista de permitidos quedarán bloqueados para tu equipo.
El ID del servidor en la lista de permitidos debe coincidir exactamente, respetando mayúsculas y minúsculas, con el nombre de la clave usado en el mcp_config.json del usuario.

​
Cómo funciona la coincidencia de servidores

Cuando agregas un servidor MCP a la lista de permitidos, el sistema usa coincidencia mediante patrones regex con las siguientes reglas:
  • Coincidencia de cadena completa: Todos los patrones se anclan automáticamente (se envuelven en ^(?:pattern)$) para evitar coincidencias parciales
  • Campo de comando: Debe coincidir exactamente o según tu patrón regex
  • Array de argumentos: Cada argumento se compara individualmente con su patrón correspondiente
  • Longitud del array: La cantidad de argumentos debe coincidir exactamente entre la lista de permitidos y la configuración del usuario
  • Caracteres especiales: Caracteres como $, ., [, ], (, ) tienen un significado especial en regex y deben escaparse con \ si quieres una coincidencia literal

​
Opciones de configuración

Configuración de la lista de permitidos del Admin:
  • ID del servidor: github-mcp-server
  • Server Config (JSON): (dejar vacío)
{}
Configuración de usuario correspondiente (mcp_config.json):
{
  "mcpServers": {
    "github-mcp-server": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "GITHUB_PERSONAL_ACCESS_TOKEN",
        "ghcr.io/github/github-mcp-server"
      ],
      "env": {
        "GITHUB_PERSONAL_ACCESS_TOKEN": "ghp_your_token_here"
      }
    }
  }
}
Esto permite a los usuarios instalar el servidor MCP de GitHub con cualquier configuración válida, siempre que el ID del servidor coincida con la entrada del Plugin Store.
Configuración de la lista de permitidos del Admin:
  • ID del servidor: github-mcp-server
  • Server Config (JSON):
{
  "command": "docker",
  "args": [
    "run",
    "-i",
    "--rm",
    "-e",
    "GITHUB_PERSONAL_ACCESS_TOKEN",
    "ghcr.io/github/github-mcp-server"
  ],
  "env": {
    "GITHUB_PERSONAL_ACCESS_TOKEN": ""
  }
}
Configuración de usuario correspondiente (mcp_config.json):
{
  "mcpServers": {
    "github-mcp-server": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "GITHUB_PERSONAL_ACCESS_TOKEN",
        "ghcr.io/github/github-mcp-server"
      ],
      "env": {
        "GITHUB_PERSONAL_ACCESS_TOKEN": "ghp_your_token_here"
      }
    }
  }
}
Los usuarios deben usar esta configuración exacta; cualquier variación en command o args se bloqueará. La sección env puede tener valores diferentes.
Configuración de la lista de permitidos del Admin:
  • ID del servidor: python-mcp-server
  • Server Config (JSON):
{
  "command": "python3",
  "args": ["/.*\\.py", "--port", "[0-9]+"]
}
Configuración de usuario correspondiente (mcp_config.json):
{
  "mcpServers": {
    "python-mcp-server": {
      "command": "python3",
      "args": ["/home/user/my_server.py", "--port", "8080"],
      "env": {
        "PYTHONPATH": "/home/user/mcp"
      }
    }
  }
}
Este ejemplo ofrece flexibilidad a los usuarios sin dejar de mantener la seguridad:
  • La regex /.*\\.py coincide con cualquier ruta de archivo Python, como /home/user/my_server.py
  • La regex [0-9]+ coincide con cualquier puerto numérico, como 8080 o 3000
  • Los usuarios pueden personalizar las rutas de archivo y los puertos, mientras los Admin se aseguran de que solo se ejecuten scripts de Python

​
Patrones comunes de regex

PatrónCoincide conEjemplo
.*Cualquier cadena/home/user/script.py
[0-9]+Cualquier número8080, 3000
[a-zA-Z0-9_]+Alfanumérico + guion bajoapi_key_123
\\$HOME$HOME literal$HOME (sin expandir)
\\.py.py literalscript.py
\\[cli\\][cli] literalmcp[cli]

​
Notas

​
Pautas de configuración de Admin

  • Variables de entorno: La sección env no se evalúa mediante regex y los usuarios pueden configurarla libremente
  • Herramientas deshabilitadas: El arreglo disabledTools se gestiona por separado y no forma parte de la coincidencia con la lista de permitidos
  • Distinción entre mayúsculas y minúsculas: Todas las coincidencias distinguen entre mayúsculas y minúsculas
  • Manejo de errores: Los patrones de regex no válidos se registrarán y darán lugar a una denegación de acceso
  • Pruebas: Prueba tus patrones de regex con cuidado; los patrones demasiado restrictivos pueden bloquear casos de uso legítimos

​
Solución de problemas

Si los usuarios informan que sus servidores MCP no funcionan después de configurar la lista de permitidos:
  1. Comprueba la coincidencia exacta: Asegúrate de que el patrón de la lista de permitidos coincida exactamente con la configuración del usuario
  2. Verifica el escape de regex: Puede que sea necesario escapar los caracteres especiales (p. ej., \. para puntos literales)
  3. Revisa los logs: Los patrones de regex no válidos se registran con advertencias
  4. Prueba los patrones: Usa un comprobador de regex para verificar que tus patrones funcionen como se espera
Recuerda: Una vez que incluyas cualquier servidor en la lista de permitidos, todos los demás servidores quedarán bloqueados automáticamente para los miembros de tu equipo.

​
Información general

  • Dado que las llamadas a herramientas de MCP pueden invocar código escrito por implementadores de servidores de terceros, no asumimos responsabilidad por fallos en las llamadas a herramientas de MCP. Para reiterarlo:
  • Actualmente admitimos las herramientas, los recursos y los prompts de un servidor MCP.