Guia Completo de MCPs para Claude CLI — InfoWhere

Model Context Protocol - Integração de ferramentas com Claude
Última atualização: 25/01/2026
Uso: Claude Code CLI

1. O que é MCP?

MCP (Model Context Protocol) é um protocolo que permite integrar ferramentas externas ao Claude, expandindo suas capacidades. Com MCPs, Claude pode:

• Acessar sistemas de arquivos
• Executar operações Git
• Consultar bases de dados
• Buscar documentação de bibliotecas
• Fazer web scraping
• Gerar diagramas
• E muito mais

2. Comandos Essenciais do Claude CLI para MCPs

# Listar MCPs instalados
claude mcp list

# Adicionar um MCP
claude mcp add <nome> -- <comando>

# Remover um MCP
claude mcp remove <nome>

# Ver detalhes de um MCP
claude mcp get <nome>

3. MCPs por Categoria

3.1 Core / Essenciais

Filesystem — Acesso a arquivos locais

# Instalação
claude mcp add filesystem -- npx -y @modelcontextprotocol/server-filesystem /caminho/permitido

# Exemplo com múltiplos diretórios
claude mcp add filesystem -- npx -y @modelcontextprotocol/server-filesystem /Users/leandro/projetos /Users/leandro/docs

Ferramentas disponíveis:

• read_file — Ler conteúdo de arquivo
• write_file — Escrever em arquivo
• list_directory — Listar diretório
• create_directory — Criar diretório
• move_file — Mover/renomear arquivo
• search_files — Buscar arquivos por padrão
• get_file_info — Metadados do arquivo

Quando usar: Sempre que precisar de acesso controlado a arquivos fora do diretório atual.

Git — Operações Git

# Instalação
claude mcp add git -- npx -y @modelcontextprotocol/server-git

Ferramentas disponíveis:

• git_status — Ver status do repositório
• git_diff — Ver diferenças
• git_log — Ver histórico de commits
• git_commit — Criar commit
• git_branch — Gerenciar branches
• git_checkout — Trocar de branch
• git_show — Ver detalhes de commit

Quando usar: Operações Git complexas ou quando precisar de contexto detalhado do repositório.

GitHub — Issues, PRs e Actions

# Instalação (requer GITHUB_TOKEN)
export GITHUB_TOKEN=ghp_seu_token_aqui
claude mcp add github -- npx -y @modelcontextprotocol/server-github

Ferramentas disponíveis:

• create_issue — Criar issue
• list_issues — Listar issues
• create_pull_request — Criar PR
• list_pull_requests — Listar PRs
• get_pull_request — Detalhes de PR
• merge_pull_request — Merge de PR
• create_repository — Criar repositório
• fork_repository — Fork de repositório
• search_repositories — Buscar repositórios
• search_code — Buscar código

Quando usar: Automação de workflows GitHub, gestão de issues e PRs.

Fetch — Buscar conteúdo web

# Instalação
claude mcp add fetch -- npx -y @modelcontextprotocol/server-fetch

Ferramentas disponíveis:

• fetch — Buscar URL e retornar conteúdo como markdown

Quando usar: Buscar documentação, APIs públicas, páginas web.

3.2 Documentação & Pesquisa

Context7 — Documentação de bibliotecas em tempo real ⭐ RECOMENDADO

# Instalação
claude mcp add context7 -- npx -y @upstash/context7-mcp

Ferramentas disponíveis:

• resolve-library-id — Encontrar ID da biblioteca no Context7
• get-library-docs — Obter documentação da biblioteca

Como usar:

# Primeiro, resolver o ID da biblioteca
Use resolve-library-id para encontrar "spring boot"

# Depois, buscar a documentação
Use get-library-docs com o ID encontrado

Bibliotecas suportadas: React, Vue, Angular, Spring Boot, FastAPI, Express, Django, Next.js, Astro, Tailwind, e centenas de outras.

Quando usar: Sempre que precisar de documentação atualizada de bibliotecas. É o MCP mais importante para desenvolvimento.

Firecrawl — Web scraping avançado

# Instalação (requer API key)
export FIRECRAWL_API_KEY=fc-sua_api_key
claude mcp add firecrawl -- npx -y firecrawl-mcp

Ferramentas disponíveis:

• firecrawl_scrape — Extrair conteúdo de uma URL
• firecrawl_map — Mapear estrutura de um site
• firecrawl_crawl — Crawl completo de site
• firecrawl_search — Buscar na web e extrair resultados

Quando usar: Quando Context7 não tiver a documentação, ou para extrair conteúdo de sites específicos.

Brave Search — Pesquisa na web

# Instalação (requer API key)
export BRAVE_API_KEY=sua_api_key
claude mcp add brave -- npx -y @anthropic/mcp-server-brave-search

Ferramentas disponíveis:

• brave_web_search — Pesquisa na web
• brave_local_search — Pesquisa local (negócios, lugares)

Quando usar: Pesquisas gerais na web, encontrar recursos e tutoriais.

3.3 Raciocínio & Memória

Sequential Thinking — Raciocínio estruturado

# Instalação
claude mcp add thinking -- npx -y @modelcontextprotocol/server-sequential-thinking

Ferramentas disponíveis:

• sequential_thinking — Raciocínio passo-a-passo estruturado

Quando usar: Problemas complexos que requerem análise detalhada, debugging, arquitetura.

Memory — Knowledge graph persistente

# Instalação
claude mcp add memory -- npx -y @modelcontextprotocol/server-memory

Ferramentas disponíveis:

• create_entities — Criar entidades no grafo
• create_relations — Criar relações entre entidades
• search_nodes — Buscar no grafo
• open_nodes — Abrir nós específicos
• delete_entities — Remover entidades
• delete_relations — Remover relações

Quando usar: Manter contexto entre sessões, projetos de longo prazo.

3.4 Bases de Dados

PostgreSQL (Read-Only)

# Instalação
claude mcp add postgres -- npx -y @modelcontextprotocol/server-postgres postgresql://user:pass@host:5432/db

Ferramentas disponíveis:

• query — Executar SELECT queries

Quando usar: Consultas de leitura em PostgreSQL.

PostgreSQL Full Access

# Instalação
claude mcp add postgres-full -- npx -y mcp-postgres-full-access postgresql://user:pass@host:5432/db

Ferramentas disponíveis:

• query — SELECT queries
• execute — INSERT, UPDATE, DELETE
• transaction — Transações

Quando usar: Operações completas em PostgreSQL (cuidado em produção!).

DBHub — Universal (PostgreSQL, MySQL, MSSQL, MariaDB)

# Instalação para PostgreSQL
claude mcp add dbhub -- npx -y @bytebase/dbhub --dsn "postgresql://user:pass@host:5432/db"

# Instalação para MySQL
claude mcp add dbhub -- npx -y @bytebase/dbhub --dsn "mysql://user:pass@host:3306/db"

Ferramentas disponíveis:

• run_query — Executar queries
• list_tables — Listar tabelas
• describe_table — Descrever estrutura

Quando usar: Quando precisar suportar múltiplos tipos de banco.

SQLite

# Instalação
claude mcp add sqlite -- npx -y @anthropic/mcp-server-sqlite /caminho/para/banco.db

Ferramentas disponíveis:

• read_query — SELECT
• write_query — INSERT, UPDATE, DELETE
• create_table — Criar tabela
• list_tables — Listar tabelas
• describe_table — Descrever tabela

MongoDB

# Instalação
claude mcp add mongodb -- npx -y mcp-mongo-server mongodb://localhost:27017

Ferramentas disponíveis:

• find — Buscar documentos
• insertOne / insertMany — Inserir
• updateOne / updateMany — Atualizar
• deleteOne / deleteMany — Remover
• aggregate — Aggregation pipeline
• listCollections — Listar collections

3.5 Diagramas & Visualização

Excalidraw — Diagramas de fluxo e wireframes

# Instalação
claude mcp add excalidraw -- npx -y @cmd8/excalidraw-mcp

# Com diretório específico
claude mcp add excalidraw -- npx -y @cmd8/excalidraw-mcp --diagram ./docs/diagrams

Ferramentas disponíveis:

• create_excalidraw — Criar novo diagrama
• modify_excalidraw — Modificar diagrama existente
• export_excalidraw — Exportar para PNG/SVG

Quando usar: Criar diagramas de arquitetura, fluxos, wireframes.

Mermaid Diagrams

# Instalação
claude mcp add mermaid -- npx -y @mermaidchart/mcp-server

Ferramentas disponíveis:

• render_diagram — Renderizar diagrama Mermaid
• get_diagram_types — Listar tipos suportados

Tipos suportados: Flowchart, Sequence, Class, State, ER, Gantt, Pie, etc.

Quando usar: Diagramas em formato texto (C4, sequence, class diagrams).

Mindmap

# Instalação (requer uv/uvx)
claude mcp add mindmap -- uvx mindmap-mcp-server --return-type filePath

Ferramentas disponíveis:

• create_mindmap — Criar mindmap interativo

Quando usar: Brainstorming, organização de ideias.

3.6 Containers & Kubernetes

Docker

# Instalação
claude mcp add docker -- npx -y @quantgeekdev/docker-mcp

Ferramentas disponíveis:

• list_containers — Listar containers
• create_container — Criar container
• start_container / stop_container — Iniciar/parar
• remove_container — Remover
• list_images — Listar imagens
• pull_image — Baixar imagem
• build_image — Build de imagem
• container_logs — Ver logs
• list_volumes — Listar volumes
• list_networks — Listar redes

Quando usar: Gestão de containers Docker.

Kubernetes

# Instalação
claude mcp add k8s -- npx -y mcp-server-kubernetes

Ferramentas disponíveis:

• list_pods — Listar pods
• get_pod — Detalhes de pod
• list_deployments — Listar deployments
• scale_deployment — Escalar deployment
• list_services — Listar services
• get_logs — Ver logs de pod
• apply_manifest — Aplicar YAML
• delete_resource — Remover recurso

Quando usar: Gestão de clusters Kubernetes.

3.7 Browser & Automação

Playwright (Microsoft) — Automação oficial

# Instalação
claude mcp add playwright -- npx -y @playwright/mcp@latest

Ferramentas disponíveis:

• browser_navigate — Navegar para URL
• browser_screenshot — Capturar screenshot
• browser_click — Clicar em elemento
• browser_type — Digitar texto
• browser_select — Selecionar opção
• browser_wait — Aguardar elemento
• browser_evaluate — Executar JavaScript

Quando usar: Testes E2E, automação de browser, scraping interativo.

Puppeteer

# Instalação
claude mcp add puppeteer -- npx -y @anthropic/mcp-server-puppeteer

Ferramentas disponíveis:

• Similar ao Playwright

Quando usar: Alternativa ao Playwright, especialmente para Chrome.

3.8 Cloud & IaC

AWS

# Instalação (requer credenciais AWS configuradas)
claude mcp add aws -- npx -y @anthropic/mcp-server-aws

Ferramentas disponíveis:

• Operações em S3, EC2, Lambda, DynamoDB, etc.

Terraform

# Instalação
claude mcp add terraform -- npx -y mcp-terraform-server

Ferramentas disponíveis:

• terraform_init — Inicializar
• terraform_plan — Planejar
• terraform_apply — Aplicar
• terraform_destroy — Destruir
• terraform_output — Ver outputs

3.9 Comunicação & Notificações

Slack

# Instalação (requer SLACK_TOKEN)
export SLACK_TOKEN=xoxb-seu-token
claude mcp add slack -- npx -y @anthropic/mcp-server-slack

Ferramentas disponíveis:

• send_message — Enviar mensagem
• list_channels — Listar canais
• search_messages — Buscar mensagens

Email (Resend)

# Instalação (requer RESEND_API_KEY)
export RESEND_API_KEY=re_sua_key
claude mcp add email -- npx -y mcp-resend

Ferramentas disponíveis:

• send_email — Enviar email

4. Configuração por Projeto

Arquivo .claude/settings.json

{
  "mcpServers": {
    "context7": {
      "command": "npx",
      "args": ["-y", "@upstash/context7-mcp"]
    },
    "filesystem": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-filesystem", "./src", "./docs"]
    },
    "postgres": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-postgres"],
      "env": {
        "DATABASE_URL": "postgresql://user:pass@localhost:5432/mydb"
      }
    }
  }
}

Arquivo global ~/.claude/settings.json

MCPs globais disponíveis em todos os projetos:

{
  "mcpServers": {
    "context7": {
      "command": "npx",
      "args": ["-y", "@upstash/context7-mcp"]
    },
    "thinking": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-sequential-thinking"]
    },
    "memory": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-memory"]
    }
  }
}

5. MCPs Recomendados por Fase do Context Engineering

Fase 01 — Ideação

claude mcp add excalidraw -- npx -y @cmd8/excalidraw-mcp
claude mcp add mindmap -- uvx mindmap-mcp-server --return-type filePath

Fase 02 — Contexto Técnico

claude mcp add context7 -- npx -y @upstash/context7-mcp
claude mcp add firecrawl -- npx -y firecrawl-mcp
claude mcp add excalidraw -- npx -y @cmd8/excalidraw-mcp

Fase 03 — Preparação (Libs)

claude mcp add context7 -- npx -y @upstash/context7-mcp
claude mcp add firecrawl -- npx -y firecrawl-mcp

Fase 04 — Planeamento (PRPs)

claude mcp add thinking -- npx -y @modelcontextprotocol/server-sequential-thinking

Fase 05 — Desenvolvimento

claude mcp add filesystem -- npx -y @modelcontextprotocol/server-filesystem ./src
claude mcp add git -- npx -y @modelcontextprotocol/server-git
claude mcp add github -- npx -y @modelcontextprotocol/server-github
claude mcp add context7 -- npx -y @upstash/context7-mcp

6. Setup Recomendado InfoWhere

Instalação completa para desenvolvimento

# Core
claude mcp add filesystem -- npx -y @modelcontextprotocol/server-filesystem ./src ./docs
claude mcp add git -- npx -y @modelcontextprotocol/server-git
claude mcp add github -- npx -y @modelcontextprotocol/server-github

# Documentação
claude mcp add context7 -- npx -y @upstash/context7-mcp

# Raciocínio
claude mcp add thinking -- npx -y @modelcontextprotocol/server-sequential-thinking

# Diagramas
claude mcp add excalidraw -- npx -y @cmd8/excalidraw-mcp

# Database (se aplicável)
claude mcp add postgres -- npx -y @modelcontextprotocol/server-postgres $DATABASE_URL

Verificar instalação

claude mcp list

7. Troubleshooting

MCP não responde

# Remover e adicionar novamente
claude mcp remove nome-do-mcp
claude mcp add nome-do-mcp -- comando

Erro de permissão

# Verificar se o comando funciona diretamente
npx -y @modelcontextprotocol/server-filesystem ./src

Variáveis de ambiente não funcionam

# Exportar antes de adicionar o MCP
export GITHUB_TOKEN=ghp_xxx
claude mcp add github -- npx -y @modelcontextprotocol/server-github

# Ou usar no settings.json com "env"

Ver logs de MCP

# Os logs aparecem no stderr durante a execução
claude --verbose

8. Criando seu próprio MCP

Template Python

# server.py
import asyncio
from mcp.server import Server
from mcp.server.stdio import stdio_server
from mcp.types import Tool, TextContent

server = Server("meu-mcp")

@server.list_tools()
async def list_tools() -> list[Tool]:
    return [
        Tool(
            name="minha_ferramenta",
            description="Descrição clara do que faz",
            inputSchema={
                "type": "object",
                "properties": {
                    "parametro": {
                        "type": "string",
                        "description": "Descrição do parâmetro"
                    }
                },
                "required": ["parametro"]
            }
        )
    ]

@server.call_tool()
async def call_tool(name: str, arguments: dict) -> list[TextContent]:
    if name == "minha_ferramenta":
        resultado = f"Processado: {arguments['parametro']}"
        return [TextContent(type="text", text=resultado)]
    raise ValueError(f"Ferramenta desconhecida: {name}")

def main():
    asyncio.run(stdio_server(server))

if __name__ == "__main__":
    main()

Template TypeScript

#!/usr/bin/env node
import { Server } from "@modelcontextprotocol/sdk/server/index.js";
import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
import {
  CallToolRequestSchema,
  ListToolsRequestSchema,
} from "@modelcontextprotocol/sdk/types.js";

const server = new Server(
  { name: "meu-mcp", version: "0.1.0" },
  { capabilities: { tools: {} } }
);

server.setRequestHandler(ListToolsRequestSchema, async () => ({
  tools: [{
    name: "minha_ferramenta",
    description: "Descrição clara do que faz",
    inputSchema: {
      type: "object",
      properties: {
        parametro: { type: "string", description: "Descrição" }
      },
      required: ["parametro"]
    }
  }]
}));

server.setRequestHandler(CallToolRequestSchema, async (request) => {
  if (request.params.name === "minha_ferramenta") {
    return {
      content: [{ type: "text", text: `Processado: ${request.params.arguments?.parametro}` }]
    };
  }
  throw new Error("Ferramenta desconhecida");
});

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

Instalação do MCP custom

# Python
claude mcp add meu-mcp -- python /caminho/para/server.py
claude mcp add meu-mcp -- uvx --from /caminho/para/projeto meu-mcp

# TypeScript
claude mcp add meu-mcp -- node /caminho/para/dist/index.js
claude mcp add meu-mcp -- npx -y /caminho/para/meu-mcp

9. Tabela Resumo de MCPs

10. Links de Referência

• MCP Specification
• MCP Servers Repository
• Claude Code MCP Docs
• Awesome MCP Servers
• MCP Python SDK
• MCP TypeScript SDK

Nota: Este guia é mantido pela InfoWhere. Para atualizações, consulte a documentação oficial dos MCPs.