--- title: "API v4, webhooks y MCP: servidor y cliente | attendo" description: "API v4 documentada con OpenAPI, claves con permisos por operación, webhooks con historial, servidor MCP para tu asistente y cliente MCP para otros servidores." url: "https://attendo.me/modulos/api-mcp" lang: "es" --- # Tus sistemas también trabajan aquí La API v4, webhooks en los dos sentidos y MCP como servidor y como cliente. Cada clave hace solo las operaciones que le permites: si se filtra, el daño posible es el que decidiste. - Esquema OpenAPI navegable - Lista blanca por clave - Escrituras MCP apagadas de fábrica ## Qué hace API v4, webhooks y MCP ### API v4, REST y documentada Documentos, clientes y contactos, activos, proyectos con sus partidas, checklists y adjuntos. El esquema OpenAPI se navega y permite probar las llamadas antes de programar nada. ### Permisos por clave Una clave por integración, con permisos por área y por operación. Las operaciones se agrupan en paquetes: solo lectura, campo, comercial, ERP y asistente de IA. Caducidad, límite de peticiones y revocación. ### Cuentas de sistema Tus integraciones entran con cuentas de sistema, que no consumen licencia. Cada una tiene solo los permisos que necesita, y la lista blanca se comprueba en cada petición. ### Webhooks en los dos sentidos De salida, para avisar a tus sistemas cuando algo pasa, con historial y reenvío. De entrada, para que un sistema externo lance un flujo. Y un paso de los flujos llama a cualquier API sin programar. ### Servidor MCP Conecta tu asistente, como Claude o ChatGPT, y pregunta por documentos, clientes o activos. Responde con lo que esa persona puede ver y cita de dónde lo saca. Las escrituras vienen apagadas. ### Cliente MCP attendo también se conecta a servidores MCP de terceros. Desde un flujo o desde la ficha, un agente pregunta a tu ERP si hay stock de una pieza. La respuesta entra en su contestación. ## Paso a paso Así se usa en el día a día, sobre el mismo documento que el resto de módulos. ### Paso 1 · Creas la clave Con el paquete de operaciones que necesita la integración, su caducidad y su límite. ### Paso 2 · Pruebas en preproducción Con el esquema OpenAPI y una instancia de preproducción, antes de tocar datos reales. ### Paso 3 · Conectas tus sistemas Por API, por webhook o con un paso de los flujos que llama a su API. ### Paso 4 · Lo sigues Cada webhook de salida guarda su historial, y se reenvía si hace falta. ### marIA en API v4, webhooks y MCP Con el servidor MCP, tu asistente de IA consulta attendo con los permisos de cada persona. Y como cliente MCP, marIA pregunta desde la ficha a tu ERP o a otros servidores MCP. Cada operación de marIA queda registrada con quién la lanzó, el modelo y su coste. ## Encaja en cada área Soluciones sectoriales [attendo GMAO](https://attendo.me/gmao) [attendo CRM](https://attendo.me/crm) [attendo Field Service](https://attendo.me/field-service) [attendo SAT](https://attendo.me/sat) [attendo Ticketing](https://attendo.me/ticketing) [attendo Flows](https://attendo.me/flows) ### Sectores que lo usan - [Servicios TIC y soporte](https://attendo.me/sectores/servicios-tic): El inventario del cliente, con su historial - [Energía y renovables](https://attendo.me/sectores/energia): Cada equipo, con su garantía y sus lecturas - [Y cualquier otra empresa](https://attendo.me/sectores): attendo se configura para cualquier actividad. Ver todos los sectores ## Dónde encaja (y dónde no) - La configuración de la instancia no se hace por API: tipos de documento, campos, permisos y flujos se configuran en la interfaz. - No hay un límite de peticiones publicado, pero sí control de abuso. Si vas a mover mucho volumen, lo dimensionamos contigo. ## Módulos que van de la mano ### [Integraciones con ERP](https://attendo.me/modulos/erp) Odoo, SAP Business One, Business Central y Holded, conectados ### [attendo Flows, Business Process Flow (BPF) y AI-Flows](https://attendo.me/modulos/flows) Flujos, procesos con fases y aprobaciones, e IA dentro del flujo ### [AI-Chat y DB Assistant](https://attendo.me/modulos/ai-chat) Pregunta en castellano. Responde con tus datos y enseña de dónde. ## Términos del glosario Procesos y automatización ### Webhook Retrollamada HTTP · HTTP callback Un webhook es un aviso automático que un sistema envía a otro, a una dirección web, en cuanto ocurre algo: un pedido nuevo, un pago o un documento aprobado. Mantenimiento ### Mantenimiento predictivo El mantenimiento predictivo decide cuándo intervenir según el estado real del equipo, medido con la vibración, la temperatura, el consumo o el análisis de aceite, y no por calendario. Mantenimiento ### Repuesto crítico Un repuesto crítico es la pieza cuya falta detiene la reparación y alarga la parada del equipo. No es la más cara ni la que más se gasta: es la que no puedes conseguir rápido. [Ver los 53 términos del glosario](https://attendo.me/glosario) ## Preguntas frecuentes ### ¿Está documentada la API? Sí. La API v4 tiene un esquema OpenAPI navegable en el que puedes probar las llamadas. ### ¿Qué pasa si se filtra una clave? Solo puede hacer las operaciones de su lista blanca, y la revocas sin tocar las demás. El daño posible es el que decidiste al crearla. ### ¿Qué diferencia hay entre el servidor MCP y el cliente MCP? El servidor deja que tu asistente consulte attendo. El cliente hace lo contrario: attendo se conecta a servidores MCP de terceros y los consulta desde un flujo o desde la ficha. ### ¿Puede mi asistente de IA modificar datos por MCP? No de fábrica. Las escrituras vienen apagadas, y activarlas exige un doble cerrojo. ### ¿Puedo probar antes de conectar producción? Sí. Se prepara una instancia de preproducción para que pruebes tu integración. ## Pruébalo con tus procesos Te enseñamos API v4, webhooks y MCP con tus tipos de documento y tu forma de trabajar. Si no encaja, te lo diremos nosotros. - Con tu operación, no con una demo genérica - Te contesta una persona del equipo - Sin llamadas frías después ¿Prefieres hablar antes? - Teléfono [+34 910 053 530](tel:+34910053530) - Correo [sales@attendo.me](mailto:sales@attendo.me) - De lunes a jueves de 9:30 a 18:30 y los viernes de 9:30 a 14:30