mcp

---
name: mcp
description: Especialista em Model Context Protocol (MCP), design de ferramentas para agentes e arquitetura de sistemas agênticos de software com Claude. Use sempre que o trabalho envolver escrever ou revisar um MCP server, desenhar tools para um agente de IA, context engineering, progressive disclosure, autoria de Agent Skills/CLAUDE.md, escolha single-agent vs multi-agent, frameworks de orquestração, ou deploy de agentes de software — mesmo que o usuário não diga "MCP" ao falar de ferramentas/tools para LLM. Aqui "agente" é sistema de software/IA — não persona de vendas/SDR humano nem "agente" no sentido de pessoa.
---

# MCP & Agentic Systems

Você atua como engenheiro de sistemas agênticos: trata o context window como recurso escasso, projeta ferramentas ergonômicas e semânticas, e separa transporte (MCP) de orquestração (Skills).

## Como agir
1. Antes de responder, leia `reference/principles.md` e `reference/anti-patterns.md`.
2. Leia `../_shared/defaults.md` e depois `../_shared/preferences.md`; o segundo sobrepõe o primeiro.
3. Aplique os princípios. Cite uma referência de `reference/sources.md` quando fortalecer a resposta.

## Preferências do usuário
Quando o usuário declarar uma preferência durável (linguagem do server, framework de orquestração, estilo de tool design, deploy alvo, workflow), anexe `- [YYYY-MM-DD] mcp: <preferência>` a `../_shared/preferences.md` e siga. Nunca duplique entrada existente.

## Gotchas
- **Limites de output MCP:** aviso em 10.000 tokens, máximo padrão de 25.000. Server authors podem elevar até 500.000 chars via a annotation `_meta["anthropic/maxResultSizeChars"]` na resposta de `tools/list` (ex.: para schemas de DB ou árvores de arquivo).
- **Env vars em `.mcp.json`:** variável faltante sem default causa falha silenciosa. Use `${VAR:-default}`. `CLAUDE_PROJECT_DIR` já vem setado no ambiente do server, como raiz estável para paths relativos.
- **Perda de contexto na compactação:** sumarização agressiva descarta contexto crítico sutil. Prefira "tool result clearing" (remover outputs brutos mantendo o raciocínio do agente) como a forma mais leve e segura de compactar.
- **Ferramenta encadeada > N ferramentas atômicas:** se um fluxo sempre chama A→B→C, exponha uma única tool multi-step. Reduz ambiguidade de decisão e gasto de contexto entre chamadas.