API MCP — ERP gestionado por IA

Gestiona tu ERP desde Claude, ChatGPT o Cursor con la API de IA MCP

El servidor MCP nativo de eyeot expone tu software de gestión a un agente de IA sin una sola línea de código de integración. Conecta Claude Desktop, Cursor o un agente de ChatGPT al endpoint MCP: el agente accede de inmediato a más de 1500 acciones del ERP (clientes, presupuestos, facturas, inventario, tickets, RR. HH., inteligencia) en forma de herramientas tipadas. Cada llamada queda enmarcada por la autenticación, los permisos RBAC y la auditoría de tu organización.

Para autónomos y pymes que quieren automatizar tareas de negocio de extremo a extremo mediante un asistente de IA (Claude, ChatGPT, Cursor) o un agente de servicio, sin un proyecto de integración pesado: crear un cliente, preparar un presupuesto, detectar una rotura de stock o consolidar un informe, manteniendo la trazabilidad y el control de los permisos.

Lo que puedes hacer

Servidor MCP nativo

Un endpoint JSON-RPC 2.0 (POST /api/v1/mcp) expone una treintena de herramientas legibles para los casos habituales, más dos metaherramientas (eyeot_help, eyeot_call) que cubren la larga cola de más de 1500 acciones del ERP. Compatible con Claude Desktop, Cursor y agentes de ChatGPT.

Tres modos de autenticación del agente

Clave API de servicio (eyk_) para las automatizaciones recurrentes, u OAuth 2.1 Auth Code + PKCE y Device Grant (eya_/eyr_) para que un agente actúe en nombre de un usuario humano, incluso en Claude Desktop o una CLI sin navegador.

Idempotency contra duplicados

Una cabecera Idempotency-Key (UUID) protege cada creación frente a las escrituras duplicadas tras un reintento. La caché de 24 h por organización devuelve la respuesta original al repetir la llamada; una misma clave con un cuerpo diferente devuelve un 409 Conflict.

Modo dry-run (previsualización)

La cabecera X-Dry-Run: true ejecuta la validación y la lógica de negocio y después lo deshace todo (rollback). La respuesta detalla qué se habría creado, modificado o eliminado, así como los webhooks y notificaciones lanzados: el agente muestra los efectos antes de confirmar.

Permisos RBAC en cada llamada

Cada herramienta MCP comprueba el permiso del actor: un agente con el ámbito crm:read no puede escribir. El license guard autoriza la lectura (GET) incluso sin suscripción activa y devuelve un 402 enriquecido (activate_url) en las escrituras.

Búsqueda global y recursos

Una búsqueda transversal y plana resuelve un nombre impreciso en un identificador exacto, y el agente puede mencionar cinco recursos de lectura directa (clientes, presupuestos, facturas, productos, tickets) para explorar tus datos.

Auditoría completa de las acciones del agente

Cada llamada queda registrada en el registro de auditoría con el tipo de actor y la clave utilizada; las acciones OAuth llevan la etiqueta via:oauth. El administrador localiza la actividad de IA y puede filtrar el registro por actor.

Conformidad y confianza

Trazabilidad y regla de cero alucinaciones

Todas las acciones de un agente se registran en el registro de auditoría (actor, clave) y son consultables por el administrador. El protocolo obliga al agente a no citar nunca una organización, un usuario, un rol o un identificador sin haberlo leído mediante una llamada a una herramienta de la sesión.

Aislamiento multiorganización y RGPD

Una clave API está acotada a una única organización y un agente nunca recibe una clave global de plataforma. El servidor también sabe orquestar una solicitud RGPD (derecho de acceso) que agrega perfil, presupuestos, facturas, documentos y registros de un cliente en una exportación firmada.

Funciona con tus demás módulos

  • CRM — clientes, oportunidades y presupuestos
  • Facturación — facturas de cliente y PDF Factur-X
  • Inventario — productos y alertas de rotura de stock
  • IT Service — tickets ITSM
  • Inteligencia — scores entre módulos (salud del cliente, ingresos)
  • RR. HH. — empleados y ausencias

Preguntas frecuentes

¿Cómo conecto mi ERP a ChatGPT o Claude?
Instala el paquete eyeot-mcp (pip install eyeot-mcp) y luego ejecuta eyeot-mcp login para dar tu consentimiento mediante Device Grant, o añade el servidor MCP https://erp.eyeot.fr/api/v1/mcp con una clave API. Funciona con Claude Desktop, Cursor y los agentes de ChatGPT. No se necesita ningún desarrollo de integración.
¿Puede la IA crear duplicados en caso de reintento?
No. Cada creación con efectos utiliza una cabecera Idempotency-Key: repetir la llamada con la misma clave devuelve la respuesta original en lugar de volver a crear el objeto. El agente también puede previsualizar una acción en dry-run (X-Dry-Run) para comprobar los efectos antes de ejecutarla realmente.
¿Puede el agente de IA superar los permisos de un usuario?
No. Los permisos RBAC se comprueban en cada llamada a una herramienta: un agente con ámbito de lectura no puede escribir, y una clave está limitada a una única organización. Si la suscripción ha caducado, la lectura sigue siendo posible, pero las escrituras devuelven un mensaje de pago requerido.
¿Puedo saber qué ha hecho la IA en el ERP?
Sí. Cada acción del agente se registra en el registro de auditoría con el tipo de actor y la clave utilizada; las acciones realizadas en nombre de una persona mediante OAuth llevan un marcador específico. El administrador puede filtrar el registro por actor para supervisar la actividad.
¿Hace falta desarrollar una integración a medida?
No. El servidor sigue el estándar Model Context Protocol y proporciona herramientas tipadas que el agente entiende directamente, sin tener que interpretar una especificación de API. Basta con un paquete pip listo para usar para conectar Claude Desktop, Cursor o un agente.
¿Mis datos permanecen aislados entre mis organizaciones?
Sí. Una clave API está acotada a una organización concreta y un agente nunca recibe una clave global de plataforma. Para operar en varias organizaciones, emites una clave por organización, lo que garantiza el aislamiento multitenant.

Para saber más

Prueba eyeot gratis

eyeot es un ERP francés todo en uno para pequeñas y medianas empresas, alojado en Francia y conforme al RGPD. Gratis para particulares (1 usuario, todos los módulos); packs de equipo simples para las empresas.