Conectar Claude Code a ferramentas via MCP

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:

​

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

​

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

# Isso cria command="cmd" que o Windows pode executar
claude mcp add my-server -- cmd /c npx -y @some/package

​

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 frequentemente usados

​

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áveis de ambiente em .mcp.json

Claude Code suporta expansão de variáveis 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 da 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.

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

> /mcp

​

Adicionar servidores MCP de configuração JSON

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

# 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"}}'

claude mcp get weather-api

​

Importar servidores MCP do Claude Desktop

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

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

claude mcp list 

​

Usar Claude Code como um servidor MCP

Você pode usar o próprio Claude Code 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": {}
    }
  }
}

​

Usar recursos MCP

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

​

Referenciar recursos MCP

> Você pode analisar @github:issue://123 e sugerir uma correção?

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

> Compare @postgres:schema://users com @docs:file://database/user-model

​

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

> /mcp__github__list_prs

> /mcp__github__pr_review 456

> /mcp__jira__create_issue "Bug no fluxo de login" high