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 e-mails de 10 usuários aleatórios que usaram o recurso ENG-4521, com base no nosso banco de dados Postgres.”
- Integrar designs: “Atualize nosso modelo de e-mail padrão com base nos novos designs do Figma que foram postados no Slack”
- Automatizar fluxos de trabalho: “Crie rascunhos do 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 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.
Tenha especial cuidado 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/mcpSecurity 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/mcpDebug 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/mcpProject Management & Documentation
Interact with your Asana workspace to keep projects on trackCommand
claude mcp add --transport sse asana https://mcp.asana.com/sseManage your Jira tickets and Confluence docsCommand
claude mcp add --transport sse atlassian https://mcp.atlassian.com/v1/sseTask management, project trackingCommand
claude mcp add --transport stdio clickup --env CLICKUP_API_KEY=YOUR_KEY --env CLICKUP_TEAM_ID=YOUR_ID -- npx -y @hauptsache.net/clickup-mcpAccess real-time customer conversations, tickets, and user dataCommand
claude mcp add --transport http intercom https://mcp.intercom.com/mcpIntegrate with Linear's issue tracking and project managementCommand
claude mcp add --transport http linear https://mcp.linear.app/mcpRead docs, update pages, manage tasksCommand
claude mcp add --transport http notion https://mcp.notion.com/mcpAsk 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/mcpManage 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/sseDatabases & Data Management
Read/write records, manage bases and tablesCommand
claude mcp add --transport stdio airtable --env AIRTABLE_API_KEY=YOUR_KEY -- npx -y airtable-mcp-serverSupplies high quality fundamental financial data sourced from SEC Filings, investor presentationsCommand
claude mcp add --transport http daloopa https://mcp.daloopa.com/server/mcpAccess 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/anthropicPayments & Commerce
Integrate PayPal commerce capabilities, payment processing, transaction managementCommand
claude mcp add --transport http paypal https://mcp.paypal.com/mcpAnalyze, troubleshoot, and optimize Plaid integrations. Banking data, financial account linkingCommand
claude mcp add --transport sse plaid https://api.dashboard.plaid.com/mcp/sseUse an agent to build on Square APIs. Payments, inventory, orders, and moreCommand
claude mcp add --transport sse square https://mcp.squareup.com/ssePayment processing, subscription management, and financial transactionsCommand
claude mcp add --transport http stripe https://mcp.stripe.comDesign & Media
Generate better code by bringing in full Figma contextVisit developers.figma.com for local server setup.Command
claude mcp add --transport http figma-remote-mcp https://mcp.figma.com/mcpUpload, 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/sseBrowse, summarize, autofill, and even generate new Canva designs directly from ClaudeCommand
claude mcp add --transport http canva https://mcp.canva.com/mcpInfrastructure & 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/mcpConfigure and manage Stytch authentication services, redirect URLs, email templates, and workspace settingsCommand
claude mcp add --transport http stytch http://mcp.stytch.dev/mcpVercel'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
Precisa de uma integração específica? Encontre centenas de servidores MCP no GitHub, ou crie o seu próprio usando o MCP SDK.
Instalando servidores MCP
Os servidores MCP podem ser configurados de três maneiras diferentes dependendo de suas necessidades:Opção 1: Adicionar um servidor HTTP remoto
Os servidores HTTP são a opção recomendada para conectar a servidores MCP remotos. Este é o transporte mais amplamente suportado para serviços baseados em nuvem.Opção 2: Adicionar um servidor SSE remoto
O transporte SSE (Server-Sent Events) está descontinuado. Use servidores HTTP em vez disso, quando disponível.
Opção 3: Adicionar um servidor stdio local
Os servidores Stdio são executados como processos locais em sua máquina. Eles são ideais para ferramentas que precisam de acesso direto ao sistema ou scripts personalizados.Entendendo o parâmetro ”—”:
O
-- (duplo travessão) separa os sinalizadores CLI do Claude dos comandos 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 --transport stdio myserver -- npx server→ executanpx serverclaude mcp add --transport stdio myserver --env KEY=value -- python server.py --port 8080→ executapython server.py --port 8080comKEY=valueno ambiente
Gerenciando seus servidores
Uma vez configurados, você pode gerenciar seus servidores MCP com estes comandos:Dicas:
- Use o sinalizador
--scopepara especificar onde a configuração é armazenada:local(padrão): Disponível apenas para você no projeto atual (era chamado deprojectem versões mais antigas)project: Compartilhado com todos no projeto via arquivo.mcp.jsonuser: Disponível para você em todos os projetos (era chamado deglobalem versões mais antigas)
- Defina variáveis de ambiente com sinalizadores
--env(por exemplo,--env KEY=value) - Configure o tempo limite de inicialização do servidor MCP usando a variável de ambiente MCP_TIMEOUT (por exemplo,
MCP_TIMEOUT=10000 claudedefine um tempo limite 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(por exemplo,MAX_MCP_OUTPUT_TOKENS=50000) - Use
/mcppara autenticar com servidores remotos que requerem autenticação OAuth 2.0
Usuários do Windows: No Windows nativo (não WSL), servidores MCP locais que usam Sem o wrapper
npx requerem o wrapper cmd /c para garantir a execução adequada.cmd /c, você encontrará erros “Connection closed” porque o Windows não pode executar npx diretamente. (Veja a nota acima para uma explicação do parâmetro --.)Servidores MCP fornecidos por plugins
Plugins podem agrupar servidores MCP, fornecendo automaticamente ferramentas e integrações quando o plugin está habilitado. Os servidores MCP de plugins funcionam de forma idêntica aos servidores configurados pelo usuário. Como funcionam os servidores MCP de plugins:- Plugins definem servidores MCP em
.mcp.jsonna raiz do plugin ou inline emplugin.json - Quando um plugin está habilitado, seus servidores MCP iniciam automaticamente
- As ferramentas MCP do plugin aparecem ao lado das ferramentas MCP configuradas manualmente
- Os servidores de plugins são gerenciados através da instalação de plugins (não comandos
/mcp)
.mcp.json na raiz do plugin:
plugin.json:
- Ciclo de vida automático: Os servidores iniciam quando o plugin é habilitado, mas você deve reiniciar Claude Code para aplicar alterações no servidor MCP (habilitação ou desabilitação)
- Variáveis de ambiente: Use
${CLAUDE_PLUGIN_ROOT}para caminhos relativos ao plugin - Acesso a variáveis de ambiente do usuário: Acesso às mesmas variáveis de ambiente que servidores configurados manualmente
- Múltiplos tipos de transporte: Suporte para transportes stdio, SSE e HTTP (o suporte de transporte pode variar por servidor)
- Distribuição agrupada: Ferramentas e servidores empacotados juntos
- Configuração automática: Nenhuma configuração MCP manual necessária
- Consistência da equipe: Todos recebem as mesmas ferramentas quando o plugin está instalado
Escopos de instalação MCP
Os servidores MCP podem ser configurados em três níveis de escopo diferentes, cada um servindo propósitos distintos para gerenciar a acessibilidade e o compartilhamento de servidores. Entender esses escopos ajuda você a determinar a melhor forma de configurar servidores para suas necessidades específicas.Escopo local
Os servidores com escopo local representam o nível de configuração padrão e são armazenados em suas configurações de usuário específicas do projeto. Esses servidores permanecem privados para você e são acessíveis apenas ao trabalhar no 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.Escopo do projeto
Os servidores com escopo de projeto permitem colaboração em equipe armazenando configurações em um arquivo.mcp.json no diretório raiz do seu projeto. Este arquivo foi projetado para ser verificado 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 cria ou atualiza automaticamente este arquivo com a estrutura de configuração apropriada.
.mcp.json resultante segue um formato padronizado:
.mcp.json. Se você precisar redefinir essas escolhas de aprovação, use o comando claude mcp reset-project-choices.
Escopo do usuário
Os servidores com escopo de usuário fornecem acessibilidade entre projetos, tornando-os disponíveis em todos os projetos em sua máquina enquanto permanecem privados para sua conta de usuário. Este escopo funciona bem para servidores de utilitários pessoais, ferramentas de desenvolvimento ou serviços que você usa frequentemente em diferentes projetos.Escolhendo o escopo correto
Selecione seu escopo com base em:- Escopo local: Servidores pessoais, configurações experimentais ou credenciais sensíveis específicas de um projeto
- Escopo do projeto: Servidores compartilhados em equipe, ferramentas específicas do projeto ou serviços necessários para colaboração
- Escopo do 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
As configurações do 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 primeiro servidores com escopo local, seguidos por servidores com escopo de projeto e, finalmente, servidores com escopo de usuário. Este design garante que configurações pessoais possam substituir 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 mantendo 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 ambienteVAR${VAR:-default}- Expande paraVARse definida, caso contrário usadefault
command- O caminho do executável do servidorargs- Argumentos de linha de comandoenv- Variáveis de ambiente passadas para o servidorurl- Para tipos de servidor HTTPheaders- Para autenticação de servidor HTTP
Exemplos práticos
Exemplo: Monitorar erros com Sentry
Exemplo: Conectar ao GitHub para revisões de código
Exemplo: Consultar seu banco de dados PostgreSQL
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
Adicione o servidor que requer autenticação
Por exemplo:
2
Use o comando /mcp dentro do Claude Code
No Claude Code, use o comando:Depois siga os passos no seu navegador para fazer login.
Dicas:
- Os tokens de autenticação são armazenados com segurança e atualizados automaticamente
- Use “Clear authentication” no menu
/mcppara revogar acesso - Se seu navegador não abrir automaticamente, copie a URL fornecida
- A autenticação OAuth funciona com servidores HTTP
Adicionar servidores MCP de configuração JSON
Se você tiver uma configuração JSON para um servidor MCP, pode adicioná-la diretamente:1
Adicione um servidor MCP de JSON
2
Verifique se o servidor foi adicionado
Dicas:
- Certifique-se de que o JSON está adequadamente escapado no seu shell
- O JSON deve estar em conformidade com o esquema de configuração do servidor MCP
- Você pode usar
--scope userpara 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, pode importá-los:1
Importar servidores do Claude Desktop
2
Selecione quais servidores importar
Após executar o comando, você verá um diálogo interativo que permite selecionar quais servidores deseja importar.
3
Verifique se os servidores foram importados
Dicas:
- Este recurso funciona apenas em macOS e Windows Subsystem for Linux (WSL)
- Ele lê o arquivo de configuração do Claude Desktop de seu local padrão nessas plataformas
- Use o sinalizador
--scope userpara adicionar servidores à sua configuração de usuário - Os 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 (por exemplo,
server_1)
Use Claude Code como um servidor MCP
Você pode usar Claude Code em si como um servidor MCP que outros aplicativos podem se conectar: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 muito mais.
- Observe que este servidor MCP está simplesmente expondo as ferramentas do Claude Code ao seu cliente MCP, portanto seu próprio cliente é responsável por implementar confirmação do usuário para chamadas de ferramentas individuais.
Limites de saída MCP e avisos
Quando as ferramentas MCP produzem grandes saídas, Claude Code ajuda a gerenciar o uso de tokens para evitar sobrecarregar seu contexto de 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 o máximo de tokens de saída MCP permitidos usando a variável de ambiente
MAX_MCP_OUTPUT_TOKENS - Limite padrão: O máximo padrão é 25.000 tokens
- Consultam grandes conjuntos de dados ou bancos de dados
- Geram relatórios ou documentação detalhados
- Processam arquivos de log extensos ou informações de depuração
Se você frequentemente encontrar 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
Os servidores MCP podem expor recursos que você pode referenciar usando menções @, semelhante a como você referencia arquivos.Referenciar recursos MCP
1
Listar recursos disponíveis
Digite
@ em seu prompt para ver recursos disponíveis de todos os servidores MCP conectados. Os recursos aparecem ao lado dos arquivos no menu de preenchimento automático.2
Referenciar um recurso específico
Use o formato
@server:protocol://resource/path para referenciar um recurso:3
Múltiplas referências de recursos
Você pode referenciar múltiplos recursos em um único prompt:
Dicas:
- Os recursos são automaticamente buscados e incluídos como anexos quando referenciados
- Os caminhos de recursos são pesquisáveis por correspondência aproximada no preenchimento automático de menção @
- Claude Code fornece automaticamente ferramentas para listar e ler recursos MCP quando os servidores os suportam
- Os recursos podem conter qualquer tipo de conteúdo que o servidor MCP fornece (texto, JSON, dados estruturados, etc.)
Usar prompts MCP como comandos de barra
Os servidores MCP podem expor prompts que se tornam disponíveis como comandos de barra no Claude Code.Executar prompts MCP
1
Descobrir prompts disponíveis
Digite
/ para ver todos os comandos disponíveis, incluindo os de servidores MCP. Os prompts MCP aparecem com o formato /mcp__servername__promptname.2
Executar um prompt sem argumentos
3
Executar um prompt com argumentos
Muitos prompts aceitam argumentos. Passe-os separados por espaço após o comando:
Dicas:
- Os prompts MCP são descobertos dinamicamente de servidores conectados
- Os argumentos são analisados com base nos parâmetros definidos do prompt
- Os resultados do prompt são injetados diretamente na conversa
- Os nomes de servidor e prompt são normalizados (espaços se tornam sublinhados)
Configuração MCP corporativa
Para organizações que precisam de controle centralizado sobre servidores MCP, Claude Code suporta configurações MCP gerenciadas pela empresa. Isso permite que administradores de TI:- Controlar quais servidores MCP os funcionários podem acessar: Implante um conjunto padronizado de servidores MCP aprovados em toda a organização
- Prevenir servidores MCP não autorizados: Opcionalmente restrinja usuários de adicionar seus próprios servidores MCP
- Desabilitar MCP completamente: Remova a funcionalidade MCP completamente se necessário
Configurando a configuração MCP corporativa
Administradores de sistema podem implantar um arquivo de configuração MCP corporativa ao lado do arquivo de configurações gerenciadas:- macOS:
/Library/Application Support/ClaudeCode/managed-mcp.json - Windows:
C:\ProgramData\ClaudeCode\managed-mcp.json - Linux:
/etc/claude-code/managed-mcp.json
managed-mcp.json usa o mesmo formato que um arquivo .mcp.json padrão:
Restringindo servidores MCP com listas de permissão e bloqueio
Além de fornecer servidores gerenciados pela empresa, administradores podem controlar quais servidores MCP os usuários podem configurar usandoallowedMcpServers e deniedMcpServers no arquivo managed-settings.json:
- macOS:
/Library/Application Support/ClaudeCode/managed-settings.json - Windows:
C:\ProgramData\ClaudeCode\managed-settings.json - Linux:
/etc/claude-code/managed-settings.json
allowedMcpServers):
undefined(padrão): Sem restrições - os usuários podem configurar qualquer servidor MCP- Array vazio
[]: Bloqueio completo - os usuários não podem configurar nenhum servidor MCP - Lista de nomes de servidores: Os usuários podem configurar apenas os servidores especificados
deniedMcpServers):
undefined(padrão): Nenhum servidor é bloqueado- Array vazio
[]: Nenhum servidor é bloqueado - Lista de nomes de servidores: Os servidores especificados são explicitamente bloqueados em todos os escopos
- Essas restrições se aplicam a todos os escopos: usuário, projeto, local e até servidores corporativos de
managed-mcp.json - A lista de bloqueio tem precedência absoluta: Se um servidor aparecer em ambas as listas, será bloqueado
Precedência de configuração corporativa: A configuração MCP corporativa tem a precedência mais alta e não pode ser substituída por configurações de usuário, local ou projeto quando
useEnterpriseMcpConfigOnly está habilitado.