Configuração do Servidor MCP no Claude Code e Casos de Uso Práticos

O Que É MCP?

MCP (Model Context Protocol) é um protocolo aberto para conectar assistentes de IA a ferramentas externas e fontes de dados. O Claude Code atua como um cliente MCP, permitindo que ele interaja com bancos de dados, APIs e diversos serviços por meio de servidores MCP.

Configurando Servidores MCP

As configurações de servidores MCP ficam em .claude/settings.json ou ~/.claude/settings.json:

{
  "mcpServers": {
    "server-name": {
      "command": "comando-executável",
      "args": ["arg1", "arg2"],
      "env": {
        "ENV_VAR": "valor"
      }
    }
  }
}

Você também pode adicionar servidores via CLI:

claude mcp add server-name -- command arg1 arg2

Exemplo 1: Integração com Banco de Dados

Configure um servidor MCP para executar queries diretamente no PostgreSQL:

claude mcp add postgres-server -- npx -y @modelcontextprotocol/server-postgres postgresql://user:pass@localhost:5432/mydb

Uma vez configurado, você pode consultar seu banco de dados de dentro de uma sessão do Claude Code:

> Conte os novos registros de usuários da última semana na tabela users
> Mostre a tendência diária em formato de tabela

O Claude Code gera e executa automaticamente as queries SQL e formata os resultados para você.

Exemplo 2: Integração com GitHub

O servidor MCP do GitHub permite gerenciar issues e PRs diretamente do Claude Code:

claude mcp add github -- npx -y @modelcontextprotocol/server-github

Configure o token via variáveis de ambiente:

{
  "mcpServers": {
    "github": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-github"],
      "env": {
        "GITHUB_PERSONAL_ACCESS_TOKEN": "ghp_xxxxxxxxxxxx"
      }
    }
  }
}

Veja o que você pode fazer:

> Liste todas as issues abertas no repositório
> Analise a Issue #42, crie um branch de correção e implemente a solução
> Quando a correção estiver pronta, crie um PR

Exemplo 3: Extensão do Sistema de Arquivos

Um servidor MCP que fornece acesso seguro a um diretório específico:

claude mcp add filesystem -- npx -y @modelcontextprotocol/server-filesystem /caminho/para/diretorio/permitido

Exemplo 4: Web Scraping

O servidor MCP do Puppeteer permite buscar e interagir com páginas web:

claude mcp add puppeteer -- npx -y @modelcontextprotocol/server-puppeteer

> Leia a documentação da API em https://example.com/api/docs
> e crie uma biblioteca cliente para essa API

Exemplo 5: Integração com Slack

O servidor MCP do Slack permite ler mensagens de canais e enviar notificações:

{
  "mcpServers": {
    "slack": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-slack"],
      "env": {
        "SLACK_BOT_TOKEN": "xoxb-xxxxxxxxxxxx"
      }
    }
  }
}

> Verifique as últimas mensagens em #dev
> Publique a atualização de progresso de hoje em #daily-report

Gerenciando Servidores MCP

Listar Servidores Registrados

claude mcp list

Remover um Servidor

claude mcp remove server-name

Definindo o Escopo

Você pode especificar o escopo de configuração dos servidores MCP:

# Local do projeto (padrão)
claude mcp add --scope project db-server -- command

# Global do usuário
claude mcp add --scope user db-server -- command

Criando um Servidor MCP Personalizado

Você também pode criar ferramentas específicas do projeto como servidores MCP personalizados:

// my-mcp-server.ts
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: "my-project-tools",
  version: "1.0.0",
});

// Definir uma ferramenta personalizada
server.tool(
  "deploy-staging",
  "Deploy para o ambiente de staging",
  { branch: z.string().describe("Nome do branch para deploy") },
  async ({ branch }) => {
    // Lógica de deployment
    return {
      content: [{ type: "text", text: `${branch} foi deployado em staging` }],
    };
  }
);

const transport = new StdioServerTransport();
await server.connect(transport);

Registre-o assim:

claude mcp add my-tools -- npx tsx my-mcp-server.ts

Considerações de Segurança

1. Gerenciamento de Credenciais

Tokens e senhas nas configurações de servidores MCP devem ser gerenciados por meio de variáveis de ambiente ou arquivos .env. Nunca faça commit deles no Git.

2. Limitar o Escopo de Acesso

Siga o princípio do menor privilégio — por exemplo, use um usuário de banco de dados somente-leitura para o seu servidor MCP de banco de dados.

3. Usar Configurações Locais

Armazene configurações contendo credenciais em .claude/settings.local.json e adicione ao .gitignore.

Conclusão

Os servidores MCP permitem expandir as capacidades do Claude Code por todo o ecossistema do seu projeto. De queries em bancos de dados a workflows do GitHub e notificações no Slack, você pode usar o Claude Code como hub central do seu fluxo de trabalho de desenvolvimento. Comece com os servidores MCP oficiais e depois crie os seus próprios conforme a necessidade.