Adicionar servidores MCP ao Claude Code

O Claude Code obtém os servidores pelo comando claude mcp add ou por um arquivo .mcp.json na raiz do repositório.

macOS

~/.claude.json

Windows

~/.claude.json

Linux

~/.claude.json

Arquivo do projeto

.mcp.json

Chave de nível superior

mcpServers

Formato

json

OAuth para servidores remotos

●Sim

Exemplo de configuração

Este exemplo adiciona o servidor hospedado do GitHub e o Playwright como servidor local, no formato esperado por este cliente.

{
  "mcpServers": {
    "github": {
      "type": "http",
      "url": "https://api.githubcopilot.com/mcp/"
    },
    "playwright": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "@playwright/mcp@latest"
      ]
    }
  }
}

claude mcp add --transport http --scope project github https://api.githubcopilot.com/mcp/
claude mcp add --scope project playwright -- npx @playwright/mcp@latest

Observações e particularidades

• Os escopos local, padrão, e de usuário ficam em ~/.claude.json; o escopo do projeto fica em .mcp.json.
• Toda entrada com url também precisa de um type, como http; informar apenas url gera um erro.
• Os valores no arquivo expandem ${VAR} e ${VAR:-default}.
• Execute /mcp em uma sessão para fazer login em servidores OAuth. Para apps OAuth pré-registrados, informe --client-id, --client-secret e --callback-port.

Criar uma configuração do Claude Code →

Outros clientes