Source: https://aiprimetech.io/pt/claude-code/mcp/ [Início](/pt/) › [Claude Code](/pt/claude-code/) › MCP [Visão geral](/pt/claude-code/)[Instalação](/pt/claude-code/install/)[referência da CLI](/pt/claude-code/cli/)[Preços e limites](/pt/claude-code/pricing/)[Agent SDK](/pt/claude-code/sdk/)[Skills e plugins](/pt/claude-code/skills/)[GitHub](/pt/claude-code/github/)[Web, desktop e IDE](/pt/claude-code/web-and-desktop/)[Modelos](/pt/claude-code/models/)[Erros](/pt/claude-code/errors/)[Código aberto?](/pt/claude-code/open-source/)[Tutorial](/pt/claude-code/tutorial/)[Para estudantes](/pt/claude-code/for-students/)[Automação de QA](/pt/claude-code/qa-automation/)[vs Cursor](/pt/claude-code/vs-cursor/)[vs Codex e OpenCode](/pt/claude-code/vs-codex/)[Subagentes](/pt/claude-code/subagents/)[Hooks](/pt/claude-code/hooks/)[MCP](/pt/claude-code/mcp/)[Ecossistema](/pt/claude-code/ecosystem/)[VS Code](/pt/claude-code/vscode/)[OpenRouter](/pt/claude-code/openrouter/)[Limites de requisições](/pt/claude-code/rate-limits/)[Guia em chinês](/claude-code/zh/) Última atualização: 11 de outubro de 2026 # MCP no Claude Code: conexão de servidores, escopos, MCP remoto e exemplos reais O MCP — Model Context Protocol — é a forma como o Claude Code acessa elementos que não são arquivos no seu repositório: um banco de dados, um navegador, o GitHub, suas análises, seu sistema de acompanhamento de chamados. Um servidor disponibiliza ferramentas e recursos; o Claude Code se conecta a ele e o agente pode usá-los como qualquer ferramenta integrada. A configuração exige um comando por servidor. ## TLDR - claude mcp add -- para servidores locais (stdio); claude mcp add --transport http para os remotos. - Escopos: local (você, neste projeto), project (.mcp.json, compartilhado com o repositório), user (você, em todos os projetos). - /mcp dentro de uma sessão mostra o status, autentica servidores OAuth e lista suas ferramentas. - Os recursos podem ser mencionados com @; os prompts do servidor aparecem como comandos de barra. ## Como adicionar um servidor ``` # local server over stdio (runs the command, talks over its stdin/stdout) claude mcp add playwright -- npx @playwright/mcp@latest # remote server over HTTP claude mcp add --transport http github https://api.githubcopilot.com/mcp/ # with a header (API-key style auth) claude mcp add --transport http posthog https://mcp.posthog.com/mcp \ --header "Authorization: Bearer $POSTHOG_API_KEY" claude mcp list # what is configured claude mcp remove playwright ``` Servidores stdio são programas que o Claude Code inicia para você — a maioria dos servidores da comunidade são pacotes npm ou Python executados dessa forma. Servidores remotos são URLs; eles se autenticam com OAuth (execute /mcp em uma sessão e siga o fluxo no navegador) ou com um cabeçalho que você informa ao adicionar o servidor, como no exemplo do PostHog. Consulte a documentação de cada fornecedor para obter a URL atual — os endpoints remotos mudam. ## Escopos e .mcp.json - local (padrão) — armazenado nas suas configurações de usuário, apenas para este projeto. Servidores pessoais e privados. - project (--scope project) — gravado em .mcp.json na raiz do repositório e compartilhado com todos que o clonam. O Claude Code pede confirmação antes de confiar nos servidores de um projeto pela primeira vez. - user (--scope user) — disponível em todos os projetos na sua máquina. ``` { "mcpServers": { "postgres": { "command": "npx", "args": ["-y", "@modelcontextprotocol/server-postgres", "${DATABASE_URL}"] } } } ``` .mcp.json oferece suporte à expansão de variáveis de ambiente, de modo que o repositório pode incluir a definição do servidor enquanto cada desenvolvedor fornece suas próprias credenciais. ## Como usar um servidor em uma sessão Após a conexão, as ferramentas do servidor ficam disponíveis — peça "os erros das últimas 24 horas no PostHog" e o Claude Code chama a ferramenta. Os recursos disponibilizados pelo servidor podem ser referenciados com menções com @ (@github:issue://123), que os incluem no contexto sob demanda. Os prompts definidos por um servidor aparecem como comandos de barra em /mcp____. /mcp mostra o status da conexão, permite reconectar ou autenticar e lista todas as ferramentas com suas descrições. ## Exemplos que vale a pena copiar - PostHog MCP — análises de produto de dentro do agente: "qual feature flag controla este código e como está sua implantação gradual?" O PostHog publica um servidor MCP remoto; adicione-o com --transport http e sua chave de API pessoal como cabeçalho bearer. - GitHub — issues e pull requests como contexto; combine com a Action do guia do GitHub para o ciclo de revisão. - Playwright — um navegador real para testes de ponta a ponta e para verificar a interface que você acabou de alterar; consulte o guia de automação de QA. - Postgres / SQLite — consultas e migrações que levam o esquema em conta; forneça um usuário com acesso somente de leitura, a menos que pretenda permitir alterações. - Sistema de arquivos fora do repositório — --add-dir é mais simples para diretórios adicionais; o MCP serve para elementos que não são arquivos. ## Custo e contexto Cada resultado de ferramenta retornado por um servidor MCP entra na conversa e é reenviado em cada turno seguinte. Um servidor que retorna 5,000 linhas é uma bomba de contexto. Prefira ferramentas com limites, peça resumos e /compact após uma consulta pesada. Os servidores são executados localmente ou se conectam ao fornecedor; eles não passam pelo endpoint do modelo, portanto ANTHROPIC_BASE_URL=https://aiprimetech.io não é afetado — apenas os tokens consumidos pelos resultados são cobrados. ## Experimente gratuitamente primeiro Novas contas recebem $5 em crédito gratuito para a API com o código CLAUDECODE — suficiente para uma noite de Claude Code com Sonnet — e depois créditos com 7.69231× o valor nominal. ``` export ANTHROPIC_BASE_URL=https://aiprimetech.io export ANTHROPIC_API_KEY=your_key ``` [Crie uma conta com o código CLAUDECODE](/register?promo=CLAUDECODE) ## Perguntas frequentes Como adiciono um servidor MCP ao Claude Code? `claude mcp add -- ` para um servidor local, ou `claude mcp add --transport http ` para um remoto; adicione `--scope project` para compartilhá-lo via .mcp.json.Como conecto o PostHog ao Claude Code? Adicione o servidor MCP remoto do PostHog com `claude mcp add --transport http posthog --header "Authorization: Bearer "`, usando a URL da documentação de MCP do PostHog, e depois pergunte sobre eventos, flags ou erros em uma sessão.O MCP funciona por meio de um gateway? Sim. Os servidores MCP são executados localmente ou se conectam ao fornecedor e são independentes do endpoint do modelo; apenas os tokens consumidos pelos seus resultados são cobrados pelo gateway. ## Execute o Claude Code no gateway Os mesmos modelos, duas variáveis de ambiente, créditos com 7.69231× o valor nominal — ou um plano ilimitado com preço fixo. Novas contas: $5 em crédito gratuito para a API com o código CLAUDECODE.[Obter uma chave de API](/register?promo=CLAUDECODE) [Ver planos ilimitados](/pt/plans/) A AI Prime Tech é um gateway de API independente e não é afiliada, endossada nem patrocinada pela Anthropic. “Claude” e “Claude Code” são marcas comerciais da Anthropic. Os recursos do Claude Code descritos aqui seguem a documentação pública da Anthropic no momento da redação e mudam com frequência; os preços e as listas de modelos nesta página são obtidos das configurações atuais deste gateway. ## Mais guias do Claude Code [Claude Code: o guia completo](/pt/claude-code/)[Como instalar o Claude Code](/pt/claude-code/install/)[Documentação da CLI do Claude Code: comandos e flags](/pt/claude-code/cli/)[Preços e limites do Claude Code, explicados](/pt/claude-code/pricing/)[O SDK do Claude Code, agora Claude Agent SDK](/pt/claude-code/sdk/)[Skills e plugins do Claude Code](/pt/claude-code/skills/)[Claude Code no GitHub: o App, a Action e @claude](/pt/claude-code/github/)[O Claude Code tem uma interface web? Entenda as versões web, desktop e para IDE](/pt/claude-code/web-and-desktop/)[Qual modelo o Claude Code usa e como alterá-lo](/pt/claude-code/models/)[Erros do Claude Code e como corrigi-los](/pt/claude-code/errors/)[O Claude Code é de código aberto?](/pt/claude-code/open-source/)[Tutorial do Claude Code: sua primeira sessão real](/pt/claude-code/tutorial/)[Claude para estudantes: Claude Code, a API e o que você realmente ganha na área de educação](/pt/claude-code/for-students/)[Como usar o Claude Code para automação de QA](/pt/claude-code/qa-automation/)[Claude Code vs Cursor: qual usar, quando — e como usar ambos](/pt/claude-code/vs-cursor/)[Claude Code vs Codex vs OpenCode: comparação dos agentes de terminal](/pt/claude-code/vs-codex/)[Subagentes do Claude Code: como funcionam, como defini-los e equipes de agentes](/pt/claude-code/subagents/)[Hooks do Claude Code: controle determinístico sobre o que o agente faz](/pt/claude-code/hooks/)[O ecossistema do Claude Code: roteadores, frameworks, plugins e as listas que os acompanham](/pt/claude-code/ecosystem/)[Claude Code no VS Code: a extensão, o uso pelo terminal e os erros](/pt/claude-code/vscode/)[Como usar o OpenRouter no Claude Code (e quando não usar)](/pt/claude-code/openrouter/)[Erro de limite de taxa do Claude: o que significa "Erro de API: limite de taxa atingido" e como corrigir](/pt/claude-code/rate-limits/)[Como usar o Claude Code: da instalação ao uso diário](/claude-code/zh/)