Skills de IA com Vibecoding e Terminal · Capítulo 9 de 12 · 25 min
Model Context Protocol: o USB-C da IA
O que é MCP, como difere de Skills, e como construir seu primeiro servidor MCP em Python com FastMCP.
Este capítulo faz parte do curso gratuito Skills de IA com Vibecoding e Terminal.
Skills resolvem 'como o agente deve fazer X dentro do meu ambiente'. MCP -- Model Context Protocol -- resolve 'como o agente acessa dados e ações em sistemas externos de forma padronizada'. A Anthropic lançou o MCP em 2024 e adoção cresceu rápido: hoje Cursor, Windsurf, Zed, Claude Desktop e o próprio Claude Code falam MCP. É, efetivamente, o padrão HTTP dos agentes -- um protocolo comum que permite que qualquer cliente converse com qualquer servidor.
A analogia da Anthropic é precisa: MCP é o USB-C da IA. Antes do USB-C, cada aparelho precisava de um cabo próprio. Antes do MCP, cada agente precisava de uma integração customizada com cada API. Agora, um servidor MCP para Supabase funciona com qualquer agente. Um servidor MCP para Linear, idem. O agente só precisa saber falar MCP.
Quando usar Skills versus quando usar MCP
| Característica | Skills | Servidores MCP |
|---|---|---|
| Flexibilidade | Alta para operações locais, scripts e lógica de negócio | Alta para acesso a dados e ações em APIs externas |
| Protocolo | Markdown e execução direta de scripts | JSON-RPC sobre stdio, SSE ou HTTP |
| Portabilidade | Funciona onde o padrão Agent Skills é reconhecido | Universal: qualquer cliente compatível com MCP |
| Desenvolvimento | Rápido: SKILL.md + script e pronto | Mais elaborado: código de servidor + schema |
| Caso ideal | Auditor SEO, validador PT-BR, gerador de commit | Integração com Supabase, GitHub, Stripe, Slack |
| Custo operacional | Zero (roda no agente) | Requer processo servidor em execução |
Arquitetura do MCP em três componentes
Host -- o aplicativo que o humano usa. Claude Code, Claude Desktop, Cursor. O host decide quais servidores MCP estão ativos.
Cliente -- a camada interna do host que fala MCP. O usuário raramente interage com essa camada diretamente.
Servidor -- o processo que expõe ferramentas (tools), recursos (resources) e prompts. Pode ser escrito em Python (com FastMCP), TypeScript (com o SDK oficial) ou qualquer linguagem que fale JSON-RPC. Roda localmente ou em HTTP remoto.
Mensagens seguem três tipos: tools (funções que o agente pode invocar), resources (dados que o agente pode ler, tipo 'snapshot de uma tabela'), prompts (templates estruturados que o servidor sugere).
# Instalacao do FastMCP (Python, pela Anthropic)
pip install fastmcp
# Servidor MCP mínimo -- 15 linhas
# Salve em ~/mcp-servers/geo-stats/server.py
from fastmcp import FastMCP
import requests
mcp = FastMCP("geo-stats")
@mcp.tool()
def analyze_domain(url: str) -> dict:
"""Retorna titulo, status e tamanho da pagina para uma URL."""
r = requests.get(url, timeout=10)
return {
"status": r.status_code,
"bytes": len(r.content),
"has_schema": "application/ld+json" in r.text,
"has_canonical": "rel=\"canonical\"" in r.text,
}
@mcp.resource("config://brasilgeo")
def get_config() -> str:
"""Retorna config da Brasil GEO (estatico)."""
return "domain=alexandrecaramaschi.com\nenv=prod\n"
if __name__ == "__main__":
mcp.run() # stdio por default
# Execute com:
# python ~/mcp-servers/geo-stats/server.py# Conectando o servidor ao Claude Code (forma atual: pelo CLI)
# Tudo depois de -- é o comando que inicia o servidor
claude mcp add --transport stdio geo-stats -- python ~/mcp-servers/geo-stats/server.py
# Para dividir com o time, grave no .mcp.json do projeto (vai para o Git)
claude mcp add --scope project --transport stdio geo-stats -- python mcp-servers/geo-stats/server.py
# Servidor remoto (HTTP), como os conectores de SaaS
claude mcp add --transport http notion https://mcp.notion.com/mcp
# Conferir: claude mcp list no shell, ou /mcp dentro da sessão.
# O claude mcp add grava em ~/.claude.json (escopos local e user)
# ou no .mcp.json do projeto (escopo project).
# Peça: "Use a tool analyze_domain para verificar
# https://brasilgeo.ai e me diga se tem schema JSON-LD".Transportes disponíveis. stdio é o padrão para servidores locais -- o cliente inicia o processo e fala via stdin/stdout. SSE (Server-Sent Events) e HTTP streaming são usados para servidores remotos, permitindo que múltiplos clientes compartilhem o mesmo servidor. Em 2026, a maioria dos servidores corporativos roda HTTP streaming atrás de autenticação OAuth.
Ecossistema disponível hoje. A Anthropic mantém uma galeria oficial com dezenas de servidores prontos para instalar: GitHub, GitLab, Slack, Google Drive, Stripe, Sentry, Brave Search, PostgreSQL, Notion, Linear, Jira, Memgraph, Puppeteer (automação de browser), Everart (geração de imagem). Comunidade tem centenas adicionais no GitHub. Se você usa uma ferramenta SaaS, provavelmente já existe um MCP para ela.
Não reinvente. Antes de escrever um servidor MCP novo, busque na galeria oficial e em github.com/modelcontextprotocol/servers. Servidor para Supabase, GitHub, Stripe, PostgreSQL já existe em versão madura. Escreva do zero apenas para integrações internas (API proprietária da sua empresa, CRM customizado, dashboard interno). Seu tempo vale mais que a novidade de ter feito 'do zero'.
Security MCP é assunto sério. Um servidor MCP é código que o agente executa com seus privilégios. Se o servidor tem bug ou foi malicioso, ele age em seu nome. Instale apenas servidores de fontes confiáveis, leia o código antes de rodar, rode em sandbox quando possível, e nunca exponha secrets em env vars plain text. Em 2025 houve incidente documentado com servidor MCP não oficial que exfiltrava tokens. Use apenas os oficiais ou lista curada.
Você sabe a diferença funcional entre Skills e MCP, construiu um servidor MCP mínimo em Python, conectou ao Claude Code com claude mcp add e validou que o agente consegue invocar tools remotas.
Seu caderno neste capítulo
Abrir o caderno completoSelecione um trecho do capítulo para destacar ou anotar. Nos vídeos e áudios, use Anotar este momento. No teclado, selecione com Shift e as setas e use Alt+Shift+D para destacar ou Alt+Shift+N para anotar.
Salvo neste navegador. Entre na sua conta para levar o caderno a outros aparelhos.
Entre na sua conta para compartilhar o que aprendeu e convidar alguém para estudar com você.
Conexões deste capítulo
Veja o que estudar antes e para onde seguir depois, explore os conceitos e compare abordagens em outros cursos. Sugestões marcadas como “sugerido pelo grafo” vêm dos assuntos em comum, não do índice do curso.
Estude antes
- CursoClaude Code CLI: Programação com IA
- Usar o mapa do curso e o glossário mínimosugerido pelo grafoApresenta o conceito “MCP”, usado em “Model Context Protocol: o USB-C da IA”.
- Setup do Ambiente: Claude Code + Cursor em 15 Minutossugerido pelo grafoApresenta o conceito “Cursor”, usado em “Model Context Protocol: o USB-C da IA”.
- O que é controle de versãosugerido pelo grafoApresenta o conceito “GitHub”, usado em “Model Context Protocol: o USB-C da IA”.
Depois, siga para
- CursoFrontends com Vibecodingsugerido pelo grafo9 capítulos de “Frontends com Vibecoding” usam conceitos apresentados em “Skills de IA com Vibecoding e Terminal”.
- CursoPrompt Engineering para Executivossugerido pelo grafo3 capítulos de “Prompt Engineering para Executivos” usam conceitos apresentados em “Skills de IA com Vibecoding e Terminal”.
- CursoRLM 2027sugerido pelo grafo2 capítulos de “RLM 2027” usam conceitos apresentados em “Skills de IA com Vibecoding e Terminal”.
Conceitos deste capítulo
O mesmo assunto em outros cursos
- Agentes de IA Autônomos: Do Conceito à ProduçãoMCP (Model Context Protocol)Examinar conexões de MCP (Model Context Protocol)
- MCP para quem decideComparar Claude e OpenAI em conectores e agentesExaminar conexões de Comparar Claude e OpenAI em conectores e agentes
- Vídeo com IA: Claude Code, Codex e ElevenLabsConectar fal, Replicate e ElevenLabs por MCP com permissões mínimasExaminar conexões de Conectar fal, Replicate e ElevenLabs por MCP com permissões mínimas
- Software e IA para executivosConferir quem publicou cada plugue que liga o agente aos sistemasExaminar conexões de Conferir quem publicou cada plugue que liga o agente aos sistemas
Leve uma ideia para a prática
Escolha uma atividade no painel e volte a este curso quando quiser.
Atividades e evolução ficam reunidas no painel da sua conta.