Pular para o conteúdo
Soluções MCP

Cliente MCP · Anthropic

Como configurar MCP no Claude Code

Agente de programação no terminal. Servidores são adicionados com o comando claude mcp add ou por um arquivo .mcp.json no projeto. O bloco abaixo sai no formato deste cliente, sem pedir token.

Conferido em . Formato lido em code.claude.com — Connect Claude Code to tools via MCP

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
Onde instalar

Passo 3Copie a configuração para o Claude Code

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

ComandosTerminal, na pasta do projeto
claude mcp add --transport stdio filesystem -- npx -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 comando, na sua máquina.

Onde colar

  1. Comando: abra o terminal na pasta do projeto, troque os marcadores pelos valores reais e execute cada linha.
  2. Tudo o que vem depois de -- é o comando do servidor, repassado sem alteração; as opções do claude (--env, --scope, --transport) vêm antes do nome.
  3. Arquivo: salve o bloco como .mcp.json na raiz do projeto e defina as variáveis de ambiente indicadas antes de abrir o Claude Code.
  4. Para valer em todos os seus projetos, acrescente --scope user ao comando.

Antes de começar

Como conferir

  • No terminal: claude mcp list mostra os servidores configurados.
  • Dentro de uma sessão: /mcp mostra o estado de cada servidor e inicia o login dos remotos que usam OAuth.

Onde fica a configuração

ModoSistemaCaminho
.mcp.json (equipe)macOS, Windows, Linux.mcp.json (raiz do projeto)
Comando (só para mim)
claude mcp add grava no escopo local (padrão), em ~/.claude.json, valendo só para o projeto atual.
.mcp.json (equipe)
Arquivo na raiz do projeto, versionado e compartilhado. As credenciais ficam em variáveis de ambiente, fora do arquivo.

Passo a passo

  1. Comando: abra o terminal na pasta do projeto, troque os marcadores pelos valores reais e execute cada linha.
  2. Tudo o que vem depois de -- é o comando do servidor, repassado sem alteração; as opções do claude (--env, --scope, --transport) vêm antes do nome.
  3. Arquivo: salve o bloco como .mcp.json na raiz do projeto e defina as variáveis de ambiente indicadas antes de abrir o Claude Code.
  4. Para valer em todos os seus projetos, acrescente --scope user ao comando.

Como conferir

  • No terminal: claude mcp list mostra os servidores configurados.
  • Dentro de uma sessão: /mcp mostra o estado de cada servidor e inicia o login dos remotos que usam OAuth.

Tokens e chaves neste cliente

No comando, o valor vai em --env ou --header e fica gravado em ~/.claude.json. No .mcp.json, o gerador usa ${VARIAVEL}, que o Claude Code expande a partir do ambiente: nada sensível entra no repositório.

Particularidades

  • Escopos: local (padrão, só você, só este projeto), project (arquivo .mcp.json compartilhado) e user (você, em todos os projetos).
  • No .mcp.json, um servidor remoto precisa de "type": "http". Uma entrada com "url" e sem "type" é lida como stdio e dá erro.
  • A expansão aceita ${VAR} e ${VAR:-padrão}, em command, args, env, url e headers.
  • No Windows, comandos com npx podem precisar do invólucro cmd /c; o gerador aplica quando você escolhe Windows.

Quando não funciona

O servidor aparece como falho em /mcp
Rode claude mcp get NOME para ver o comando gravado e execute-o à mão no terminal.
Variável não expandida no .mcp.json
Ela precisa existir no ambiente do terminal que abre o Claude Code. Sem valor e sem padrão, a entrada falha.
Precisa remover
claude mcp remove NOME.

Outros clientes

Perguntas frequentes

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

No modo padrão não há arquivo para editar: os servidores são adicionados pelo comando claude mcp add, que grava em ~/.claude.json. Para compartilhar com a equipe, use o arquivo .mcp.json na raiz do projeto.

Como informo tokens e chaves no Claude Code?

No comando, o valor vai em --env ou --header e fica gravado em ~/.claude.json. No .mcp.json, o gerador usa ${VARIAVEL}, que o Claude Code expande a partir do ambiente: nada sensível entra no repositório.

Como sei que o servidor conectou no Claude Code?

No terminal: claude mcp list mostra os servidores configurados. Dentro de uma sessão: /mcp mostra o estado de cada servidor e inicia o login dos remotos que usam OAuth.

De onde vem este formato?

Da documentação oficial (code.claude.com — Connect Claude Code to tools via MCP), lida em 03/10/2026. O JSON que o gerador produz para este cliente é fixado por teste automatizado.

Continue por aqui