Claude Code pode se conectar a centenas de ferramentas externas e fontes de dados através do Model Context Protocol (MCP), um padrão de código aberto para integrações de ferramentas de IA. Servidores MCP dão ao Claude Code acesso às suas ferramentas, bancos de dados e APIs.

​
O que você pode fazer com MCP

Com servidores MCP conectados, você pode pedir ao Claude Code para:
  • Implementar recursos de rastreadores de problemas: “Adicione o recurso descrito no problema JIRA ENG-4521 e crie um PR no GitHub.”
  • Analisar dados de monitoramento: “Verifique Sentry e Statsig para verificar o uso do recurso descrito em ENG-4521.”
  • Consultar bancos de dados: “Encontre emails de 10 usuários aleatórios que usaram o recurso ENG-4521, baseado em nosso banco de dados Postgres.”
  • Integrar designs: “Atualize nosso modelo de email padrão baseado nos novos designs do Figma que foram postados no Slack”
  • Automatizar fluxos de trabalho: “Crie rascunhos no Gmail convidando esses 10 usuários para uma sessão de feedback sobre o novo recurso.”

​
Servidores MCP populares

Aqui estão alguns servidores MCP comumente usados que você pode conectar ao Claude Code:
Use servidores MCP de terceiros por sua própria conta e risco - Anthropic não verificou a correção ou segurança de todos esses servidores. Certifique-se de confiar nos servidores MCP que está instalando. Seja especialmente cuidadoso ao usar servidores MCP que podem buscar conteúdo não confiável, pois estes podem expô-lo ao risco de injeção de prompt.

Development & Testing Tools

Monitor errors, debug production issuesCommand
claude mcp add --transport http sentry https://mcp.sentry.dev/mcp
Security analysis for dependenciesCommand
claude mcp add --transport http socket https://mcp.socket.dev/
Provides access to Hugging Face Hub information and Gradio AI ApplicationsCommand
claude mcp add --transport http hugging-face https://huggingface.co/mcp
Debug faster with AI agents that can access Jam recordings like video, console logs, network requests, and errorsCommand
claude mcp add --transport http jam https://mcp.jam.dev/mcp

Project Management & Documentation

Interact with your Asana workspace to keep projects on trackCommand
claude mcp add --transport sse asana https://mcp.asana.com/sse
Manage your Jira tickets and Confluence docsCommand
claude mcp add --transport sse atlassian https://mcp.atlassian.com/v1/sse
Task management, project trackingCommand
claude mcp add clickup --env CLICKUP_API_KEY=YOUR_KEY --env CLICKUP_TEAM_ID=YOUR_ID -- npx -y @hauptsache.net/clickup-mcp
Access real-time customer conversations, tickets, and user dataCommand
claude mcp add --transport http intercom https://mcp.intercom.com/mcp
Integrate with Linear's issue tracking and project managementCommand
claude mcp add --transport sse linear https://mcp.linear.app/sse
Read docs, update pages, manage tasksCommand
claude mcp add --transport http notion https://mcp.notion.com/mcp
Ask questions about your enterprise content, get insights from unstructured data, automate content workflowsCommand
claude mcp add --transport http box https://mcp.box.com/
Extract valuable insights from meeting transcripts and summariesCommand
claude mcp add --transport http fireflies https://api.fireflies.ai/mcp
Manage monday.com boards by creating items, updating columns, assigning owners, setting timelines, adding CRM activities, and writing summariesCommand
claude mcp add --transport sse monday https://mcp.monday.com/sse

Databases & Data Management

Read/write records, manage bases and tablesCommand
claude mcp add airtable --env AIRTABLE_API_KEY=YOUR_KEY -- npx -y airtable-mcp-server
Supplies high quality fundamental financial data sourced from SEC Filings, investor presentationsCommand
claude mcp add --transport http daloopa https://mcp.daloopa.com/server/mcp
Access and manage HubSpot CRM data by fetching contacts, companies, and deals, and creating and updating recordsCommand
claude mcp add --transport http hubspot https://mcp.hubspot.com/anthropic

Payments & Commerce

Integrate PayPal commerce capabilities, payment processing, transaction managementCommand
claude mcp add --transport http paypal https://mcp.paypal.com/mcp
Analyze, troubleshoot, and optimize Plaid integrations. Banking data, financial account linkingCommand
claude mcp add --transport sse plaid https://api.dashboard.plaid.com/mcp/sse
Use an agent to build on Square APIs. Payments, inventory, orders, and moreCommand
claude mcp add --transport sse square https://mcp.squareup.com/sse
Payment processing, subscription management, and financial transactionsCommand
claude mcp add --transport http stripe https://mcp.stripe.com

Design & Media

Access designs, export assetsRequires latest Figma Desktop with Dev Mode MCP Server. If you have an existing server at http://127.0.0.1:3845/sse, delete it first before adding the new one.Command
claude mcp add --transport http figma-dev-mode-mcp-server http://127.0.0.1:3845/mcp
Upload, manage, transform, and analyze your media assetsMultiple services available. See documentation for specific server URLs.
Build video creation capabilities into your applicationsCommand
claude mcp add --transport sse invideo https://mcp.invideo.io/sse
Browse, summarize, autofill, and even generate new Canva designs directly from ClaudeCommand
claude mcp add --transport http canva https://mcp.canva.com/mcp

Infrastructure & DevOps

Build applications, analyze traffic, monitor performance, and manage security settings through CloudflareMultiple services available. See documentation for specific server URLs. Claude Code can use the Cloudflare CLI if installed.
Create, deploy, and manage websites on Netlify. Control all aspects of your site from creating secrets to enforcing access controls to aggregating form submissionsCommand
claude mcp add --transport http netlify https://netlify-mcp.netlify.app/mcp
Configure and manage Stytch authentication services, redirect URLs, email templates, and workspace settingsCommand
claude mcp add --transport http stytch http://mcp.stytch.dev/mcp
Vercel's official MCP server, allowing you to search and navigate documentation, manage projects and deployments, and analyze deployment logs—all in one placeCommand
claude mcp add --transport http vercel https://mcp.vercel.com/

Automation & Integration

Access any application, workflows or data via Workato, made accessible for AIMCP servers are programmatically generated
Connect to nearly 8,000 apps through Zapier's automation platformGenerate a user-specific URL at mcp.zapier.com
Precisa de uma integração específica? Encontre centenas de servidores MCP no GitHub, ou construa o seu próprio usando o MCP SDK.

​
Instalando servidores MCP

Servidores MCP podem ser configurados de três maneiras diferentes dependendo das suas necessidades:

​
Opção 1: Adicionar um servidor stdio local

Servidores stdio executam como processos locais na sua máquina. Eles são ideais para ferramentas que precisam de acesso direto ao sistema ou scripts personalizados. 
# Sintaxe básica
claude mcp add <nome> <comando> [args...]

# Exemplo real: Adicionar servidor Airtable
claude mcp add airtable --env AIRTABLE_API_KEY=SUA_CHAVE \
  -- npx -y airtable-mcp-server
Entendendo o parâmetro ”—”: O -- (traço duplo) separa as próprias flags CLI do Claude do comando e argumentos que são passados para o servidor MCP. Tudo antes de -- são opções para Claude (como --env, --scope), e tudo depois de -- é o comando real para executar o servidor MCP.Por exemplo:
  • claude mcp add myserver -- npx server → executa npx server
  • claude mcp add myserver --env KEY=value -- python server.py --port 8080 → executa python server.py --port 8080 com KEY=value no ambiente
Isso previne conflitos entre as flags do Claude e as flags do servidor.

​
Opção 2: Adicionar um servidor SSE remoto

Servidores SSE (Server-Sent Events) fornecem conexões de streaming em tempo real. Muitos serviços em nuvem usam isso para atualizações ao vivo. 
# Sintaxe básica
claude mcp add --transport sse <nome> <url>

# Exemplo real: Conectar ao Linear
claude mcp add --transport sse linear https://mcp.linear.app/sse

# Exemplo com cabeçalho de autenticação
claude mcp add --transport sse private-api https://api.company.com/mcp \
  --header "X-API-Key: sua-chave-aqui"

​
Opção 3: Adicionar um servidor HTTP remoto

Servidores HTTP usam padrões padrão de solicitação/resposta. A maioria das APIs REST e serviços web usam este transporte. 
# Sintaxe básica
claude mcp add --transport http <nome> <url>

# Exemplo real: Conectar ao Notion
claude mcp add --transport http notion https://mcp.notion.com/mcp

# Exemplo com token Bearer
claude mcp add --transport http secure-api https://api.example.com/mcp \
  --header "Authorization: Bearer seu-token"

​
Gerenciando seus servidores

Uma vez configurados, você pode gerenciar seus servidores MCP com estes comandos: 
# Listar todos os servidores configurados
claude mcp list

# Obter detalhes para um servidor específico
claude mcp get github

# Remover um servidor
claude mcp remove github

# (dentro do Claude Code) Verificar status do servidor
/mcp
Dicas:
  • Use a flag --scope para especificar onde a configuração é armazenada:
    • local (padrão): Disponível apenas para você no projeto atual (era chamado project em versões mais antigas)
    • project: Compartilhado com todos no projeto via arquivo .mcp.json
    • user: Disponível para você em todos os projetos (era chamado global em versões mais antigas)
  • Defina variáveis de ambiente com flags --env (ex: --env KEY=value)
  • Configure o timeout de inicialização do servidor MCP usando a variável de ambiente MCP_TIMEOUT (ex: MCP_TIMEOUT=10000 claude define um timeout de 10 segundos)
  • Claude Code exibirá um aviso quando a saída da ferramenta MCP exceder 10.000 tokens. Para aumentar este limite, defina a variável de ambiente MAX_MCP_OUTPUT_TOKENS (ex: MAX_MCP_OUTPUT_TOKENS=50000)
  • Use /mcp para autenticar com servidores remotos que requerem autenticação OAuth 2.0
Usuários Windows: No Windows nativo (não WSL), servidores MCP locais que usam npx requerem o wrapper cmd /c para garantir execução adequada.
# Isso cria command="cmd" que o Windows pode executar
claude mcp add my-server -- cmd /c npx -y @some/package
Sem o wrapper cmd /c, você encontrará erros de “Connection closed” porque o Windows não pode executar npx diretamente. (Veja a nota acima para uma explicação do parâmetro --.)

​
Escopos de instalação MCP

Servidores MCP podem ser configurados em três níveis de escopo diferentes, cada um servindo propósitos distintos para gerenciar acessibilidade e compartilhamento de servidores. Entender esses escopos ajuda você a determinar a melhor maneira de configurar servidores para suas necessidades específicas.

​
Escopo local

Servidores com escopo local representam o nível de configuração padrão e são armazenados nas suas configurações de usuário específicas do projeto. Esses servidores permanecem privados para você e são acessíveis apenas quando trabalhando dentro do diretório do projeto atual. Este escopo é ideal para servidores de desenvolvimento pessoal, configurações experimentais, ou servidores contendo credenciais sensíveis que não devem ser compartilhadas. 
# Adicionar um servidor com escopo local (padrão)
claude mcp add my-private-server /path/to/server

# Especificar explicitamente escopo local
claude mcp add my-private-server --scope local /path/to/server

​
Escopo de projeto

Servidores com escopo de projeto permitem colaboração em equipe armazenando configurações em um arquivo .mcp.json na raiz do seu projeto. Este arquivo é projetado para ser incluído no controle de versão, garantindo que todos os membros da equipe tenham acesso às mesmas ferramentas e serviços MCP. Quando você adiciona um servidor com escopo de projeto, Claude Code automaticamente cria ou atualiza este arquivo com a estrutura de configuração apropriada. 
# Adicionar um servidor com escopo de projeto
claude mcp add shared-server --scope project /path/to/server
O arquivo .mcp.json resultante segue um formato padronizado: 
{
  "mcpServers": {
    "shared-server": {
      "command": "/path/to/server",
      "args": [],
      "env": {}
    }
  }
}
Por razões de segurança, Claude Code solicita aprovação antes de usar servidores com escopo de projeto de arquivos .mcp.json. Se você precisar redefinir essas escolhas de aprovação, use o comando claude mcp reset-project-choices.

​
Escopo de usuário

Servidores com escopo de usuário fornecem acessibilidade entre projetos, tornando-os disponíveis em todos os projetos na sua máquina enquanto permanecem privados para sua conta de usuário. Este escopo funciona bem para servidores utilitários pessoais, ferramentas de desenvolvimento, ou serviços que você usa frequentemente em diferentes projetos. 
# Adicionar um servidor de usuário
claude mcp add my-user-server --scope user /path/to/server

​
Escolhendo o escopo certo

Selecione seu escopo baseado em:
  • Escopo local: Servidores pessoais, configurações experimentais, ou credenciais sensíveis específicas para um projeto
  • Escopo de projeto: Servidores compartilhados pela equipe, ferramentas específicas do projeto, ou serviços necessários para colaboração
  • Escopo de usuário: Utilitários pessoais necessários em múltiplos projetos, ferramentas de desenvolvimento, ou serviços usados frequentemente

​
Hierarquia de escopo e precedência

Configurações de servidor MCP seguem uma hierarquia de precedência clara. Quando servidores com o mesmo nome existem em múltiplos escopos, o sistema resolve conflitos priorizando servidores com escopo local primeiro, seguidos por servidores com escopo de projeto, e finalmente servidores com escopo de usuário. Este design garante que configurações pessoais possam sobrescrever as compartilhadas quando necessário.

​
Expansão de variável de ambiente em .mcp.json

Claude Code suporta expansão de variável de ambiente em arquivos .mcp.json, permitindo que equipes compartilhem configurações enquanto mantêm flexibilidade para caminhos específicos da máquina e valores sensíveis como chaves de API. Sintaxe suportada:
  • ${VAR} - Expande para o valor da variável de ambiente VAR
  • ${VAR:-default} - Expande para VAR se definida, caso contrário usa default
Locais de expansão: Variáveis de ambiente podem ser expandidas em:
  • command - O caminho do executável do servidor
  • args - Argumentos de linha de comando
  • env - Variáveis de ambiente passadas para o servidor
  • url - Para tipos de servidor SSE/HTTP
  • headers - Para autenticação de servidor SSE/HTTP
Exemplo com expansão de variável: 
{
  "mcpServers": {
    "api-server": {
      "type": "sse",
      "url": "${API_BASE_URL:-https://api.example.com}/mcp",
      "headers": {
        "Authorization": "Bearer ${API_KEY}"
      }
    }
  }
}
Se uma variável de ambiente necessária não estiver definida e não tiver valor padrão, Claude Code falhará ao analisar a configuração.

​
Exemplos práticos

​
Exemplo: Monitorar erros com Sentry

# 1. Adicionar o servidor MCP Sentry
claude mcp add --transport http sentry https://mcp.sentry.dev/mcp

# 2. Use /mcp para autenticar com sua conta Sentry
> /mcp

# 3. Depurar problemas de produção
> "Quais são os erros mais comuns nas últimas 24 horas?"
> "Mostre-me o stack trace para o erro ID abc123"
> "Qual deployment introduziu esses novos erros?"

​
Autenticar com servidores MCP remotos

Muitos servidores MCP baseados em nuvem requerem autenticação. Claude Code suporta OAuth 2.0 para conexões seguras.
1

Adicionar o servidor que requer autenticação

Por exemplo:
claude mcp add --transport http sentry https://mcp.sentry.dev/mcp
2

Use o comando /mcp dentro do Claude Code

No Claude code, use o comando:
> /mcp
Então siga os passos no seu navegador para fazer login.
Dicas:
  • Tokens de autenticação são armazenados com segurança e atualizados automaticamente
  • Use “Clear authentication” no menu /mcp para revogar acesso
  • Se seu navegador não abrir automaticamente, copie a URL fornecida
  • Autenticação OAuth funciona com transportes SSE e HTTP

​
Adicionar servidores MCP de configuração JSON

Se você tem uma configuração JSON para um servidor MCP, você pode adicioná-la diretamente:
1

Adicionar um servidor MCP do JSON

# Sintaxe básica
claude mcp add-json <nome> '<json>'

# Exemplo: Adicionando um servidor stdio com configuração JSON
claude mcp add-json weather-api '{"type":"stdio","command":"/path/to/weather-cli","args":["--api-key","abc123"],"env":{"CACHE_DIR":"/tmp"}}'
2

Verificar se o servidor foi adicionado

claude mcp get weather-api
Dicas:
  • Certifique-se de que o JSON esteja adequadamente escapado no seu shell
  • O JSON deve estar em conformidade com o esquema de configuração do servidor MCP
  • Você pode usar --scope user para adicionar o servidor à sua configuração de usuário em vez da específica do projeto

​
Importar servidores MCP do Claude Desktop

Se você já configurou servidores MCP no Claude Desktop, você pode importá-los:
1

Importar servidores do Claude Desktop

# Sintaxe básica 
claude mcp add-from-claude-desktop
2

Selecionar quais servidores importar

Após executar o comando, você verá um diálogo interativo que permite selecionar quais servidores você quer importar.
3

Verificar se os servidores foram importados

claude mcp list
Dicas:
  • Este recurso funciona apenas no macOS e Windows Subsystem for Linux (WSL)
  • Ele lê o arquivo de configuração do Claude Desktop de sua localização padrão nessas plataformas
  • Use a flag --scope user para adicionar servidores à sua configuração de usuário
  • Servidores importados terão os mesmos nomes que no Claude Desktop
  • Se servidores com os mesmos nomes já existirem, eles receberão um sufixo numérico (ex: server_1)

​
Usar Claude Code como um servidor MCP

Você pode usar Claude Code em si como um servidor MCP ao qual outras aplicações podem se conectar: 
# Iniciar Claude como um servidor MCP stdio
claude mcp serve
Você pode usar isso no Claude Desktop adicionando esta configuração ao claude_desktop_config.json: 
{
  "mcpServers": {
    "claude-code": {
      "command": "claude",
      "args": ["mcp", "serve"],
      "env": {}
    }
  }
}
Dicas:
  • O servidor fornece acesso às ferramentas do Claude como View, Edit, LS, etc.
  • No Claude Desktop, tente pedir ao Claude para ler arquivos em um diretório, fazer edições, e mais.
  • Note que este servidor MCP está simplesmente expondo as ferramentas do Claude Code ao seu cliente MCP, então seu próprio cliente é responsável por implementar confirmação do usuário para chamadas de ferramenta individuais.

​
Limites de saída MCP e avisos

Quando ferramentas MCP produzem saídas grandes, Claude Code ajuda a gerenciar o uso de tokens para prevenir sobrecarregar o contexto da sua conversa:
  • Limite de aviso de saída: Claude Code exibe um aviso quando qualquer saída de ferramenta MCP excede 10.000 tokens
  • Limite configurável: Você pode ajustar os tokens máximos permitidos de saída MCP usando a variável de ambiente MAX_MCP_OUTPUT_TOKENS
  • Limite padrão: O máximo padrão é 25.000 tokens
Para aumentar o limite para ferramentas que produzem saídas grandes: 
# Definir um limite maior para saídas de ferramenta MCP
export MAX_MCP_OUTPUT_TOKENS=50000
claude
Isso é particularmente útil quando trabalhando com servidores MCP que:
  • Consultam grandes conjuntos de dados ou bancos de dados
  • Geram relatórios detalhados ou documentação
  • Processam arquivos de log extensivos ou informações de depuração
Se você frequentemente encontra avisos de saída com servidores MCP específicos, considere aumentar o limite ou configurar o servidor para paginar ou filtrar suas respostas.

​
Usar recursos MCP

Servidores MCP podem expor recursos que você pode referenciar usando menções @, similar a como você referencia arquivos.

​
Referenciar recursos MCP

1

Listar recursos disponíveis

Digite @ no seu prompt para ver recursos disponíveis de todos os servidores MCP conectados. Recursos aparecem junto com arquivos no menu de autocompletar.
2

Referenciar um recurso específico

Use o formato @server:protocol://resource/path para referenciar um recurso:
> Você pode analisar @github:issue://123 e sugerir uma correção?

> Por favor revise a documentação da API em @docs:file://api/authentication
3

Múltiplas referências de recursos

Você pode referenciar múltiplos recursos em um único prompt:
> Compare @postgres:schema://users com @docs:file://database/user-model
Dicas:
  • Recursos são automaticamente buscados e incluídos como anexos quando referenciados
  • Caminhos de recursos são pesquisáveis de forma difusa no autocompletar de menção @
  • Claude Code automaticamente fornece ferramentas para listar e ler recursos MCP quando servidores os suportam
  • Recursos podem conter qualquer tipo de conteúdo que o servidor MCP fornece (texto, JSON, dados estruturados, etc.)

​
Usar prompts MCP como comandos slash

Servidores MCP podem expor prompts que se tornam disponíveis como comandos slash no Claude Code.

​
Executar prompts MCP

1

Descobrir prompts disponíveis

Digite / para ver todos os comandos disponíveis, incluindo aqueles de servidores MCP. Prompts MCP aparecem com o formato /mcp__servername__promptname.
2

Executar um prompt sem argumentos

> /mcp__github__list_prs
3

Executar um prompt com argumentos

Muitos prompts aceitam argumentos. Passe-os separados por espaço após o comando:
> /mcp__github__pr_review 456

> /mcp__jira__create_issue "Bug no fluxo de login" high
Dicas:
  • Prompts MCP são descobertos dinamicamente de servidores conectados
  • Argumentos são analisados baseados nos parâmetros definidos do prompt
  • Resultados de prompts são injetados diretamente na conversa
  • Nomes de servidor e prompt são normalizados (espaços se tornam sublinhados)