MCP (Model Context Protocol) é um protocolo que permite que LLMs acessem ferramentas e serviços personalizados. Um cliente MCP (neste caso, o Cascade) pode fazer requisições a servidores MCP para acessar as ferramentas que eles disponibilizam. O Cascade agora se integra nativamente ao MCP, permitindo que você use seus próprios servidores MCP no Cascade. Consulte a documentação oficial do MCP para mais informações.Documentation Index
Fetch the complete documentation index at: https://docs.devinenterprise.com/llms.txt
Use this file to discover all available pages before exploring further.
Adicionando um novo plugin MCP
Configurações > Tools > Windsurf Settings > Add Server.
Se você não encontrar o plugin MCP desejado, poderá adicioná-lo manualmente clicando no botão View Raw Config e editando o arquivo mcp_config.json bruto.
Ao selecionar um servidor MCP, basta clicar em + Add Server para expor o servidor e suas ferramentas para o Cascade.

stdio, Streamable HTTP e SSE.
O Cascade também oferece suporte a OAuth para cada tipo de transporte.
Para servidores http, a URL deve corresponder à do endpoint e ter um formato como https://<your-server-url>/mcp.
mcp_config.json
~/.codeium/mcp_config.json é um arquivo JSON com uma lista de servidores aos quais o Cascade pode se conectar.
Veja um exemplo de configuração que define um único servidor para o GitHub:
MCPs HTTP remotos
serverUrl ou url.
Veja um exemplo de configuração para um servidor HTTP:
Interpolação na configuração
~/.codeium/mcp_config.json permite a interpolação de
variáveis de ambiente nestes campos: command, args, env, serverUrl, url e
headers.
Aqui está um exemplo de configuração que usa a variável de ambiente AUTH_TOKEN
em headers.
Controles administrativos (Teams & Enterprises)
Configurações de MCP da equipe
Como funciona a correspondência de servidor
- Correspondência da string completa: todos os padrões são automaticamente ancorados (envolvidos por
^(?:pattern)$) para evitar correspondências parciais - Campo de comando: deve corresponder exatamente ou seguir o seu padrão regex
- Array de argumentos: cada argumento é comparado individualmente com 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 uma correspondência literal
Opções de configuração
Opção 1: Padrão da Plugin Store (recomendado)
Deixe o campo Server Config (JSON) vazio para permitir a configuração padrão da Windsurf MCP Plugin Store.
Opção 1: Padrão da Plugin Store (recomendado)
Deixe o campo Server Config (JSON) vazio para permitir a configuração padrão da Windsurf MCP Plugin Store.
- Server ID:
github-mcp-server - Server Config (JSON): (deixe em branco)
mcp_config.json):Opção 2: Configuração com correspondência exata
Forneça a configuração exata que os usuários devem usar. Eles devem corresponder exatamente a essa configuração.
Opção 2: Configuração com correspondência exata
Forneça a configuração exata que os usuários devem usar. Eles devem corresponder exatamente a essa configuração.
- Server ID:
github-mcp-server - Server Config (JSON):
mcp_config.json):command ou args será bloqueado. A seção env pode ter valores diferentes.Opção 3: Padrões regex flexíveis
Use padrões regex para permitir variações nas configurações dos usuários, mantendo os controles de segurança.
Opção 3: Padrões regex flexíveis
Use padrões regex para permitir variações nas configurações dos usuários, mantendo os controles de segurança.
- Server ID:
python-mcp-server - Server Config (JSON):
mcp_config.json):- A regex
/.*\\.pycorresponde a qualquer caminho de arquivo Python, como/home/user/my_server.py - A regex
[0-9]+corresponde a qualquer porta numérica, como8080ou3000 - 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ão | Corresponde a | Exemplo |
|---|---|---|
.* | Qualquer sequência de caracteres | /home/user/script.py |
[0-9]+ | Qualquer número | 8080, 3000 |
[a-zA-Z0-9_]+ | Alfanumérico + underscore | api_key_123 |
\\$HOME | $HOME literal | $HOME (não expandido) |
\\.py | .py literal | script.py |
\\[cli\\] | [cli] literal | mcp[cli] |
Notas
Diretrizes de configuração do administrador
- Variáveis de ambiente: a seção
envnã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 da lista de permissões - Diferenciação entre maiúsculas e minúsculas: toda correspondência diferencia maiúsculas de minúsculas
- Tratamento de erros: padrões de regex inválidos serão registrados em log 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
- Verifique a correspondência exata: Certifique-se de que o padrão da lista de permissões corresponda exatamente à configuração do usuário
- Verifique o escape de regex: Caracteres especiais podem precisar ser escapados (por exemplo,
\.para pontos literais) - Revise os logs: Padrões de regex inválidos são registrados com avisos
- Teste os padrões: Use um testador de regex para confirmar que seus padrões funcionam como esperado
Informações gerais
- Como as chamadas de ferramentas do MCP podem invocar código escrito por implementadores de servidor diversos, não nos responsabilizamos por falhas nessas chamadas de ferramentas do MCP. Reforçando:
- No momento, oferecemos suporte às ferramentas, aos recursos e aos prompts de um servidor MCP.
