Servidor MCP y API para tu tienda online

MCP (Model Context Protocol) es un estándar abierto que permite a un asistente de IA conectarse a un programa y trabajar con sus datos. El servidor MCP es la parte del programa: le indica al asistente qué datos y acciones existen y ejecuta sus peticiones. El servidor MCP de Elbuz da acceso al catálogo, las listas de precios, los clientes, los documentos, las oportunidades y los correos: escribes en lenguaje normal y el asistente busca, calcula y propone cambios.

Una API es una interfaz para programas: tu web o tu programa de gestión intercambia datos con Elbuz mediante peticiones descritas en la documentación. MCP es una capa para asistentes de IA: el propio asistente averigua qué datos hay y qué puede hacer con ellos, y actúa según tus instrucciones. En Elbuz ambos funcionan con los mismos permisos de empleado y el mismo «Pulso».

El asistente de IA pregunta al servidor MCP qué datos y acciones hay, y el servidor ejecuta sus peticiones: asistente ↔ MCP ↔ Elbuz. La conexión va por Streamable HTTP con peticiones JSON-RPC. El servidor MCP de Elbuz responde solo con los datos que puede ver el empleado de la clave, y cualquier cambio vuelve a ti para que lo apruebes en «Pulso».

Pides en lenguaje normal y el asistente trabaja a través del servidor MCP de Elbuz: cuenta por categoría los productos sin foto, encuentra atributos duplicados y propone fusionarlos, redacta descripciones cortas, prepara el informe de pedidos del día o de la semana y lista los clientes sin seguimiento. Cada cambio espera tu «Aceptar».

En Claude Code, Codex o Cursor añades el servidor MCP de Elbuz con una clave API creada en nombre de un empleado. En claude.ai y ChatGPT se añade como conector: no hace falta clave, inicias sesión en Elbuz y pulsas «Permitir» (OAuth). El acceso se revoca en la ventana «API y tokens de acceso».

No sin tu aprobación. El asistente trabaja con los permisos del empleado para el que se emitió la clave, y una clave nueva se crea como «Solo lectura». Si se permite la escritura, por defecto cada cambio espera tu aprobación en «Pulso» como «antes → después». Solo «Dirección» puede activar «Actuar solo», y un freno de emergencia devuelve la clave al modo «Preguntar» si hace demasiados cambios en una hora. El servidor MCP no tiene ninguna herramienta para borrar.

Tu web, tu CMS o tu programa de gestión envía los pedidos nuevos y sus cambios con una petición POST /api/v2/orders/sync, en lotes de hasta 100. Los nuevos se convierten en documentos «Pedido de cliente», y los ya cargados se reconocen y se actualizan, sin duplicados.

120 peticiones por minuto y clave, y las peticiones del asistente MCP con la misma clave cuentan dentro de ese límite. Los pedidos se reciben en lotes de hasta 100; los webhooks llegan en lotes de hasta 100, con hasta seis intentos de entrega si tu servidor no responde. Una clave solo ve y cambia lo que permiten los permisos de su empleado.