Pular para o conteúdo
Soluções MCP

Cliente MCP · Cognition

Como configurar MCP no Windsurf (Devin Desktop)

Editor com o agente Cascade, hoje documentado como Devin Desktop. Os servidores ficam no arquivo mcp_config.json. O bloco abaixo sai no formato deste cliente, sem pedir token.

Conferido em . Formato lido em docs.devin.ai — Cascade MCP (destino do redirecionamento de docs.windsurf.com)

Passo 1Escolha os servidores

Quem mantém

1 selecionado: Filesystem. Ver o catálogo com os sinais de confiança

Passo 2Informe o seu sistema

Sistema

Passo 3Copie a configuração para o Windsurf (Devin Desktop)

Nenhum token passou por este site. O que está destacado você preenche na sua máquina; o gerador não tem campo para credencial.

mcp_config.json~/.config/devin/mcp_config.json
{
  "mcpServers": {
    "filesystem": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-filesystem",
        "<PASTA_PERMITIDA>"
      ]
    }
  }
}

Preencha na sua máquina

  • PASTA_PERMITIDACaminho absoluto da pasta que o assistente poderá ler e alterar (Filesystem)Ex.: /Users/voce/Documentos/projeto ou C:\Users\voce\Documentos\projeto. Só essa pasta fica acessível.Substitua <PASTA_PERMITIDA> pelo valor, direto no arquivo, na sua máquina.

Onde colar

  1. No painel do Cascade, abra o menu de ações (os três pontos, no alto à direita) e clique no ícone do arquivo de configuração de MCP.
  2. Cole o bloco. Se já houver "mcpServers", acrescente as entradas dentro dele.
  3. Defina as variáveis de ambiente indicadas e reabra o aplicativo.

Antes de começar

Como conferir

  • No mesmo painel de MCP, cada servidor aparece com o estado e a quantidade de ferramentas ativas.

Onde fica a configuração

ModoSistemaCaminho
mcp_config.jsonmacOS, Linux~/.config/devin/mcp_config.json
mcp_config.jsonWindows%APPDATA%\devin\mcp_config.json
mcp_config.json
Arquivo único, na pasta de configuração do aplicativo.

Passo a passo

  1. No painel do Cascade, abra o menu de ações (os três pontos, no alto à direita) e clique no ícone do arquivo de configuração de MCP.
  2. Cole o bloco. Se já houver "mcpServers", acrescente as entradas dentro dele.
  3. Defina as variáveis de ambiente indicadas e reabra o aplicativo.

Como conferir

  • No mesmo painel de MCP, cada servidor aparece com o estado e a quantidade de ferramentas ativas.

Tokens e chaves neste cliente

O arquivo aceita ${env:NOME} (variável de ambiente) e ${file:/caminho} (conteúdo de um arquivo). O gerador usa ${env:NOME} em env e headers.

Particularidades

  • Na data da conferência, docs.windsurf.com/windsurf/cascade/mcp redirecionava para a documentação do Devin Desktop, que descreve essa configuração como a do agente Cascade (legado). Se a sua instalação for anterior a essa mudança, o arquivo pode estar em outro lugar: abra-o sempre pelo painel.
  • Servidores remotos usam "serverUrl" (a documentação também aceita "url").
  • O Cascade tem limite de 100 ferramentas ativas ao mesmo tempo. Desative no painel as que não usa.
  • Transportes aceitos: stdio, Streamable HTTP e SSE.

Quando não funciona

Passou do limite de ferramentas
Abra cada servidor no painel de MCP e desmarque ferramentas; servidores grandes, como o do GitHub, somam dezenas.
Não encontra o arquivo
Use o ícone do painel do Cascade em vez de procurar a pasta: ele abre o arquivo correto da sua versão.

Outros clientes

Perguntas frequentes

Onde fica a configuração de MCP do Windsurf (Devin Desktop)?

No macOS, em ~/.config/devin/mcp_config.json. No Windows, em %APPDATA%\devin\mcp_config.json.

Como informo tokens e chaves no Windsurf (Devin Desktop)?

O arquivo aceita ${env:NOME} (variável de ambiente) e ${file:/caminho} (conteúdo de um arquivo). O gerador usa ${env:NOME} em env e headers.

Como sei que o servidor conectou no Windsurf (Devin Desktop)?

No mesmo painel de MCP, cada servidor aparece com o estado e a quantidade de ferramentas ativas.

De onde vem este formato?

Da documentação oficial (docs.devin.ai — Cascade MCP (destino do redirecionamento de docs.windsurf.com)), lida em 03/10/2026. O JSON que o gerador produz para este cliente é fixado por teste automatizado.

Continue por aqui