Gerencie e compartilhe MCP servers

Organize servers com scopes e compartilhe com o time

⏱ Estim. ~5 min

01 · Ler

Quando você adiciona um MCP server, escolhe um scope que decide quem vê e onde fica salvo.

Local (padrão) — privado, só no projeto atual. Salvo em ~/.claude.json sob o caminho do seu projeto. Use para servers pessoais em desenvolvimento ou servers com credenciais sensíveis.

Project — compartilhado com o time via .mcp.json na raiz do repo. Faça commit no git e todo mundo que clonar o repo recebe os mesmos servers. Use para ferramentas padrão do time.

User — disponível em todos os seus projetos. Salvo em ~/.claude.json. Bom para ferramentas pessoais que você usa em todo lugar (como GitHub ou um banco pessoal).

Pontos-chave

Local (padrão): privado, só no projeto atual
Project: compartilhado com o time via .mcp.json no repo, commitado no git
User: pessoal, disponível em todos os seus projetos
Escolha com --scope local|project|user

02 · Exemplo de código

A flag --scope controla onde a configuração do server fica salva.

Scope local (padrão — só você, este projeto)

claude mcp add --transport http stripe https://mcp.stripe.com

Scope project (compartilhado com o time via git)

claude mcp add --transport http paypal --scope project https://mcp.paypal.com/mcp

Scope user (você, todos os projetos)

claude mcp add --transport http github --scope user https://api.githubcopilot.com/mcp/

Local é o padrão — você não precisa de --scope local. O scope project cria um arquivo .mcp.json no seu repo, que os colegas recebem quando dão pull. O scope user fica nas configurações do diretório do usuário e te acompanha em todo lugar.

03 · Exemplo de código

Quando você usa --scope project, o Claude Code cria um arquivo .mcp.json na raiz do seu repo. Ele tem este formato — você pode dar commit no git.

.mcp.json (commit no repo)

{
  "mcpServers": {
    "github": {
      "type": "http",
      "url": "https://api.githubcopilot.com/mcp/"
    },
    "db": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@bytebase/dbhub", "--dsn", "${DATABASE_URL}"],
      "env": {
        "DATABASE_URL": "${DATABASE_URL}"
      }
    }
  }
}

Repare na sintaxe ${DATABASE_URL} — variáveis de ambiente são expandidas em tempo de execução, então você compartilha a configuração sem expor segredos. Cada colega define DATABASE_URL no próprio ambiente. A estrutura do arquivo segue o formato padrão que o Claude Code lê automaticamente.

04 · Ler

Depois de configurar servers, você os gerencia com alguns comandos simples.

claude mcp list mostra todos os servers. claude mcp get <name> mostra detalhes de um server. claude mcp remove <name> remove um server.

Dentro do Claude Code, digite /mcp para ver o status dos servers, autenticar com servers OAuth ou resolver problemas de conexão. Quando um server não responde, /mcp é o primeiro lugar para diagnosticar.

Pontos-chave

claude mcp list — ver todos os servers configurados
claude mcp get <name> — detalhes de um server
claude mcp remove <name> — remover um server
/mcp dentro do Claude Code — status, auth, solução de problemas

05 · Quiz

Todo mundo do seu time precisa usar o mesmo MCP server do Sentry. Você quer commitar a configuração no git para que novos membros recebam automaticamente. Qual scope usar?

Local (padrão)
Project
User
Global

06 · Classificar arrastando

Você tem três MCP servers diferentes para configurar. Ligue cada um ao scope correto, pensando em quem precisa dele.

(Esta seção é interativa — ative o JavaScript para usar.)

Outras lições deste capítulo

⚠ A experiência interativa completa precisa de JavaScript. Ative-o e recarregue a página.

※ Este é um projeto educacional independente — não é um produto oficial da Anthropic. Claude™ é uma marca registrada da Anthropic, PBC.