M-008
Completadapayments-mcp · Pagos para agentes de IA
Middleware de pagos que expone la misma lógica por REST y por un servidor MCP, con OAuth2 según la spec MCP, tools filtradas por scope y reembolso en dos pasos. Incluye un agente con Claude que pide aprobación humana.
- Rol
- Desarrollador único · proyecto propio
- Duración
- 1 semana
- Inicio
- oct 2026
Middleware de pagos que expone la misma lógica de negocio a dos tipos de clientes: servicios internos por una API REST documentada con OpenAPI y agentes de IA por un servidor MCP. Autorización OAuth2 (client credentials, JWT ES256 + JWKS) según la spec MCP, tools filtradas por scope y reembolso en dos pasos (vista previa → confirmación). Idempotencia compartida entre REST y MCP, bloqueos FOR UPDATE contra reembolsos concurrentes y outbox transaccional hacia SQS con entrega at-least-once. Construido con Spec Driven Development: requisitos, diseño y tareas antes del código.
▸ Logros clave
- Agente demo con Claude (Anthropic SDK) que descubre las tools por MCP y pide aprobación humana antes de reembolsar.
- Un reintento nunca cobra dos veces: la Idempotency-Key se comparte entre REST y MCP.
- Infraestructura como código con Terraform (SQS con DLQ, VPC y EKS) y métricas en Prometheus, Grafana y Loki.
▸ Desafíos
- Dar a un agente de IA acceso a operaciones con dinero sin darle más permisos de los necesarios.
- Evitar reembolsos dobles bajo concurrencia y no perder eventos si la cola falla.
≥85%
Cobertura de tests
2
Clientes (REST y MCP)
2
Pasos para reembolsar
▸ STACK DESPLEGADO
- TypeScript
- PostgreSQL
- IA (MCP)
- Terraform
- Prometheus · Grafana · Loki