MCP Servers no Claude Code: O que Sao e Como Usar (Guia 2026)

Voce esta usando o Claude Code para escrever codigo, mas toda vez que precisa consultar o banco de dados, verificar um pagamento no Stripe ou checar um pull request no GitHub, precisa sair do Claude Code, abrir outra ferramenta, copiar os dados e voltar. Isso quebra o fluxo de trabalho e consome tempo.

O MCP (Model Context Protocol) resolve exatamente esse problema. Ele permite que o Claude Code se conecte diretamente a ferramentas e servicos externos, sem voce precisar sair do terminal. O Claude Code consulta o banco, processa pagamentos, lê repositorios -- tudo dentro da mesma sessao.

Neste guia, voce vai entender o que e MCP, como configurar, quais servers estao disponiveis e como usar na pratica com Supabase, Stripe, GitHub e outros servicos.

1. O que e MCP (Model Context Protocol)

MCP e um protocolo aberto criado pela Anthropic que padroniza como modelos de IA se conectam a ferramentas e fontes de dados externas. Pense nele como um USB-C para IA: uma interface universal que permite ao Claude Code "plugar" em qualquer servico que implemente o protocolo.

Antes do MCP, integrar o Claude Code com ferramentas externas exigia workarounds: rodar comandos CLI, parsear outputs, copiar dados manualmente. Com MCP, a integracao e nativa. O Claude Code sabe quais ferramentas estao disponiveis, quais parametros cada uma aceita e como interpretar os resultados.

A analogia mais simples

Imagine que o Claude Code e um profissional sentado em uma mesa de trabalho. Sem MCP, ele so tem acesso aos arquivos na mesa (seu projeto local). Com MCP, ele ganha um telefone com linha direta para o banco de dados, o sistema de pagamento, o repositorio de codigo e qualquer outro departamento. Ele liga, pede informacao, recebe e continua trabalhando -- sem levantar da mesa.

Componentes do protocolo

O MCP funciona com tres componentes principais:

• MCP Client: o Claude Code. Ele envia requests para os servidores e processa as respostas
• MCP Server: um processo que expoe ferramentas (tools) de um servico especifico. Exemplo: o MCP server do Supabase expoe tools para consultar tabelas, executar SQL, listar migrations
• Transport: o canal de comunicacao entre cliente e servidor. Pode ser stdio (processo local) ou HTTP (servidor remoto)

2. Como MCP funciona na arquitetura do Claude Code

Quando voce configura um MCP server no Claude Code, o seguinte acontece:

1. Inicializacao: ao iniciar o Claude Code, ele le o arquivo .mcp.json e inicia os processos dos MCP servers configurados
2. Discovery: o Claude Code pergunta a cada server quais tools ele oferece. O server responde com uma lista de funcoes, parametros e descricoes
3. Disponibilidade: as tools ficam disponiveis para o Claude Code usar durante a sessao, como se fossem funcoes nativas
4. Execucao: quando o Claude Code decide que precisa de uma tool (por exemplo, consultar o banco), ele envia um request ao MCP server, que executa a acao e retorna o resultado

O ponto importante: voce nao precisa dizer ao Claude Code "use o MCP do Supabase". Ele identifica automaticamente que precisa de dados do banco e usa a tool adequada. A experiencia e transparente.

3. MCP servers vs skills: qual a diferenca

Essa e uma duvida comum. Ambos ampliam as capacidades do Claude Code, mas de formas fundamentalmente diferentes:

Aspecto	MCP Servers	Skills
O que fornecem	Tools (acoes executaveis em servicos externos)	Conhecimento e instrucoes especializadas
Analogia	Ferramentas na bancada (martelo, chave, furadeira)	Manual do especialista (como usar cada ferramenta)
Exemplo	Executar SQL no Supabase, criar charge no Stripe	Saber como estruturar queries otimizadas, como modelar dados
Configuracao	Arquivo .mcp.json	Arquivos .md em .claude/commands/
Requer credenciais	Sim (API keys, tokens)	Nao
Executa acoes externas	Sim	Nao (apenas instrui o Claude)

Na pratica, skills e MCP servers sao complementares. Uma skill de "database architect" ensina o Claude Code as melhores praticas de modelagem de dados. O MCP server do Supabase permite que ele execute essas queries diretamente no banco. Juntos, voce tem um Claude Code que sabe o que fazer e tem acesso para fazer.

4. Configurando .mcp.json passo a passo

A configuracao de MCP servers e feita no arquivo .mcp.json. Voce pode configura-lo em dois escopos:

• Projeto: .mcp.json na raiz do projeto (versionado no git, compartilhado com a equipe)
• Global: ~/.claude/.mcp.json (disponivel em todos os projetos)

Estrutura basica do arquivo

{
  "mcpServers": {
    "nome-do-server": {
      "command": "comando-para-iniciar",
      "args": ["argumento1", "argumento2"],
      "env": {
        "VARIAVEL": "valor"
      }
    }
  }
}

Exemplo completo com Supabase

{
  "mcpServers": {
    "supabase": {
      "command": "npx",
      "args": ["-y", "@supabase/mcp-server"],
      "env": {
        "SUPABASE_ACCESS_TOKEN": "sbp_seu_token_aqui",
        "SUPABASE_PROJECT_REF": "abcdefghijk"
      }
    }
  }
}

Exemplo com multiplos servers

{
  "mcpServers": {
    "supabase": {
      "command": "npx",
      "args": ["-y", "@supabase/mcp-server"],
      "env": {
        "SUPABASE_ACCESS_TOKEN": "sbp_seu_token",
        "SUPABASE_PROJECT_REF": "seu_project_ref"
      }
    },
    "github": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-github"],
      "env": {
        "GITHUB_PERSONAL_ACCESS_TOKEN": "ghp_seu_token"
      }
    },
    "stripe": {
      "command": "npx",
      "args": ["-y", "@stripe/mcp-server"],
      "env": {
        "STRIPE_SECRET_KEY": "sk_live_seu_token"
      }
    }
  }
}

Apos salvar o arquivo, reinicie o Claude Code. Ele vai inicializar os servers automaticamente e voce vera as tools disponiveis.

Verificando se os servers estao ativos

5. 7 MCP servers mais usados em 2026

O ecossistema MCP cresceu rapidamente. Estes sao os servers mais utilizados pela comunidade:

Server	O que faz	Pacote npm
Supabase	SQL, tabelas, migrations, edge functions, auth	@supabase/mcp-server
GitHub	Issues, PRs, repos, actions, code search	@modelcontextprotocol/server-github
Stripe	Customers, charges, subscriptions, invoices	@stripe/mcp-server
Slack	Mensagens, canais, threads, busca	@modelcontextprotocol/server-slack
Filesystem	Acesso ampliado a arquivos fora do projeto	@modelcontextprotocol/server-filesystem
PostgreSQL	Conexao direta a qualquer banco PostgreSQL	@modelcontextprotocol/server-postgres
Brave Search	Busca na web em tempo real	@modelcontextprotocol/server-brave-search

Alem desses, existem MCP servers para Notion, Linear, Jira, Google Drive, AWS e dezenas de outros servicos. O repositorio oficial da Anthropic lista todos os servers verificados.

6. Exemplos praticos: Supabase, Stripe e GitHub

Exemplo 1: Supabase — consultar dados e criar migrations

Exemplo 2: Stripe — verificar pagamentos e criar produtos

Exemplo 3: GitHub — gerenciar issues e PRs

7. Como criar seu proprio MCP server

Se voce tem uma API interna ou um servico que nao tem MCP server oficial, voce pode criar o seu. O SDK esta disponivel em TypeScript e Python.

Estrutura basica em TypeScript

import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
import { z } from "zod";

const server = new McpServer({
  name: "meu-servico",
  version: "1.0.0",
});

// Registrar uma tool
server.tool(
  "buscar_cliente",
  "Busca um cliente pelo email",
  { email: z.string().email() },
  async ({ email }) => {
    const cliente = await fetch(
      `https://api.meuservico.com/clientes?email=${email}`,
      { headers: { Authorization: `Bearer ${process.env.API_KEY}` } }
    ).then(r => r.json());

    return {
      content: [{
        type: "text",
        text: JSON.stringify(cliente, null, 2)
      }]
    };
  }
);

// Iniciar o servidor
const transport = new StdioServerTransport();
await server.connect(transport);

Estrutura basica em Python

from mcp.server.fastmcp import FastMCP
import httpx

mcp = FastMCP("meu-servico")

@mcp.tool()
async def buscar_cliente(email: str) -> str:
    """Busca um cliente pelo email no sistema."""
    async with httpx.AsyncClient() as client:
        resp = await client.get(
            f"https://api.meuservico.com/clientes",
            params={"email": email},
            headers={"Authorization": f"Bearer {os.environ['API_KEY']}"}
        )
        return resp.text

mcp.run()

Depois de criar o server, configure no .mcp.json:

{
  "mcpServers": {
    "meu-servico": {
      "command": "node",
      "args": ["./mcp-servers/meu-servico/index.js"],
      "env": {
        "API_KEY": "sua_api_key"
      }
    }
  }
}

8. Boas praticas e seguranca

Seguranca de credenciais

• Nunca commite credenciais no git. Use variaveis de ambiente ou um arquivo .env local referenciado no .mcp.json
• Use tokens com permissoes minimas. O MCP server do Supabase nao precisa de um token com permissao de deletar projetos. Crie tokens com escopo limitado
• Rotacione tokens periodicamente. Especialmente em ambientes de producao
• Adicione .mcp.json ao .gitignore se ele contiver tokens diretamente (em vez de variaveis de ambiente)

Performance

• Configure apenas os servers que voce precisa. Cada server consome recursos. Se voce nao usa Slack, nao configure o MCP do Slack
• Use escopo de projeto. MCP servers globais iniciam em todos os projetos. Prefira configuracao por projeto quando possivel
• Monitore o consumo de tokens. Cada chamada MCP adiciona contexto a conversa. Queries SQL que retornam 10.000 linhas vao consumir muitos tokens

Organizacao

• Documente seus MCP servers. Se voce criou um server customizado, inclua um README no diretorio explicando o que ele faz e como configurar
• Use nomes descritivos. "db-producao" e melhor que "server1"
• Separe ambientes. Tenha configuracoes diferentes para desenvolvimento e producao