MCP (Model Context Protocol) é um protocolo que permite que LLMs acessem ferramentas e serviços personalizados. Um cliente MCP (o Cascade, neste caso) pode fazer solicitações a servidores MCP para acessar as ferramentas que eles fornecem. O Cascade agora integra nativamente com o MCP, permitindo que você conecte sua própria seleção de servidores MCP para o Cascade usar. Consulte a documentação oficial do MCP para mais informações.
Usuários do plano Enterprise devem ativar isso manualmente nas configurações

​
Adicionando um novo plugin MCP

Novos plugins MCP podem ser adicionados acessando Settings > Tools > Windsurf Settings > Add Server. Se você não encontrar o plugin MCP desejado, pode adicioná-lo manualmente clicando no botão View Raw Config e editando o arquivo mcp_config.json diretamente. Ao clicar em um servidor MCP, basta selecionar + Add Server para disponibilizar o servidor e suas ferramentas no Cascade.
O Cascade oferece suporte a dois tipos de transporte para servidores MCP: stdio e http. Para servidores http, a URL deve corresponder ao endpoint e ter o formato https://<your-server-url>/mcp. Também oferecemos suporte a transporte HTTP com streaming e Autenticação MCP.
Certifique-se de clicar no botão de atualizar depois de adicionar um novo plugin MCP.

​
mcp_config.json

O arquivo ~/.codeium/mcp_config.json é um arquivo JSON que lista os servidores aos quais o Cascade pode se conectar. O JSON deve seguir o mesmo esquema do arquivo de configuração do Claude Desktop. Veja um exemplo de configuração que define um único servidor para o GitHub: 
{
  "mcpServers": {
    "github": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-github"
      ],
      "env": {
        "GITHUB_PERSONAL_ACCESS_TOKEN": "<SEU_TOKEN_DE_ACESSO_PESSOAL>"
      }
    }
  }
}
É importante observar que, para servidores HTTP, a configuração é um pouco diferente e requer o campo serverUrl. Veja um exemplo de configuração para um servidor HTTP: 
{
  "mcpServers": {
    "figma": {
      "serverUrl": "<url-do-seu-servidor>/mcp"
    }
  }
}
Para o servidor MCP do Figma Dev Mode, certifique-se de atualizar o app Figma para desktop para a versão mais recente a fim de usar o novo endpoint /mcp.
Certifique-se de fornecer os argumentos necessários e as variáveis de ambiente para os servidores que deseja usar. Consulte o repositório oficial de referência de servidores MCP ou o OpenTools para exemplos de servidores.

​
Controles de administração (Teams & Enterprise)

Os administradores de equipe podem ativar ou desativar o acesso ao MCP para sua equipe e também permitir (whitelist) servidores MCP aprovados para uso pela equipe:

Configurações de MCP da equipe

Configurações de MCP personalizáveis para sua equipe.
O link acima só funcionará se você tiver privilégios de administrador da sua equipe.
Por padrão, os usuários de uma equipe podem configurar seus próprios servidores MCP. No entanto, assim que você permitir ao menos um servidor MCP, todos os servidores não permitidos (fora da lista) serão bloqueados para a sua equipe.

​
Como funciona o Server Matching

Quando você coloca um servidor MCP na lista de permissões (allowlist), o sistema usa correspondência por padrão regex com as seguintes regras:
  • Correspondência de string completa: Todos os padrões são automaticamente ancorados (envolvidos com ^(?:pattern)$) para evitar correspondências parciais
  • Campo Command: Deve corresponder exatamente ou de acordo com o seu padrão de regex
  • Array de argumentos: Cada argumento é verificado individualmente em relação ao seu padrão correspondente
  • Comprimento do array: O número de argumentos deve corresponder exatamente entre a lista de permissões e a configuração do usuário
  • Caracteres especiais: Caracteres como $, ., [, ], (, ) têm significado especial em regex e devem ser escapados com \ se você quiser correspondência literal

​
Opções de configuração

Configuração de lista de permissões do admin:
  • Server ID: github-mcp-server
  • Server Config (JSON): (deixe vazio)
{}
Configuração correspondente do usuário (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"
      }
    }
  }
}
Isso permite que os usuários instalem o servidor MCP do GitHub com qualquer configuração válida, desde que o Server ID corresponda à entrada da Plugin Store.
Configuração de lista de permissões do admin:
  • 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": ""
  }
}
Configuração correspondente do usuário (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"
      }
    }
  }
}
Os usuários devem usar exatamente esta configuração — qualquer desvio em command ou args será bloqueado. A seção env pode ter valores diferentes.
Configuração de lista de permissões do admin:
  • Server ID: python-mcp-server
  • Server Config (JSON):
{
  "command": "python3",
  "args": ["/.*\\.py", "--port", "[0-9]+"]
}
Configuração correspondente do usuário (mcp_config.json):
{
  "mcpServers": {
    "python-mcp-server": {
      "command": "python3",
      "args": ["/home/user/my_server.py", "--port", "8080"],
      "env": {
        "PYTHONPATH": "/home/user/mcp"
      }
    }
  }
}
Este exemplo oferece flexibilidade aos usuários mantendo a segurança:
  • O regex /.*\\.py corresponde a qualquer caminho de arquivo Python, como /home/user/my_server.py
  • O regex [0-9]+ corresponde a qualquer porta numérica, como 8080 ou 3000
  • Os usuários podem personalizar caminhos de arquivos e portas, enquanto os administradores garantem que apenas scripts Python sejam executados

​
Padrões comuns de regex

PadrãoCorresponde aExemplo
.*Qualquer string/home/user/script.py
[0-9]+Qualquer número8080, 3000
[a-zA-Z0-9_]+Alfanumérico + sublinhadoapi_key_123
\\$HOMELiteral $HOME$HOME (não expandido)
\\.pyLiteral .pyscript.py
\\[cli\\]Literal [cli]mcp[cli]

​
Notas

​
Diretrizes de Configuração de Administração

  • Variáveis de ambiente: A seção env não usa correspondência por regex e pode ser configurada livremente pelos usuários
  • Ferramentas desativadas: O array disabledTools é tratado separadamente e não faz parte da correspondência por lista de permissão (whitelist)
  • Diferença entre maiúsculas e minúsculas: Toda a correspondência diferencia maiúsculas de minúsculas
  • Tratamento de erros: Padrões de regex inválidos serão registrados e resultarão em negação de acesso
  • Testes: Teste seus padrões de regex com cuidado — padrões excessivamente restritivos podem bloquear casos de uso legítimos

​
Solução de problemas

Se os usuários relatarem que seus servidores MCP não estão funcionando após a inclusão na lista de permissões:
  1. Verifique a correspondência exata: Certifique-se de que o padrão da lista de permissões corresponda exatamente à configuração do usuário
  2. Verifique a escape de regex: Caracteres especiais podem precisar ser escapados (por exemplo, \. para pontos literais)
  3. Revise os logs: Padrões de regex inválidos são registrados com avisos
  4. Teste os padrões: Use um validador/testador de regex para verificar se seus padrões funcionam como esperado
Lembre-se: Depois que você incluir qualquer servidor na lista de permissões, todos os outros servidores serão bloqueados automaticamente para os membros da sua equipe.

​
Informações gerais

  • Como as chamadas de ferramentas MCP podem invocar código escrito por implementadores de servidor arbitrários, não assumimos responsabilidade por falhas nessas chamadas. Reiterando:
  • Atualmente oferecemos suporte às ferramentas e recursos de um servidor MCP, não a prompts.