🔌 MCP: Model Context Protocol

Model Context Protocol (MCP) e um protocolo aberto que permite conectar LLMs a fontes de dados externas de forma padronizada. Com MCP, Claude pode consultar bancos de dados, chamar APIs, acessar documentacao e muito mais.

┌─────────────────┐     ┌─────────────────┐     ┌─────────────────┐
│   Claude Code   │ ←→  │   MCP Server    │ ←→  │   Data Source   │
│   (Cliente)     │     │   (Bridge)      │     │   (DB, API...)  │
└─────────────────┘     └─────────────────┘     └─────────────────┘

A forma recomendada de configurar MCP e via CLI. A configuracao e armazenada em locais diferentes dependendo do escopo.

# Adicionar servidor HTTP remoto
claude mcp add --transport http github https://api.githubcopilot.com/mcp/

# Adicionar servidor stdio local
claude mcp add --transport stdio db -- npx -y @bytebase/dbhub \
  --dsn "postgresql://user:pass@localhost:5432/mydb"

# Listar servidores configurados
claude mcp list

# Remover servidor
claude mcp remove github

# Ver status dentro do Claude Code
/mcp

{
  "mcpServers": {
    "sentry": {
      "type": "http",
      "url": "https://mcp.sentry.dev/mcp"
    },
    "db-local": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@bytebase/dbhub", "--dsn", "${DATABASE_URL}"],
      "env": {
        "DATABASE_URL": "${DATABASE_URL}"
      }
    }
  }
}

O servidor MCP para PostgreSQL permite que Claude execute queries SQL diretamente no seu banco de dados. Ideal para analise de dados, debugging e geracao de relatorios.

claude mcp add --transport stdio db -- npx -y @bytebase/dbhub \
  --dsn "postgresql://readonly:pass@localhost:5432/analytics"

{
  "mcpServers": {
    "db": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@bytebase/dbhub", "--dsn", "${DATABASE_URL}"],
      "env": {
        "DATABASE_URL": "${DATABASE_URL}"
      }
    }
  }
}

Conecte Claude ao GitHub para gerenciar issues, analisar PRs e interagir com repositorios sem sair do terminal.

# GitHub usa servidor HTTP remoto com OAuth
claude mcp add --transport http github https://api.githubcopilot.com/mcp/

# Depois, autentique dentro do Claude Code:
/mcp
# Selecione "Authenticate" para GitHub

Voce pode criar servidores MCP customizados para conectar Claude a qualquer fonte de dados da sua empresa.

import { Server } from "@modelcontextprotocol/sdk/server";
import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio";

const server = new Server({
  name: "meu-servidor-mcp",
  version: "1.0.0"
});

// Definir tools disponiveis
server.setRequestHandler("tools/list", async () => ({
  tools: [{
    name: "buscar_cliente",
    description: "Busca dados de um cliente pelo ID",
    inputSchema: {
      type: "object",
      properties: {
        clienteId: { type: "string" }
      },
      required: ["clienteId"]
    }
  }]
}));

// Implementar a tool
server.setRequestHandler("tools/call", async (request) => {
  if (request.params.name === "buscar_cliente") {
    const cliente = await minhaAPI.getCliente(request.params.arguments.clienteId);
    return { content: [{ type: "text", text: JSON.stringify(cliente) }] };
  }
});

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

MCP da a Claude acesso a dados sensiveis. Seguranca e fundamental para evitar vazamentos e acessos indevidos.