Como adicionar servidores MCP ao Windsurf (mcp_config.json)

Configure servidores MCP locais e remotos para o agente Cascade do Windsurf no mcp_config.json: local do arquivo, serverUrl para servidores remotos e como desativar ferramentas.

1. Abra o mcp_config.json

No painel do Cascade, clique no menu … (Actions) no canto superior direito e escolha Open MCP config file na seção MCPs. Segundo a documentação atual, o arquivo fica em ~/.config/devin/mcp_config.json no macOS e Linux e em %APPDATA%\devin\mcp_config.json no Windows (o Windsurf agora faz parte do Devin Desktop; versões antigas do Windsurf usavam ~/.codeium/windsurf/mcp_config.json). Abrindo pelo menu, você sempre pega o arquivo certo.

2. Adicione um servidor local (stdio)

Adicione uma entrada em mcpServers, no mesmo formato usado pelo Claude Desktop e pelo Cursor:

{
  "mcpServers": {
    "github": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-github"
      ],
      "env": {
        "GITHUB_PERSONAL_ACCESS_TOKEN": "<YOUR_TOKEN>"
      }
    }
  }
}

3. Adicione um servidor remoto

Servidores HTTP remotos usam serverUrl (ou url) em vez de um comando. Exemplo com o servidor gratuito do Socketlist:

{
  "mcpServers": {
    "socketlist": {
      "serverUrl": "https://socketlist.pages.dev/mcp"
    }
  }
}

Adicione um objeto headers se o servidor exigir uma chave de API.

4. Mantenha segredos fora do arquivo

A configuração aceita ${env:VAR_NAME} e ${file:/path/to/file} em command, args, env, serverUrl, url e headers.

5. Ative ou desative servidores e ferramentas

A seção MCPs do menu Actions lista cada servidor com uma chave liga/desliga. Para ocultar ferramentas específicas, adicione "disabledTools": ["tool_name"] à entrada do servidor. O Cascade usa no máximo 100 ferramentas ao mesmo tempo.

Observações

Isso vale para o agente Cascade. O agente mais novo, Devin Local, guarda os servidores MCP na configuração do Devin CLI. Fonte: a documentação oficial de MCP do Cascade.