Integração MCP do Cascade

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.

Usuários Enterprise devem ativar isso manualmente nas Configurações

Adicionando um novo plugin MCP

Novos plugins MCP podem ser adicionados acessando a seção Configurações > Tools > Windsurf Settings > Add Server. Para configurar um servidor MCP manualmente, use Open MCP config file no menu MCP do Cascade e edite o arquivo mcp_config.json bruto que ele abre. Ao selecionar um servidor MCP, basta clicar em + Add Server para expor o servidor e suas ferramentas para o Cascade.

O Cascade oferece suporte a três tipos de transporte para servidores MCP: 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.

Não se esqueça de clicar no botão de atualização após adicionar um novo plugin MCP.

mcp_config.json

O arquivo mcp_config.json contém uma lista de servidores aos quais o Cascade pode se conectar. A ação Open MCP config file do Cascade abre o arquivo gerenciado pelo Cortex no diretório de configuração do Devin:

macOS e Linux: ~/.config/devin/mcp_config.json, ou $XDG_CONFIG_HOME/devin/mcp_config.json quando XDG_CONFIG_HOME estiver definido.
Windows: %AppData%/devin/mcp_config.json por padrão.

Use o arquivo aberto pela ação para a sua instalação, incluindo builds com um diretório de configuração isolado.

A descoberta de MCP do editor usa um arquivo separado e específico de cada build: ~/.codeium/windsurf/mcp_config.json para a versão estável ou ~/.codeium/windsurf-next/mcp_config.json para a Next. Nas Configurações do editor, pesquise por chat.mcp.discovery.enabled e ative a origem windsurf, identificada como Devin configurations, para descobrir servidores a partir desse arquivo.Para abrir o arquivo de um servidor descoberto, execute MCP: List Servers na Paleta de comandos, selecione o servidor e escolha Show Configuration. Essa configuração de descoberta não altera o arquivo gerenciado pelo Cortex que é aberto pela ação Open MCP config file do Cascade.

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": "<YOUR_PERSONAL_ACCESS_TOKEN>"
      }
    }
  }
}

Certifique-se de fornecer os argumentos obrigatórios e as variáveis de ambiente necessários para os servidores que você quer usar. Consulte o repositório de referência oficial de servidores MCP ou o OpenTools para ver alguns exemplos de servidores.

MCPs HTTP remotos

É importante observar que, para MCPs HTTP remotos, a configuração é um pouco diferente e exige um campo serverUrl ou url. Veja um exemplo de configuração para um servidor HTTP:

{
  "mcpServers": {
    "remote-http-mcp": {
      "serverUrl": "<your-server-url>/mcp",
      "headers": {
        "API_KEY": "value"
      }
    }
  }
}

Interpolação na configuração

O arquivo mcp_config.json do Cascade gerenciado pelo Cortex (por padrão ~/.config/devin/mcp_config.json no macOS e no Linux) 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.

{
  "mcpServers": {
    "remote-http-mcp": {
      "serverUrl": "<your-server-url>/mcp",
      "headers": {
        "API_KEY": "Bearer ${env:AUTH_TOKEN}"
      }
    }
  }
}

Controles administrativos (Teams & Enterprises)

Os administradores da equipe podem ativar ou desativar o acesso ao MCP para a equipe, bem como adicionar à lista de permissões servidores MCP aprovados para uso pela equipe:

Configurações de MCP da equipe

Configurações de MCP que podem ser definidas para sua equipe.

O link acima só funcionará se você tiver privilégios de administrador na sua equipe.

Por padrão, os usuários de uma equipe poderão configurar seus próprios servidores MCP. No entanto, assim que você adicionar um único servidor MCP à lista de permissões, todos os servidores que não estiverem nessa lista serão bloqueados para sua equipe.

Como funciona a correspondência de servidor

Quando você coloca um servidor MCP na lista de permissões, o sistema usa correspondência por padrão regex com as seguintes regras:

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.

Configuração da lista de permissões do administrador:

Server ID: github-mcp-server
Server Config (JSON): (deixe em branco)

{}

Configuração de usuário correspondente (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 ID do servidor corresponda à entrada na plugin store.

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.

Configuração da lista de permissões do 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": ""
  }
}

Configuração de usuário correspondente (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 essa configuração; qualquer desvio em 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.

Configuração da lista de permissões do administrador:

Server ID: python-mcp-server
Server Config (JSON):

{
  "command": "python3",
  "args": ["/.*\\.py", "--port", "[0-9]+"]
}

Configuração de usuário correspondente (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:

A regex /.*\\.py corresponde a qualquer caminho de arquivo Python, como /home/user/my_server.py
A 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ã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 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 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

Se os usuários relatarem que seus servidores MCP não estão funcionando após a inclusão na lista de permissões:

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

Lembre-se: depois que você inclui qualquer servidor na lista de permissões, todos os outros servidores são automaticamente bloqueados para os membros da sua equipe.

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.

Devin Desktop

Central de Comando do Agente

Lançamentos

Plugins do Windsurf

Contas

Segurança

Configuração de MCP no Windsurf Cascade

Adicionando um novo plugin MCP

mcp_config.json

MCPs HTTP remotos

Interpolação na configuração

Controles administrativos (Teams & Enterprises)

Configurações de MCP da equipe

Como funciona a correspondência de servidor

Opções de configuração

Padrões comuns de regex

Notas

Diretrizes de configuração do administrador

Solução de problemas

Informações gerais

​Adicionando um novo plugin MCP

​mcp_config.json

​MCPs HTTP remotos

​Interpolação na configuração

​Controles administrativos (Teams & Enterprises)

Configurações de MCP da equipe

​Como funciona a correspondência de servidor

​Opções de configuração

​Padrões comuns de regex

​Notas

​Diretrizes de configuração do administrador

​Solução de problemas

​Informações gerais

Adicionando um novo plugin MCP

mcp_config.json

MCPs HTTP remotos

Interpolação na configuração

Controles administrativos (Teams & Enterprises)

Como funciona a correspondência de servidor

Opções de configuração

Padrões comuns de regex

Notas

Diretrizes de configuração do administrador

Solução de problemas

Informações gerais