๐ Glossario vivo
Termos-chave desta trilha. Volte aqui sempre que precisar.
read_file, query_db.๐ก O protocolo MCP explicado
Imagine assim: voce contrata um assistente que fala 10 idiomas. Mas se cada fornecedor inventar um idioma proprio, o assistente precisa aprender 10 gramaticas. MCP e o "idioma unico" que todos os fornecedores usam para falar com agentes de IA.
MCP significa Model Context Protocol. E um protocolo aberto, criado pela Anthropic e liberado para toda a comunidade, que padroniza como agentes de IA descobrem e usam ferramentas externas. Antes do MCP, cada ferramenta tinha sua propria integracao. Agora, um unico protocolo conecta o agente a qualquer servico que implemente o padrao.
Na pratica, MCP usa JSON-RPC 2.0 sobre um canal de comunicacao (normalmente stdio para processos locais, ou HTTP com SSE para servidores remotos). O agente manda uma mensagem JSON dizendo "quero chamar a tool X com esses parametros" e o server responde com o resultado, tambem em JSON. Simples, previsivel e extensivel.
O client (Claude Code) manda um request JSON-RPC; o server executa e devolve o resultado.
Em 1 frase: MCP e o JSON-RPC padronizado que permite ao agente chamar qualquer ferramenta externa com um unico protocolo.
๐๏ธ Arquitetura client-server
Imagine assim: um restaurante. O garcom (client) anota o pedido e leva para a cozinha (server). A cozinha prepara e devolve o prato. O garcom nao precisa saber cozinhar; a cozinha nao precisa saber servir. Cada um faz sua parte.
No MCP, o client e o Claude Code. Ele sabe como conversar com o usuario, planejar tarefas, e decidir quando precisa de uma ferramenta. O server e um processo separado que sabe fazer algo especifico: ler arquivos, consultar um banco, mandar um email. O client descobre o que o server oferece (via tools/list), e depois chama a tool que precisa (via tools/call).
O canal entre eles pode ser stdio (o client inicia o server como processo filho e conversa via stdin/stdout) ou HTTP + SSE (o server roda remoto e aceita conexoes). No dia a dia com Claude Code, voce quase sempre usa stdio: o agente spawna o processo MCP, conversa, e mata quando termina a sessao.
Quem e o "client" no ecossistema MCP do Claude Code?
Em 1 frase: o Claude Code (client) inicia o MCP server, descobre as tools, chama o que precisa, e encerra.
๐ Tool discovery e schemas
Quando o client conecta a um MCP server, a primeira coisa que faz (apos o handshake) e pedir a lista de tools disponiveis via tools/list. Cada tool vem com tres coisas: um nome (ex.: read_query), uma descricao (texto que explica o que faz), e um inputSchema (JSON Schema dizendo quais parametros aceita).
O agente le o schema e "entende" que parametros precisa fornecer. E como se cada tool viesse com um manual embutido. Quanto melhor a descricao e o schema, mais o agente acerta de primeira. Um schema ruim e como dar um formulario sem rotulos: o agente vai chutar.
{
"name": "read_query",
"description": "Execute a SELECT query against the database",
"inputSchema": {
"type": "object",
"properties": {
"query": {
"type": "string",
"description": "The SQL SELECT query to execute"
}
},
"required": ["query"]
}
}
O schema e o contrato
O inputSchema funciona exatamente como um JSON Schema da OpenAPI. Se voce ja trabalhou com APIs REST documentadas via Swagger/OpenAPI, o mecanismo e identico: o schema descreve tipos, campos obrigatorios, e descricoes. A diferenca e que quem le o schema nao e um dev humano, mas o proprio agente de IA.
Em 1 frase: cada tool tem um schema JSON que o agente le para saber exatamente o que mandar.
๐ก Por que MCP importa
Imagine assim: antes do USB, cada dispositivo tinha um conector diferente. O USB padronizou a conexao e o ecossistema de perifericos explodiu. MCP e o "USB dos agentes de IA".
Sem MCP, o Claude Code so tem as ferramentas built-in: ler/escrever arquivos, rodar bash, buscar na web. Funciona, mas e como um computador sem portas USB: faz o basico e para por ai. Com MCP, voce pluga quantos "perifericos" quiser: banco de dados, Slack, email, calendario, qualquer API.
O impacto pratico e enorme. Em vez de escrever scripts glue para cada integracao, voce configura um MCP server e o agente descobre sozinho o que pode fazer. A padronizacao significa que qualquer MCP server feito por qualquer pessoa funciona com qualquer client MCP. Composicao sem limites.
Sem MCP
- * So ferramentas built-in (file, bash, web)
- * Cada integracao = script custom
- * Nao escala: 5 integracoes = 5 scripts
- * Agente limitado ao filesystem
Com MCP
- * Centenas de tools via protocolo padrao
- * Config unica no settings.json
- * Escala: 50 tools = mesmo pattern
- * Agente opera DBs, APIs, SaaS, tudo
Em 1 frase: MCP transforma o Claude Code de "editor de arquivos" em "operador de sistemas conectado a tudo".
๐ Ecossistema atual
O ecossistema MCP ja e vasto. Existem mais de 200 servers open source cobrindo categorias como: DevOps (Git, Docker, Kubernetes), Database (Postgres, SQLite, Redis, MongoDB), SaaS (Slack, Notion, Linear, Gmail, Calendar), Cloud (AWS, GCP, Cloudflare), e Utilitarios (browser automation, web search, file conversion).
Os servers oficiais da Anthropic cobrem o basico: filesystem, git, SQLite, Postgres, puppeteer, brave-search. A comunidade contribui o resto. Repositorios como awesome-mcp-servers no GitHub e o marketplace Smithery.ai sao os melhores pontos de partida para descobrir o que existe.
Categorias principais do ecossistema
Git, Docker, K8s, CI/CD
Postgres, SQLite, Redis, Mongo
Slack, Notion, Linear, Gmail
AWS, GCP, Cloudflare
Browser, search, scraping
PDF, imagem, email, calendar
Em 1 frase: 200+ servers open source, de Git a Slack, prontos para plugar no Claude Code.
๐ Analogia com APIs REST
Se voce ja trabalhou com APIs REST, MCP vai parecer familiar. Em REST, voce tem endpoints (GET /users, POST /orders). Em MCP, voce tem tools (list_users, create_order). Em REST, a documentacao vem num OpenAPI spec. Em MCP, vem no inputSchema.
A diferenca fundamental: REST foi feito para devs humanos chamarem via codigo. MCP foi feito para agentes de IA chamarem automaticamente. Por isso o schema e mais descritivo (o agente precisa "entender" o que a tool faz so lendo a descricao) e o discovery e automatico (o agente lista as tools em runtime, sem ler documentacao).
| Aspecto | REST API | MCP |
|---|---|---|
| Unidade | Endpoint (URL + metodo) | Tool (nome + schema) |
| Documentacao | OpenAPI / Swagger | inputSchema (JSON Schema) |
| Discovery | Manual (ler docs) | Automatico (tools/list) |
| Consumidor | Codigo escrito por humano | Agente de IA (automatico) |
| Transporte | HTTP | stdio ou HTTP+SSE |
Em 1 frase: MCP e como uma API REST, mas com discovery automatico e otimizada para agentes (nao humanos).
๐งพ Resumo do Modulo
Proximo modulo:
3.2 โ Seus Primeiros MCPs: mao na massa com Filesystem, Git e SQLite.