Pular para o conteúdo
Soluções MCP

Gerador de configuração MCP

O bloco certo para Claude Desktop, Claude Code, Cursor, VS Code ou Windsurf, com o caminho do arquivo. Sem campo para token: o que é segredo sai como marcador e é preenchido na sua máquina.

Passo 1Escolha os servidores

Quem mantém

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

Passo 2Diga onde você vai usar

Sistema

Passo 3Copie a configuração para o Claude 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.

claude_desktop_config.json~/Library/Application Support/Claude/claude_desktop_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. Abra o Claude Desktop e, no menu do sistema (não na janela da conversa), escolha Settings.
  2. Na aba Developer, clique em Edit Config. O aplicativo cria o arquivo se ele não existir e o mostra na pasta.
  3. Cole o bloco. Se o arquivo já tiver "mcpServers", acrescente só as entradas novas dentro dele.
  4. Substitua cada marcador <ASSIM> pelo valor real e salve.
  5. Feche o Claude Desktop por completo e abra de novo: os servidores só são carregados na inicialização.

Antes de começar

Como conferir

  • Na caixa de mensagem, abra o botão de adicionar arquivos e conectores, passe por Connectors e veja se o servidor aparece na lista com as ferramentas.
Guia completo do Claude Desktop

O que muda de um cliente para outro

ClienteArquivo (macOS)Chave raizCredencialConferido
Claude Desktop~/Library/Application Support/Claude/claude_desktop_config.jsonmcpServersmarcador <NOME> no arquivo
Claude Codeclaude mcp add (terminal)mcpServers (.mcp.json)--env no comando, ou ${NOME} no .mcp.json
Cursor.cursor/mcp.jsonmcpServers${env:NOME}
VS Code.vscode/mcp.jsonservers${input:nome}, com caixa de senha
Windsurf~/.config/devin/mcp_config.jsonmcpServers${env:NOME}

Como o gerador monta o bloco

Cada servidor do catálogo guarda três coisas: o comando ou a URL publicados no README, as variáveis que ele exige e quais delas são credenciais. Cada cliente guarda a chave raiz do arquivo, os campos de um servidor local e de um remoto, e a forma como aceita valores externos. O gerador cruza as duas tabelas.

Por isso a mesma escolha produz saídas diferentes. Para o Notion no VS Code, o arquivo ganha uma entrada em inputs e o editor pede o token em uma caixa de senha. No Cursor, o token vira ${env:NOTION_TOKEN}, lido do ambiente. No Claude Desktop, que não expande variáveis, fica o marcador <NOTION_TOKEN> para você trocar.

Juntar com um arquivo que já existe

O bloco gerado é um arquivo completo. Se o seu já tem servidores, não cole por cima: copie só as entradas de dentro de mcpServers (ou servers, no VS Code) e acrescente-as às que já estão lá, separadas por vírgula. Um JSON inválido faz o cliente ignorar o arquivo inteiro, e a vírgula sobrando depois da última entrada é o erro mais comum.

Servidores remotos

Um servidor remoto não é iniciado na sua máquina: o cliente se conecta a uma URL. No arquivo, isso aparece como url (Cursor), serverUrl (Windsurf) ou url com "type": "http" (VS Code e .mcp.json). No Claude Desktop, servidores remotos não entram no arquivo: são adicionados na tela de conectores, e o gerador entrega a lista de URLs para colar ali.

Windows

No Windows, o Claude Desktop e o Claude Code costumam precisar que npx seja chamado por cmd /c. Escolha Windows no primeiro passo e o gerador aplica o invólucro e mostra o caminho com %APPDATA%. Caminhos de pasta dentro do JSON levam barra invertida em dobro: C:\\Users\\voce\\projeto.

Quando não funciona

  • Rode no terminal o mesmo comando e os mesmos argumentos do arquivo. Se falhar ali, o problema é do servidor ou do pré-requisito, não do cliente.
  • Confira se o marcador foi trocado. Um <PASTA_PERMITIDA> esquecido faz o servidor encerrar na hora.
  • Reinicie o cliente por completo. A maioria só lê a configuração ao abrir.
  • Veja a seção de diagnóstico do guia do seu cliente: cada um guarda os logs em um lugar.

Perguntas frequentes

O gerador pede meu token ou minha chave de API?

Não. O gerador não tem campo para credencial. A configuração sai com marcadores como <NOTION_TOKEN>, com referências a variáveis de ambiente ou, no VS Code, com um pedido de senha feito pelo próprio editor. Você preenche o valor na sua máquina.

Por que a configuração muda de um cliente para outro?

Cada cliente lê um arquivo diferente e usa uma sintaxe própria. O Claude Desktop e o Cursor usam a chave "mcpServers"; o VS Code usa "servers" e exige "type"; o Windsurf chama a URL de servidor remoto de "serverUrl"; o Claude Code aceita comando de terminal ou um arquivo .mcp.json. Copiar o JSON de um cliente para outro sem ajustar é a causa mais comum de servidor que não aparece.

Já tenho um arquivo de configuração. Posso colar por cima?

Não substitua o arquivo inteiro. Copie só as entradas de dentro de "mcpServers" (ou "servers", no VS Code) e acrescente-as ao bloco que já existe, separando por vírgula.

O que são os marcadores em âmbar?

São os valores que só você conhece: caminho de uma pasta, endereço de um banco, token de um serviço. Eles aparecem entre os sinais de menor e maior, em maiúsculas. Troque cada um pelo valor real depois de colar, na sua máquina.

Preciso instalar alguma coisa antes?

Servidores locais são iniciados por npx (vem com o Node.js), uvx (vem com o uv, para servidores em Python) ou Docker. O gerador lista o que os servidores escolhidos exigem. Servidores remotos não instalam nada: o cliente só precisa da URL.

A configuração gerada é testada?

O formato de cada cliente foi lido na documentação oficial, e a saída do gerador é fixada por testes automatizados. O comando de cada servidor foi conferido no README do repositório na data indicada na página do servidor. Como clientes e servidores mudam, cada página informa a data da conferência.

Continue por aqui