Integración agéntica por MCP: opera pedidos y clientes en lenguaje natural

Los equipos de loyalty y operaciones cada vez automatizan más con agentes de IA: campañas que crean pedidos, scripts que ajustan wallets de puntos, asistentes que consultan catálogo antes de lanzar una promo. Hasta ahora eso implicaba integrar el API REST a mano, manejar idempotencia y memorizar endpoints. TPP Ops cierra esa brecha con un servidor MCP (Model Context Protocol) que envuelve el API público /api/v1/* como herramientas que un agente puede invocar en lenguaje natural. No es una segunda API ni un acceso distinto al backoffice interno. Es un adaptador de protocolo: cada llamada MCP se traduce en una petición HTTP al API que ya usan los partners, con el mismo bearer, los mismos scopes y las mismas reglas de sub-marca. Si el token no puede crear pedidos, la tool devuelve forbidden — el agente no puede saltarse la autorización. Qué puede hacer un agente conectado Las tools se generan automáticamente desde el registro de operaciones del API. Cuando añadimos un endpoint nuevo, aparece como herramienta MCP sin trabajo extra. El catálogo cubre el ciclo operativo que importa a integradores y equipos de producto. Clientes: listar, crear, actualizar, consultar monedas y ajustar saldos ( bulk_adjust_customer_coins incluido). Pedidos: reserve_order , listar, consultar detalle, cancel_order y gestionar envío. Catálogo: tiendas, catálogos y search_products con precios velados. Sesiones: create_store_session para hand-off SSO del jugador. Autenticación y alcance El servidor MCP no guarda credenciales propias. Toma el header Authorization: Bearer de la petición entrante — tu API key tpp_live_* o tpp_test_* — y la reenvía tal cual al API. La clave está scoped a una sub-marca: el agente solo ve y toca datos de ese tenant. El velo de proveedor, el rate-limit, la auditoría y la idempotencia los hereda del wrapper withApiKey ; el MCP no reimplementa lógica de negocio. Principio de mínimo privilegio: crea una key con solo los scopes que el agente necesita. Un token de solo lectura no puede escribir aunque el prompt lo pida — el API responde 403 y el agente recibe un error accionable con el scope que falta. Idempotencia en operaciones de dinero Los endpoints que mueven dinero o crean clientes exigen Idempotency-Key . Un agente que reintenta por duda podría duplicar un cargo sin una clave estable. El MCP genera automáticamente un UUID por llamada y expone un argumento opcional idempotency_key para reintentos deliberados: el API devuelve la misma respuesta cacheada con Idempotent-Replay: true . Cómo conectarlo En el backoffice de TPP Ops, entra a Sub-marca → API keys y crea un token con los scopes mínimos. En ChatGPT (Developer Mode), añade un conector personalizado con URL https:///api/mcp y autenticación API key / Bearer. Claude, Cursor y n8n usan la misma URL y cabecera. La guía humana vive en /api/v1/mcp ; el manifiesto machine-readable con JSON-Schema de cada tool, en /api/mcp/tools — el equivalente MCP del OpenAPI. ChatGPT ejecuta tools/list al conectar y ya puede operar: "crea un pedido para este cliente", "¿cuántas monedas tiene el segmento VIP?", "busca regalos de gaming en el catálogo". Por qué MCP y no solo REST El REST sigue siendo la opción para integraciones server-to-server clásicas. MCP desbloquea el mismo backend para flujos agénticos: prototipos rápidos, operaciones asistidas por IA, conectores en ChatGPT sin escribir un middleware propio. Una sola fuente de verdad, dos formas de consumirla. El servidor es stateless (Streamable HTTP), escala horizontalmente sin Redis y se despliega con la misma app en POST /api/mcp . Si ya operas loyalty con TPP y quieres que tus agentes creen pedidos, consulten stock o ajusten monedas sin pegar curl, MCP es la capa que faltaba.

Integración agéntica por MCP: opera pedidos y clientes en lenguaje natural

More news

Sistema antifraude en TPP Ops: puntuación y cuarentena automática

Próximamente: juegos en tu programa de loyalty

Login con Google en TPP Ops

Gift in any country. We handle the rest.