Holded MCP: cómo conectar Holded con tu asistente de IA.
Conectar Holded a Claude o ChatGPT son cinco minutos. Hacerlo con el usuario y los permisos correctos es lo que evita sustos. Esta es la guía práctica.
01 · TL;DR
Holded MCP es la forma de conectar tu cuenta de Holded a un asistente de IA (Claude, ChatGPT, Claude Code, Cursor y otros clientes compatibles) para que pueda consultar y, si lo autorizas, crear documentos en tu nombre. Hay dos caminos: el servidor MCP oficial de Holded, remoto y con acceso por OAuth, y los servidores de la comunidad, que se instalan en tu ordenador y funcionan con tu clave API. Para una empresa, el oficial es casi siempre la opción correcta, porque el asistente hereda los permisos de un usuario concreto y no hay que entregar una clave con acceso total. Esta guía es la parte práctica: cómo conectarlo en cada cliente, qué usuario usar, qué permisos dar, cómo probarlo y qué hacer cuando falla. Si buscas qué aporta la IA en Holded en general, lo tienes en Holded con IA. Datos a octubre de 2026; Holded y los asistentes cambian estas pantallas a menudo, así que confirma los detalles en su documentación.
02 · MCP oficial o servidor de la comunidad
Si buscas "holded mcp" en GitHub o en directorios de servidores, verás varios proyectos. No son lo mismo que el servidor oficial, y la diferencia importa más de lo que parece:
| Aspecto | MCP oficial de Holded | Servidores de la comunidad |
|---|---|---|
| Dónde corre | Remoto, en https://mcp.holded.com/mcp | En tu ordenador o en un servidor tuyo |
| Cómo se autentica | OAuth con tu usuario de Holded | Clave API de la cuenta |
| Qué ve el asistente | Lo que puede ver ese usuario | Todo lo que permite la clave, que suele ser todo |
| Mantenimiento | Lo actualiza Holded | Depende de quien lo publicó |
| Cuándo tiene sentido | Uso diario en una empresa | Pruebas técnicas o cuando necesitas limitar módulos a mano |
Algunos servidores de la comunidad permiten restringir módulos o dejarlos en solo lectura con variables de configuración, y están bien hechos. El problema no es la calidad del código, es que una clave API de Holded abre la cuenta entera y queda guardada en un archivo de configuración del ordenador de quien lo instaló. Si esa persona se va o pierde el portátil, hay que rotar la clave y reconfigurar todo lo que la usaba. La clave y sus usos los explicamos en la API de Holded.
03 · Cómo conectarlo, paso a paso
El proceso es parecido en todos los clientes: añades la dirección del servidor, se abre el navegador, inicias sesión en Holded y autorizas. Lo que cambia es dónde está el botón:
- Claude (web y escritorio). En la configuración, apartado de conectores, añade un conector personalizado con la URL
https://mcp.holded.com/mcp. En planes de equipo, normalmente lo añade un administrador de la organización y luego cada persona lo activa con su propio usuario de Holded. - Claude Code. Desde la terminal:
claude mcp add --transport http holded https://mcp.holded.com/mcp. La primera vez que lo uses te pedirá autorizar en el navegador. - ChatGPT. Admite conectores MCP personalizados desde la configuración de la cuenta, con disponibilidad que depende del plan y de si tu espacio de trabajo tiene activado el modo para desarrolladores. Si no ves la opción, es tema de plan o de permisos del administrador, no de Holded.
- Cursor y otros editores. Se añade como servidor MCP remoto por HTTP en su archivo o pantalla de configuración de MCP, con la misma URL.
Un detalle que ahorra tiempo: si trabajas con varias empresas en Holded, comprueba en qué cuenta estás cuando autorizas. El asistente trabajará sobre la empresa que elijas en ese momento, y cambiar luego suele requerir desconectar y volver a autorizar.
04 · Usuario, rol y permisos: la parte que importa
El asistente hace lo que puede hacer el usuario que lo autoriza. Si conectas con la cuenta del administrador, tienes un asistente administrador. Por eso, antes de conectar nada, decide con qué usuario se hará:
- Un usuario por persona. Cada miembro del equipo conecta el asistente con su propio usuario de Holded. Así el registro de actividad dice quién hizo qué, aunque lo haya preparado la IA.
- Roles ajustados. Si alguien de comercial solo necesita contactos, presupuestos y CRM, su rol en Holded no debería incluir contabilidad ni tesorería. El asistente respetará ese límite sin que tengas que configurar nada más.
- Lectura primero. Al autorizar, empieza solo con herramientas de consulta. Dos o tres semanas de preguntas reales te dirán qué tareas de escritura merece la pena habilitar.
- Escritura con confirmación. Las herramientas que crean o modifican datos están marcadas como tales y el cliente debe pedir confirmación antes de usarlas. No actives en el cliente las opciones de "aprobar siempre" para herramientas de escritura.
Y una cuestión de protección de datos que no es técnica: los datos que el asistente consulta pasan por el proveedor de IA. Revisa qué plan usáis, si permite excluir los datos del entrenamiento y si está cubierto por vuestro contrato de encargado de tratamiento.
05 · Primeras pruebas que recomendamos
Para validar que la conexión funciona y entender qué responde bien, usamos siempre la misma batería, de menos a más riesgo:
| Prueba | Ejemplo de petición | Qué comprobar |
|---|---|---|
| Lectura simple | "Lista mis cinco últimas facturas emitidas" | Que los números coinciden con Holded |
| Filtro por fechas | "Facturación del tercer trimestre por cliente" | Que usa fecha de factura y no de creación |
| Cruce | "Clientes con facturas vencidas hace más de 60 días" | Que no se deja cobros parciales fuera |
| Escritura en borrador | "Prepara un presupuesto como el último de este cliente" | Que pide confirmación y lo deja en borrador |
En listados largos, el asistente trabaja por páginas y a veces se queda con la primera. Si un total te parece bajo, pídele que confirme que ha recorrido todas las páginas. Para cifras que van a un cierre, a un impuesto o al banco, el dato bueno sigue siendo el informe de Holded.
06 · Problemas habituales y cómo resolverlos
- "No encuentra datos que sí existen". Casi siempre es el rol del usuario o la empresa equivocada. Prueba la misma consulta en Holded con ese usuario.
- La autorización caduca. Los accesos OAuth expiran o se revocan si cambias la contraseña o los permisos. Desconecta y vuelve a autorizar.
- Respuestas lentas o cortadas. Las consultas que recorren miles de documentos tardan. Acota por fechas o por cliente.
- El asistente elige la herramienta equivocada. Con cientos de herramientas disponibles, ayuda ser concreto: "facturas de venta" y no "documentos", "presupuestos" y no "ofertas".
- Cambios que no esperabas. Revisa el registro de actividad de Holded y, si hace falta, retira los permisos de escritura hasta entender qué pasó.
07 · MCP y Verifactu
Con Verifactu, una factura emitida no se edita: se rectifica. Si das al asistente permiso para emitir facturas, un error ya no se arregla borrando. El calendario legal vigente es el del RD-ley 15/2025: obligatorio desde el 1 de enero de 2027 para sociedades y desde el 1 de julio de 2027 para autónomos; en 2026 es voluntario. El 5 de octubre de 2026 Hacienda anunció su intención de aplazarlo a octubre de 2028, pero ese cambio necesita una norma que, a fecha de hoy, no hemos visto publicada en el BOE. La factura la sigue emitiendo Holded, que es el programa adaptado, aunque el borrador lo prepare un asistente. Nuestra recomendación: que el asistente prepare borradores y una persona los emita. Cómo cumple Holded lo tienes en Holded y Verifactu.
08 · Cuándo el MCP no es la herramienta
El asistente conectado por MCP brilla en preguntas puntuales y tareas que alguien lanza a mano. No es la herramienta para lo que se repite cada día con las mismas reglas: registrar las facturas que llegan al correo, conciliar cobros, avisar de impagados o sincronizar Holded con otro programa. Ahí compensa una automatización que corra sola, deje registro y mande a revisión solo lo que no cuadra. Las dos piezas usan la misma API y conviven bien. Ejemplos concretos en automatizar Holded y, si el proceso no encaja en ninguna herramienta estándar, en automatización de procesos con IA.
Como partner de Holded, conectamos el asistente con usuarios y permisos bien planteados, formamos al equipo en las primeras consultas y vemos qué tareas merece la pena automatizar del todo. Habla con un partner de Holded →
09 · Preguntas frecuentes
¿Qué es Holded MCP?
Es un servidor que conecta tu cuenta de Holded con asistentes de IA compatibles con el Model Context Protocol, como Claude o ChatGPT, para que puedan consultar datos y, si lo autorizas, crear documentos en tu nombre.
¿Es mejor el MCP oficial de Holded o uno de la comunidad?
Para uso en empresa, el oficial: se autentica con OAuth y el asistente hereda los permisos de un usuario concreto. Los de la comunidad funcionan con la clave API, que suele dar acceso a toda la cuenta y queda guardada en el ordenador de quien lo instala.
¿Puede el asistente emitir facturas en Holded?
Técnicamente sí, si le das permisos de escritura. Recomendamos que prepare borradores y que una persona los emita, porque con Verifactu una factura emitida no se edita, se rectifica.
¿Qué permisos conviene dar al conectar Holded con un asistente?
Empezar solo con lectura, usar un usuario por persona con un rol ajustado a lo que necesita y mantener la confirmación manual en todas las herramientas que crean o modifican datos.
¿Quieres usar Holded desde tu asistente de IA sin abrirle toda la cuenta? Lo conectamos contigo, con usuarios y permisos bien planteados. Solicitar diagnóstico →