Orium · Fluent Commerce · 2025
Un servidor MCP para que Claude trabaje con Fluent Commerce, una plataforma de order management potente pero muy complicada: lee su esquema GraphQL en vivo, genera y valida las consultas y después las ejecuta.
- Cliente
- Orium · Fluent Commerce
- Rol
- Creador del servidor MCP · desarrollador OMS
- Año
- 2025
Resultados
Contexto
Fluent Commerce es la plataforma de order management con la que más he trabajado, y la más difícil: la orquestación vive en workflows y reglas en Java, y su API GraphQL es enorme, así que hasta una pregunta simple requiere un especialista. Después de un proyecto de OMS para Article, construí un servidor MCP para que un agente trabaje con Fluent como lo haría un desarrollador senior: en lugar de adivinar consultas, lee el esquema en vivo, escribe la consulta exacta, la valida y solo entonces la ejecuta.
Qué construí
- 01
Un servidor MCP de GraphQL para Fluent (TypeScript, MCP SDK, Zod) con cinco herramientas: ejecutar, validar, listar campos raíz, selección máxima y generación estructurada de consultas.
- 02
Introspección del esquema y SDL en vivo expuestos como recursos MCP, con caché para mantener chico el contexto del agente.
- 03
Prompts guiados con un asistente experto en Fluent, construidos con plantillas externas: describes lo que necesitas en lenguaje natural (“stock disponible de un producto en una ubicación”) y obtienes una consulta validada, o exploras el esquema paso a paso.
- 04
Aportes al CLI agéntico de Fluent de Orium: correcciones al servidor MCP, rediseño de prompts y casos de prueba del agente para reglas y consultas GraphQL, junto a un pipeline de embeddings de reglas (JARs de reglas → embeddings → vector store).
- 05
El trabajo de OMS con el cliente que lo motivó: los módulos de órdenes, inventario y fulfilment de Fluent, componentes de UI de OMX y suites de pruebas de API.