Estado: outline (borrador). Se completa en Fase 1 (hito 1.2 del roadmap). Basado en patrón real, sin código ni datos de cliente.
Por qué MCP y por qué envolver una API legacy
Qué es el Model Context Protocol y por qué un servidor MCP es el enchufe entre un agente y una API que nunca fue pensada para agentes: no se reescribe la API, se la traduce a un contrato que el agente puede consumir sin romperla.
El patrón
- OpenAPI como contrato — versionar el spec localmente.
- Auth OAuth2 (ROPC / B2C) — manejo de credenciales y rotación.
- Modo degradado sin credenciales — el servidor arranca y responde aunque falten secretos.
- Idempotencia y reintentos seguros en las llamadas a la API envuelta.
- Smoke tests CLI — verificación rápida de extremo a extremo.
Decisiones de diseño y trade-offs
- Exponer herramientas de grano fino vs. grueso.
- Qué documentación local exponer al agente y cómo.
- Observabilidad: logging estructurado de tool-calls.
Qué haría distinto a escala
Gateway con auth centralizada, secret management, y un eval harness para las respuestas del agente. (Se materializa en el build-vitrina “Agentic infra starter kit”.)