Mapa da trilha
🔌 O que sao MCP Servers
O protocolo que conecta tudo
🚀 Seus Primeiros MCPs
Filesystem, Git, SQLite
📅 MCPs de Produtividade
Slack, Calendar, Gmail, Notion
🗄️ MCPs de Database e APIs
Postgres, Redis, REST, GraphQL
🛠️ Criando seu Proprio MCP
TypeScript SDK, tools, handlers
🌐 Ecossistema e Marketplace
Awesome MCP, Smithery, futuro
Conteudo detalhado
🔌 O que sao MCP Servers
O protocolo MCP explicado do zero: arquitetura, schemas, e por que muda tudo.
MCP (Model Context Protocol) e o protocolo aberto que conecta LLMs a ferramentas externas via JSON-RPC.
E o padrao que o Claude Code usa para todas as integracoes externas.
JSON-RPC, stdio/SSE transport, handshake de capabilities.
O Claude Code e o client; cada MCP e um server que expoe tools via schema.
Entender a separacao ajuda a debugar e escolher MCPs.
Client, server, transport layer, lifecycle.
Cada server declara suas tools com inputSchema JSON Schema; o client lista e invoca.
E o mecanismo que permite ao agente usar ferramentas sem hardcode.
tools/list, tools/call, inputSchema, JSON Schema.
MCP transforma o agente de "leitor de arquivos" em "operador de sistemas".
Sem MCP, o agente so le/escreve files; com MCP, opera DBs, APIs, services.
Extensibilidade, composicao, padronizacao.
Ja existem 200+ MCP servers open source cobrindo DBs, SaaS, DevOps e mais.
Saber o que existe evita reinventar a roda.
Awesome MCP, Smithery, categorias de servers.
MCP e como uma API REST, mas otimizada para agentes: schema declarativo, discovery automatico.
A analogia facilita entender o modelo mental se voce ja usou APIs.
REST endpoints vs MCP tools; OpenAPI vs inputSchema.
🚀 Seus Primeiros MCPs
Mao na massa: configurar Filesystem, Git e SQLite no Claude Code.
O arquivo .claude/settings.json onde voce declara cada MCP server.
Sem isso nenhum MCP funciona; e o primeiro passo pratico.
mcpServers, command, args, env.
Server que expoe operacoes de filesystem como tools MCP.
E o MCP mais basico e ilustra perfeitamente o pattern.
read_file, write_file, list_directory, sandboxing.
Server MCP para operacoes Git: status, diff, commit, branch.
Permite ao agente versionar codigo sem voce intervir manualmente.
git_status, git_commit, git_diff, permissoes.
Server que da ao agente acesso SQL a bancos SQLite.
Demonstra como MCPs podem dar acesso a dados estruturados.
query, execute, schema inspection, read-only mode.
Como verificar se o MCP esta conectado e as tools aparecem no agente.
Sem teste voce nao sabe se a config esta certa.
/mcp, tool listing, invocacao manual, logs.
Diagnosticar erros comuns: server nao inicia, timeout, permission denied.
90% dos problemas com MCP sao de config; saber debugar economiza horas.
stderr logs, npx vs global install, PATH, env vars.
📅 MCPs de Produtividade
Conecte Slack, Calendar, Gmail e Notion ao seu agente.
MCP que conecta o agente a canais e DMs do Slack.
Automacao de comunicacao: resumir threads, responder, notificar.
OAuth token, channels, send_message, read_channel.
MCP para criar/listar/editar eventos no Google Calendar.
O agente pode checar disponibilidade e agendar reunioes por voce.
Service account, scopes, list_events, create_event.
MCP que permite ler, buscar e enviar emails pelo Gmail.
Triagem automatica, respostas rapidas, busca em historico.
Gmail API, search_emails, send_email, drafts.
MCPs para gerenciamento de projeto: criar pages, atualizar issues, buscar docs.
O agente pode criar/atualizar tasks e documentacao automaticamente.
Notion API key, Linear API, create_page, create_issue.
Rodar 3-5 MCPs simultaneamente e deixar o agente orquestrar entre eles.
A composicao e onde o MCP brilha: workflows cross-tool sem codigo.
Multi-server config, tool routing, context budget.
Receitas praticas: daily standup automatico, email triage, agenda briefing.
Sair da teoria e ter automacoes funcionando no seu dia.
Scheduled prompts, multi-MCP chains, output routing.
🗄️ MCPs de Database e APIs
PostgreSQL, Redis, REST e GraphQL direto no agente.
MCP que conecta o agente a um banco PostgreSQL para queries e mutacoes.
O agente pode analisar dados, gerar reports, debugar schemas.
Connection string, read-only vs read-write, query tool.
MCP para operacoes Redis: get/set, inspect keys, pub/sub.
Debugar cache, verificar filas, monitorar estado em tempo real.
Redis URL, GET/SET, KEYS, TTL inspection.
MCP generico para chamar endpoints REST com headers e body customizaveis.
Conecta o agente a qualquer servico que tenha uma API REST.
Base URL, auth headers, request/response mapping.
MCP para executar queries e mutations GraphQL contra qualquer endpoint.
Se sua API e GraphQL, este MCP da acesso completo ao agente.
Schema introspection, query/mutation, variables.
Patterns para conectar MCPs a servicos reais (nao so local dev).
O valor real aparece quando o agente opera em ambientes de staging/prod.
SSH tunnels, env configs, connection pools.
Best practices para gerenciar tokens, passwords e connection strings com MCPs.
MCPs com acesso a DBs/APIs precisam de credenciais; vazar = desastre.
Env vars, .env files, gitignore, secret managers.
🛠️ Criando seu Proprio MCP Server
Do zero ao deploy: anatomia, SDK TypeScript, tools, handlers e distribuicao.
Um server MCP e um processo que fala JSON-RPC via stdio e expoe tools.
Entender a anatomia e pre-requisito para criar o seu.
Processo, stdin/stdout, initialize, tools/list handler.
O pacote @modelcontextprotocol/sdk que abstrai o protocolo pra voce.
Com o SDK, voce cria um server funcional em 30 linhas.
McpServer class, StdioServerTransport, tool(), resource().
Cada tool tem nome, descricao e um inputSchema (JSON Schema) que o agente usa.
Um schema bem feito = o agente acerta os parametros de primeira.
name, description, inputSchema, required fields, types.
A funcao que recebe os args do agente, executa a acao e retorna o resultado.
E onde a logica real vive; o handler e o "corpo" da tool.
CallToolResult, content array, text/image responses, error handling.
Testar o MCP server localmente com o MCP Inspector e com Claude Code.
Um server sem testes quebra em silencio; o inspector facilita muito.
MCP Inspector, manual JSON-RPC, integration tests.
Como empacotar e publicar seu MCP server (npm, Docker, Smithery).
Compartilhar com o time ou a comunidade multiplica o impacto.
npm publish, npx entry point, Docker image, Smithery listing.
🌐 Ecossistema e Marketplace
Onde encontrar, avaliar e compor MCP servers de qualidade.
O repositorio awesome-mcp-servers no GitHub: a lista curada da comunidade.
Ponto de partida para descobrir MCPs prontos de alta qualidade.
Categorias, stars, manutencao ativa, oficiais vs community.
Smithery.ai: o npm/marketplace para MCP servers com install one-click.
Instalar MCPs via Smithery e mais rapido que configurar manualmente.
smithery install, verified servers, usage stats.
Criterios para avaliar se um MCP server e confiavel antes de usar.
MCP ruim pode travar, vazar dados ou dar respostas erradas.
Commits recentes, issues abertas, documentacao, testes, licenca.
Patterns para combinar 3-8 MCPs num setup coeso e produtivo.
O poder do MCP aparece na composicao, nao em servers isolados.
Tool budget, naming conflicts, priority routing.
Riscos de MCPs maliciosos e como se proteger (sandbox, audit, least-privilege).
Um MCP roda codigo na sua maquina; confiar cegamente e perigoso.
Code review, pinned versions, sandboxing, permission scopes.
Tendencias: remote servers, auth federada, streaming, multi-modal tools.
Saber a direcao ajuda a investir no que vai durar.
Remote MCP, OAuth2, Streamable HTTP, tool composability.