Saltar al contenido principal
MCP (Model Context Protocol) es un protocolo que permite a los modelos de IA acceder a herramientas y servicios personalizados. Un cliente MCP (Cascade, en este caso) puede realizar solicitudes a servidores MCP para acceder a las herramientas que estos proporcionan. Cascade ahora se integra de forma nativa con MCP, lo que te permite usar tu propia selección de servidores MCP con Cascade. Consulta la documentación oficial de MCP para obtener más información.
Los usuarios de Enterprise deben activarlo manualmente en la configuración

​
Agregar un nuevo plugin MCP

Puedes agregar nuevos plugins MCP desde Settings > Tools > Windsurf Settings > Add Server. Si no encuentras el plugin MCP que buscas, puedes añadirlo manualmente haciendo clic en el botón View Raw Config y editando directamente el archivo mcp_config.json. Al seleccionar un servidor MCP, simplemente haz clic en + Add Server para poner el servidor y sus herramientas a disposición de Cascade.
Cascade admite dos tipos de transporte para servidores MCP: stdio y http. Para servidores http, la URL debe corresponder al endpoint y tener el formato https://<your-server-url>/mcp. También admitimos transporte HTTP con streaming y autenticación MCP.
Asegúrate de pulsar el botón de actualizar después de agregar un nuevo plugin MCP.

​
mcp_config.json

El archivo ~/.codeium/mcp_config.json es un archivo JSON que contiene una lista de servidores a los que Cascade puede conectarse. El JSON debe seguir el mismo esquema que el archivo de configuración de Claude Desktop. A continuación, se muestra un ejemplo de configuración que define un único servidor para GitHub: 
{
  "mcpServers": {
    "github": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-github"
      ],
      "env": {
        "GITHUB_PERSONAL_ACCESS_TOKEN": "<TU_TOKEN_DE_ACCESO_PERSONAL>"
      }
    }
  }
}
Es importante tener en cuenta que, para los servidores HTTP, la configuración es ligeramente diferente y requiere un campo serverUrl. A continuación se muestra un ejemplo de configuración para un servidor HTTP: 
{
  "mcpServers": {
    "figma": {
      "serverUrl": "<url-de-tu-servidor>/mcp"
    }
  }
}
Para el servidor MCP de Figma Dev Mode, asegúrate de haber actualizado a la versión más reciente de la aplicación de escritorio de Figma para poder usar el nuevo endpoint /mcp.
Asegúrate de proporcionar los argumentos y las variables de entorno necesarios para los servidores que quieras usar. Consulta el repositorio oficial de referencia de servidores MCP o OpenTools para ver algunos servidores de ejemplo.

​
Controles de administración (Teams y Enterprise)

Los administradores de equipo pueden activar o desactivar el acceso a MCP para su equipo y, además, añadir a una lista de permitidos los servidores MCP aprobados que podrá usar el equipo:

MCP Team Settings

Ajustes de MCP configurables para tu equipo.
El enlace anterior solo funcionará si tienes privilegios de administrador en tu equipo.
De forma predeterminada, los usuarios de un equipo pueden configurar sus propios servidores MCP. Sin embargo, en cuanto añadas aunque sea un solo servidor MCP a la lista de permitidos, todos los servidores no incluidos en la lista quedarán bloqueados para tu equipo.

​
Cómo funciona la coincidencia de servidores

Cuando autorizas (whitelist) un servidor MCP, el sistema usa coincidencia de patrones con expresiones regulares (regex) con las siguientes reglas:
  • Coincidencia de cadena completa: Todos los patrones se anclan automáticamente (se envuelven con ^(?:pattern)$) para evitar coincidencias parciales
  • Campo Command: Debe coincidir exactamente o conforme a tu patrón de regex
  • Matriz de argumentos: Cada argumento se compara individualmente con su patrón correspondiente
  • Longitud de la matriz: La cantidad de argumentos debe coincidir exactamente entre la lista permitida 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 administrador:
  • Server ID: 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 administrador:
  • Server ID: 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 desviación en command o args será bloqueada. La sección env puede tener valores distintos.
Configuración de la lista de permitidos del administrador:
  • Server ID: 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 a la vez que mantiene la seguridad:
  • El regex /.*\\.py coincide con cualquier ruta de archivo de Python, como /home/user/my_server.py
  • El regex [0-9]+ coincide con cualquier puerto numérico, como 8080 o 3000
  • Los usuarios pueden personalizar rutas de archivos y puertos mientras los administradores garantizan 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
\\$HOMELiteral $HOME$HOME (sin expandir)
\\.pyLiteral .pyscript.py
\\[cli\\]Literal [cli]mcp[cli]

​
Notas

​
Directrices de configuración para administradores

  • Variables de entorno: La sección env no se evalúa con expresiones regulares y los usuarios pueden configurarla libremente
  • Herramientas deshabilitadas: El array disabledTools se gestiona por separado y no forma parte de la coincidencia con la lista de permitidos
  • Sensibilidad a 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 la denegación de acceso
  • Pruebas: Prueba tus patrones de regex cuidadosamente; 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 incluirlos en la lista permitida:
  1. Comprobar coincidencia exacta: Asegúrate de que el patrón de la lista permitida coincida exactamente con la configuración del usuario
  2. Verificar el escape en regex: Es posible que sea necesario escapar caracteres especiales (p. ej., \. para puntos literales)
  3. Revisar logs: Los patrones regex inválidos se registran con advertencias
  4. Probar patrones: Usa un probador de regex para verificar que tus patrones funcionen como se espera
Recuerda: Una vez que incluyas cualquier servidor en la lista permitida, todos los demás servidores se bloquean 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 arbitrarios, no asumimos responsabilidad por fallos en dichas llamadas a herramientas de MCP. Para reiterar:
  • Actualmente admitimos las tools y resources de un servidor MCP, no las prompts.