Adicione seu primeiro MCP server
Um comando para conectar o Claude Code ao GitHub, bancos de dados e muito mais
⏱ Estim. ~6 min
01 · Ler
Adicionar um MCP server ao Claude Code é um único comando. Você usa claude mcp add seguido do nome e de uma URL (HTTP) ou comando (stdio).
Depois de adicionado, o Claude consegue usar todas as ferramentas expostas por esse server — automaticamente. Nada de mudar código, nada de arquivos de configuração, nada de reiniciar. Adicionou, já pode pedir ao Claude para usar.
Pontos-chave
- claude mcp add é o comando principal para adicionar servers
- Servers HTTP precisam de um nome e uma URL
- Servers stdio precisam de um nome e do comando para rodar
- Opções como --transport, --env e --scope vêm antes do nome do server
02 · Exemplo de código
Veja abaixo como adicionar um server HTTP remoto — o tipo mais comum. Este exemplo conecta o Claude ao GitHub.
Adicionar o MCP server do GitHub
claude mcp add --transport http github https://api.githubcopilot.com/mcp/
Adicionar o MCP server do Notion
claude mcp add --transport http notion https://mcp.notion.com/mcp
Adicionar header de autenticação
claude mcp add --transport http secure-api https://api.example.com/mcp \
--header "Authorization: Bearer your-token"
O padrão é sempre o mesmo: claude mcp add --transport http <name> <url>. O name é como você vai se referir a esse server depois. A URL é onde o MCP server vive. Quando o server precisa de token, use --header para adicionar o header de autenticação.
03 · Exemplo de código
Servers stdio rodam processos locais. Este exemplo usa o pacote dbhub para conectar o Claude a um banco PostgreSQL.
Adicionar server PostgreSQL
claude mcp add --transport stdio db \
-- npx -y @bytebase/dbhub \
--dsn "postgresql://readonly:pass@localhost:5432/mydb"
Adicionar com variável de ambiente
claude mcp add --transport stdio airtable \
--env AIRTABLE_API_KEY=YOUR_KEY \
-- npx -y airtable-mcp-server
O -- (dois traços) separa as opções do Claude do comando e dos argumentos do server. Tudo depois do -- é o comando que roda o MCP server. Use --env para passar API keys como variáveis de ambiente com segurança, sem deixar valores fixos no código.
04 · Passo a passo
1. Escolha o server
Decida qual MCP server você quer adicionar. Para um server HTTP, você precisa da URL. Para um server stdio, do nome do pacote npm ou do comando. Consulte a lista oficial de MCP servers ou a documentação do seu serviço.
2. Rode claude mcp add
Para servers remotos, use claude mcp add --transport http <name> <url>; para locais, claude mcp add --transport stdio <name> -- <command>. Lembre: todas as opções antes do name, e o -- separa o comando do server.
3. Confirme a conexão
Rode claude mcp list para ver todos os servers configurados, ou use /mcp dentro do Claude Code para ver status e autenticação. Status verde significa que o server está conectado e pronto.
4. Peça ao Claude para usar
Inicie uma conversa no Claude Code e faça perguntas que precisam daquele server. GitHub: "Mostre meus PRs abertos." Banco de dados: "Quais tabelas existem?" O Claude descobre as ferramentas do server automaticamente.
05 · Quiz
Você quer adicionar um server local de banco de dados que precisa da variável de ambiente DATABASE_URL. A ordem das flags importa. Qual comando está correto?
- claude mcp add --transport stdio --env DATABASE_URL=... db -- npx dbhub
- claude mcp add db --transport stdio --env DATABASE_URL=... -- npx dbhub
- claude mcp add --transport stdio db -- npx dbhub --env DATABASE_URL=...
- claude mcp add -- npx dbhub --transport stdio db
06 · Preencher
Para listar todos os MCP servers que você configurou, rode claude mcp _____
Outras lições deste capítulo
⚠ A experiência interativa completa precisa de JavaScript. Ative-o e recarregue a página.
※ Este é um projeto educacional independente — não é um produto oficial da Anthropic. Claude™ é uma marca registrada da Anthropic, PBC.