Multi-Agent e MCP — Orquestração Avançada de Agentes
Baixar PDFComo funcionam subagentes, MCP (Model Context Protocol), A2A (Agent-to-Agent) e orquestração avançada no Claude Code e Cursor.
Quando uma tarefa é complexa demais para um único agente, você pode orquestrar múltiplos agentes trabalhando em paralelo. Isso é multi-agent — e os protocolos MCP e A2A estão padronizando como agentes se comunicam.
Subagentes no Claude Code
Quando usar subagentes
| Cenário | Use subagent? |
|---|---|
| Ler 10 arquivos para entender contexto | Sim — paraleliza leitura |
| Implementar um endpoint | Não — faça no agente principal |
| Buscar padrões em 50 arquivos | Sim — paraleliza busca |
| Rodar testes e corrigir | Não — precisa de sequência |
| Gerar testes para 5 módulos | Sim — paraleliza escrita |
Como funcionam
Agente Principal (Scheduler):
→ Lê spec
→ Divide em subtarefas
→ Spawna subagentes
Subagent 1: Lê src/api/users.ts
Subagent 2: Lê src/db/schema.ts
Subagent 3: Lê src/middleware/auth.ts
Subagent 4: Lê specs/billing.md
│
▼
Subagentes retornam contexto ao principal
│
▼
Agente Principal: implementa com contexto completoMCP — Model Context Protocol
MCP é um protocolo aberto que padroniza como agentes de IA acessam ferramentas externas: bancos de dados, APIs, filesystems, serviços. É o "USB" das IAs.
MCP Servers indispensáveis (2027)
| Server | O que acessa | Por que usar? |
|---|---|---|
| Sequential Thinking | Raciocínio estruturado | Melhora a resolução de problemas complexos passo-a-passo. |
| Brave Search | Web em tempo real | Permite que o agente pesquise documentações atualizadas. |
| GitHub MCP | Issues, PRs, Repo | Claude pode ler issues e abrir PRs diretamente. |
| PostgreSQL | DB Schema / Dados | O agente entende a estrutura do banco sem você enviar SQL. |
| Playwright | Browser Automation | Claude pode "ver" o site que construiu e testar o UI. |
| Sentry | Erros de Produção | Analisa crash logs e sugere correções automaticamente. |
Configuração no Claude Code
// .claude/settings.json
{
"mcpServers": {
"brave-search": {
"command": "npx",
"args": ["-y", "@modelcontextprotocol/server-brave-search"],
"env": {
"BRAVE_API_KEY": "YOUR_KEY"
}
},
"sequentialthinking": {
"command": "npx",
"args": ["-y", "@modelcontextprotocol/server-sequentialthinking"]
}
}
}A2A — Agent-to-Agent Protocol
A2A padroniza como agentes se comunicam entre si (não apenas com ferramentas).
Caso de uso: Agentic Search
Em 2027, não pesquisamos mais no Google. Usamos um Agente de Pesquisa (como o Brave Search MCP) que filtra o lixo, lê a documentação oficial e entrega o contexto "mastigado" para o nosso Agente de Código.
Status (2027)
A2A agora é suportado nativamente pelos principais provedores. O padrão permite que um agente "contrate" outro especialista (ex: um agente especialista em Segurança para auditar o código do agente de Feature).
Padrões de orquestração
Fan-out / Fan-in
## Fan-out
Spawn 3 subagents to search for:
1. All usages of function X
2. All imports of module Y
3. All tests related to feature Z
## Fan-in
After all 3 return, synthesize findings into a plan.
Then implement the plan in the main agent.Pipeline
## Pipeline
1. Subagent A: Generate test cases from spec
2. Main: Review and approve test cases
3. Subagent B: Implement code to pass tests
4. Subagent C: Generate documentation from implementationCompetitive
## Competitive
Spawn 2 subagents with different approaches:
- Subagent A: Implement with REST
- Subagent B: Implement with GraphQL
Compare results and choose the best.Revisão de Código Gerado por IA — O Que Verificar
Como revisar código gerado por IA de forma eficiente. Checklist de segurança, padrões de qualidade, normalização de deviance e como evitar confiança cega.
Onboarding de Projeto com IA — Primeiros Passos em um Código Novo
Como usar IA para fazer onboarding rápido em um projeto desconhecido. Mapa de dependências, arquitetura, convenções e o primeiro commit.