Cursor + MCP: IA com superpoderes
Entenda o Model Context Protocol (MCP) e como ele transforma o Cursor num agente capaz de acessar bancos de dados, APIs, navegadores e qualquer ferramenta externa.
Cursor + MCP: IA com superpoderes
O Model Context Protocol (MCP) é um protocolo aberto criado pela Anthropic que padroniza como aplicações fornecem contexto e ferramentas para LLMs. No Cursor, funciona como um sistema de extensões que conecta o agente a fontes de dados externas, APIs, bancos de dados, navegadores e qualquer outra ferramenta — tudo por interfaces padronizadas.
A analogia mais precisa: MCP é para agentes de IA o que o LSP (Language Server Protocol) é para editores de código. Um padrão único, múltiplos clientes e servidores.
Por que isso importa?
Sem MCP, o Cursor conhece apenas o que está no seu contexto de conversa e nos arquivos que você referencia manualmente. Com MCP, o agente passa a ter acesso a:
- Seu banco de dados — consulta e altera dados em tempo real
- GitHub/GitLab — cria issues, revisa PRs, gerencia branches
- Navegador — acessa URLs, faz scraping, preenche formulários
- Documentação atualizada — injeta docs da versão exata que você usa
- Qualquer API — o que você construir vira uma ferramenta do agente
A diferença prática: em vez de copiar e colar um schema do banco no chat, o agente consulta o banco diretamente. Em vez de descrever um bug, o agente abre uma issue no GitHub com um único comando.
Arquitetura MCP
Host (Cursor)
│
└── MCP Client (embutido)
│
├── [stdio] ──────────> MCP Server local
│ ├── Tools
│ ├── Resources
│ └── Prompts
│
└── [HTTP/SSE] ──────> MCP Server remotoPrimitivas
| Primitiva | O que é | Suporte no Cursor |
|---|---|---|
| Tools | Funções que o LLM pode chamar | ✅ Suportado |
| Resources | Dados expostos para leitura | ⚠️ Parcial |
| Prompts | Templates reutilizáveis | ❌ Ainda não |
O Cursor suporta até 40 ferramentas ativas entre todos os servidores MCP simultâneos.
Tipos de transporte
STDIO — local, simples
O servidor roda como processo filho do Cursor via stdin/stdout. Ideal para desenvolvimento local e ferramentas instaladas na máquina.
{
"mcpServers": {
"meu-servidor": {
"command": "node",
"args": ["/caminho/absoluto/server.js"],
"env": { "API_KEY": "valor" }
}
}
}Streamable HTTP — remoto, escalável
Comunicação via HTTP POST com suporte opcional a SSE. Permite hospedar o servidor em qualquer lugar e compartilhar com a equipe.
{
"mcpServers": {
"servidor-remoto": {
"url": "https://mcp.suaempresa.com/mcp",
"headers": { "Authorization": "Bearer TOKEN" }
}
}
}SSE legado — depreciado
O transporte SSE puro (dois endpoints separados) foi depreciado em novembro de 2024. O Streamable HTTP o substituiu como padrão. Ainda funciona por compatibilidade, mas novos servidores devem usar HTTP.
O que vem a seguir
⚙️ Configurando MCPs no Cursor
mcp.json global vs por projeto, campos disponíveis e servidores prontos para usar
🟦 Criando MCP server com TypeScript
Do zero ao servidor funcional com o SDK oficial e Zod para validação
🐍 Criando MCP server com Python
FastMCP: o framework Python com menos boilerplate para servidores MCP
🤖 Cursor Agent Mode
Como o agente opera, diferença do Chat Mode e workflows com MCPs
🔒 Segurança e boas práticas
CVEs descobertos, checklist de segurança e MCPs mais populares da comunidade