//
Busque em todas as páginas da documentação
As ferramentas embutidas do Claude Code, comandos de leitura, edição, busca e execução, são suficientes para a maioria dos trabalhos em um repositório local.
Um servidor MCP (Model Context Protocol) estende esse conjunto de ferramentas com capacidades externas, como consultar um banco de dados ou registrar um ticket em um rastreador de issues, sem sair da mesma sessão.
Cartão de receita de referência rápida - pronto para copiar e colar.
# Add an MCP server to Claude Code (illustrative form)
claude mcp add <name> <command-to-start-the-server>
# List servers currently connected
claude mcp listQuando usar isso:
Uma forma comum para isso: uma sessão que precisa verificar um rastreador de issues para contexto antes de mexer no código.
# 1. Connect a server once for the project (exact flags depend on the
# server; check its own docs for the precise command it expects)
claude mcp add issue-tracker npx -y some-issue-tracker-mcp-server
# 2. Confirm it connected
claude mcp list
# issue-tracker connected
# 3. Start a normal session; the server's tools are now part of the toolset
claudeDentro dessa sessão, um prompt como "procure o ticket ENG-482 e corrija o bug que ele descreve" agora pode resolver a busca através da ferramenta do servidor conectado, e então entrar diretamente no loop normal de leitura-edição-execução-verificação do Claude Code para a própria alteração do código.
O que isso demonstra:
MCP é um tópico grande o suficiente para ter suas próprias seções dedicadas neste site. Esta página é intencionalmente uma prévia, não o quadro completo:
| Tópico | Para onde ir para saber mais |
|---|---|
| Conceitos centrais do MCP (servidores, ferramentas, recursos, prompts) | Seção mcp-core-concepts |
| Construindo seu próprio servidor MCP | Seção building-mcp-servers |
| Escolhas de transporte, autenticação, esquemas de ferramentas | Páginas de referência dentro dessas seções |
| Alternativa | Use Quando | Não Use Quando |
|---|---|---|
| Apenas ferramentas embutidas (ler, editar, buscar, executar) | A tarefa é inteiramente local ao repositório | A tarefa precisa de dados ou ações de um sistema externo |
| Copiar e colar manualmente de uma ferramenta externa para o chat | Uma busca única, sem necessidade repetida | A busca ou ação acontece com frequência suficiente para valer a pena automatizar |
| Um script personalizado invocado através do passo de execução | A interação externa é simples o suficiente para uma chamada CLI única | O sistema precisa de acesso a ferramentas estruturado e repetível em muitas sessões |
MCP significa Model Context Protocol (Protocolo de Contexto do Modelo).
É o protocolo que o Claude Code usa para se conectar a servidores externos para que suas ferramentas se tornem parte do conjunto de ferramentas disponíveis de uma sessão.
Ferramentas embutidas, comandos de leitura, edição, busca e execução, operam no repositório e shell locais.
As ferramentas de um servidor MCP alcançam além disso, para qualquer sistema que o servidor foi construído para expor, como um banco de dados ou um rastreador de issues.
Não, uma vez que um servidor é conectado, suas ferramentas são simplesmente parte do conjunto de ferramentas para aquela sessão.
O Claude Code escolhe entre ferramentas embutidas e ferramentas MCP com base no que a tarefa requer, da mesma forma que escolhe entre quaisquer duas ferramentas embutidas.
O mecanismo permanece o mesmo: dependendo do seu modo de permissão, algumas chamadas de ferramenta são pré-aprovadas e outras solicitam confirmação.
Chamadas de ferramenta MCP participam dessa mesma lógica em vez de seguir regras separadas.
Isso depende inteiramente de quais ferramentas o servidor expõe.
Alguns servidores oferecem ferramentas somente leitura, outros oferecem ferramentas que criam ou modificam registros; verifique a documentação do servidor específico.
É ilustrativo do formato geral, conectar um servidor por nome com um comando que o inicia.
Flags exatas podem variar por versão do Claude Code e pelo próprio servidor, então verifique a documentação atual antes de confiar na sintaxe precisa.
Esta página é uma prévia de nível básico.
A seção mcp-core-concepts cobre o protocolo subjacente em profundidade, e a seção building-mcp-servers cobre a construção de um servidor próprio.
Sim, múltiplos servidores podem ser conectados, e todas as suas ferramentas se tornam disponíveis ao lado das ferramentas embutidas do Claude Code para aquela sessão.
Uma chamada de ferramenta para esse servidor falhará ou o servidor não aparecerá como conectado.
Verificar a conexão com um comando de status ou lista após adicionar um servidor captura isso antes que ele interrompa uma tarefa.
Conectar é tipicamente um passo de configuração único para um projeto, não algo a ser repetido a cada sessão.
Uma vez conectado, as ferramentas do servidor ficam disponíveis em sessões subsequentes sem reconectar.
Um script único funciona para uma única chamada, mas um servidor MCP dá ao Claude Code uma ferramenta estruturada e repetível que ele pode reutilizar em prompts e sessões sem que você escreva um novo script a cada vez.
Não, a construção de um servidor é abordada separadamente na seção building-mcp-servers.
Esta página apenas pré-visualiza a conexão a um existente.
Versões de Stack: Escrito contra a linha de modelos Claude atual em ~junho de 2026 - Claude Fable 5, Claude Opus 4.8, Claude Sonnet 5 (o padrão), e Claude Haiku 4.5. Nomes de modelos, preços e recursos do produto mudam rapidamente - verifique os detalhes atuais em platform.claude.com/docs antes de confiar neles.