Pular para o conteúdo
Soluções MCP

Cliente MCP · Anthropic

Como configurar MCP no Claude Desktop

Aplicativo do Claude para macOS e Windows. Servidores locais entram em um arquivo JSON; servidores remotos, pela tela de conectores. O bloco abaixo sai no formato deste cliente, sem pedir token.

Conferido em . Formato lido em modelcontextprotocol.io — Connect to local MCP servers

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 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.

Onde fica a configuração

ModoSistemaCaminho
claude_desktop_config.jsonmacOS~/Library/Application Support/Claude/claude_desktop_config.json
claude_desktop_config.jsonWindows%APPDATA%\Claude\claude_desktop_config.json
claude_desktop_config.jsonLinux~/.config/Claude/claude_desktop_config.json
claude_desktop_config.json
Arquivo único de configuração do aplicativo.

Passo a passo

  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.

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.

Tokens e chaves neste cliente

O arquivo não expande variáveis: a credencial fica escrita no próprio JSON. O bloco gerado traz um marcador no lugar, para você substituir na sua máquina.

Particularidades

  • O guia oficial de servidores locais lista o Claude Desktop para macOS e Windows. O caminho do Linux (~/.config/Claude) aparece só no tutorial oficial de criação de servidores.
  • Servidores remotos não entram neste arquivo: são adicionados em Settings → Connectors → Add custom connector, colando a URL. O guia oficial descreve login pelo navegador nesse fluxo.
  • Os caminhos de pasta nos argumentos precisam ser absolutos. No Windows, cada barra invertida é escrita em dobro dentro do JSON.
  • No Windows, servidores iniciados com npx costumam precisar do invólucro cmd /c; o gerador aplica quando você escolhe Windows.

Quando não funciona

O servidor não aparece depois de reiniciar
Valide a sintaxe do JSON (vírgula sobrando é o erro mais comum) e confira se os caminhos são absolutos.
Aparece, mas falha ao conectar
Leia mcp.log e mcp-server-NOME.log em ~/Library/Logs/Claude (macOS) ou %APPDATA%\Claude\logs (Windows).
Erro ENOENT com ${APPDATA} no Windows
Acrescente "APPDATA" com o caminho expandido (C:\Users\voce\AppData\Roaming\) dentro de "env" do servidor e confirme que o npm está instalado globalmente.
Quer testar fora do aplicativo
Rode no terminal o mesmo comando e os mesmos argumentos do arquivo; o erro aparece direto na tela.

Outros clientes

Perguntas frequentes

Onde fica a configuração de MCP do Claude Desktop?

No macOS, em ~/Library/Application Support/Claude/claude_desktop_config.json. No Windows, em %APPDATA%\Claude\claude_desktop_config.json.

Como informo tokens e chaves no Claude Desktop?

O arquivo não expande variáveis: a credencial fica escrita no próprio JSON. O bloco gerado traz um marcador no lugar, para você substituir na sua máquina.

Como sei que o servidor conectou no Claude Desktop?

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.

De onde vem este formato?

Da documentação oficial (modelcontextprotocol.io — Connect to local MCP servers), lida em 03/10/2026. O JSON que o gerador produz para este cliente é fixado por teste automatizado.

Continue por aqui