Qué te permite
Una vez conectado, puedes pedirle a Claude que trabaje con los datos de tu cuenta de Holded en lenguaje natural. Por ejemplo:
Consultar y listar facturas, presupuestos y tickets
Buscar contactos y revisar sus datos
Consultar productos, stock y almacenes
Revisar gastos y compras
Generar resúmenes rápidos de tus datos de ventas o contabilidad
⚠️Requisito previo: una cuenta de Holded con acceso a la API activado.
Opción A — Instalar desde el Directorio de Conectores (Todavía no disponible)
La forma más rápida, una vez que Holded esté publicado en el directorio de Anthropic:
Abre claude.ai → Personalizar → Conectores
Busca "Holded"
Haz clic en Conectar
Inicia sesión en Holded y autoriza el acceso
Listo
Esta opción estará disponible cuando Holded se publique en el Directorio de Conectores de Anthropic.
Opción B — Instalación manual con la URL
Ya disponible. Solo necesitas una URL:
https://mcp.holded.com/mcp
No hace falta archivos de configuración ni JSON: Claude se encarga automáticamente del descubrimiento, el registro y el inicio de sesión.
Quién puede añadir el conector:
Planes Free, Pro y Max: puedes añadirlo tú mismo desde Personalizar → Conectores. (En Plan Free solo puedes tener un conector personalizado)
Planes Team y Enterprise: un Propietario (Owner) de la organización debe añadirlo primero en Configuración de la organización → Conectores. A partir de ahí, cada miembro puede conectarlo desde Personalizar → Conectores.
Claude.ai (web)
Abre claude.ai → icono de perfil → Personalizar → Conectores
Haz clic en "+" → Añadir conector personalizado
Pega
https://mcp.holded.com/mcpHaz clic en Conectar: el navegador te redirige al inicio de sesión de Holded
Autoriza el acceso y listo
Claude Desktop
Abre Claude Desktop → Ajustes → Conectores
Haz clic en Añadir conector personalizado
Pega
https://mcp.holded.com/mcpSe abre el navegador: inicia sesión, autoriza y listo
Claude Code (CLI)
bash
claude mcp add --transport http holded https://mcp.holded.com/mcp
El navegador se abre para autorizar la primera vez que lo uses.
Uso con otros asistentes de IA
La conexión de Holded está construida sobre MCP, un estándar abierto, así que no se limita a Claude. Cualquier asistente de IA que admita conectores MCP remotos puede usar la misma URL:
https://mcp.holded.com/mcp
ChatGPT (planes Plus, Pro, Enterprise, Business o Edu)
Abre ChatGPT → Ajustes → activa el Modo desarrollador
Ve a Apps y Conectores → Añadir / Crear app
Introduce la URL del servidor
https://mcp.holded.com/mcpCompleta el inicio de sesión de Holded y autoriza el acceso
El acceso de escritura en ChatGPT puede requerir un plan Business, Enterprise o Edu.
Otros asistentes (Gemini, Cursor y otros): busca la opción de añadir un servidor MCP remoto o conector personalizado, pega la misma URL y autoriza cuando te lo pida.
Los nombres de los menús y los pasos exactos varían según el asistente y pueden cambiar con el tiempo: consulta la documentación de tu asistente si algo no coincide.
Comprueba que funciona
Pídele a Claude algo como:
"Lista mis facturas de Holded"
"Muéstrame mis contactos"
Claude usará las herramientas de Holded para traer datos reales de tu cuenta.
Gestionar la conexión
Desconectar: Personalizar → Conectores → haz clic en Holded → Desconectar
Volver a conectar: repite los pasos de instalación anteriores
☝🏼Sobre el token de acceso: al conectar, Holded crea automáticamente un token de acceso con exactamente los permisos que hayas concedido durante la autorización. Puedes revisarlo en cualquier momento en Holded, en Desarrolladores → Credenciales.
Resolución de problemas
Problema | Qué hacer |
0 herramientas visibles | Puede que tu cuenta de Holded no tenga los permisos necesarios. Revisa el acceso a la API y los permisos de tu cuenta. |
Sesión no encontrada | Desconecta y vuelve a conectar. |
Error de OAuth | Asegúrate de que tu cuenta de Holded tiene el acceso a la API activado. |
Permisos: qué puede acceder Claude
Al autorizar la conexión verás una pantalla de permisos donde eliges qué puede hacer Claude con tu cuenta (recomendamos empezar con solo lectura).
Solo verás las áreas a las que ya tienes acceso. La pantalla hereda los permisos de tu usuario de Holded: no puedes concederle a Claude un permiso que tú no tengas. Por ejemplo, si tu usuario no tiene acceso a Inventario, esa área no aparecerá y Claude tampoco podrá acceder a ella.
Perfiles de permisos del MCP de Holded
Cuando conectas un asistente de IA (como Claude) a Holded mediante el MCP, eliges qué puede hacer con tus datos. Para ponértelo fácil, ofrecemos dos perfiles recomendados. En ambos casos, el asistente nunca podrá acceder a más de lo que tu propio usuario ya puede ver o hacer en Holded.
1. Analítico: Solo lectura (recomendado)
Viene preseleccionado. El asistente puede consultar y analizar tus datos —facturas, tesorería, stock, contactos, contabilidad…— pero no puede modificar nada. Ideal para preguntar, revisar y sacar informes sin ningún riesgo.
Por seguridad, dejamos fuera por defecto unas pocas áreas sensibles: tokens de desarrollador, nóminas y mandatos/remesas bancarias. Si las necesitas, puedes añadirlas tú manualmente.
2. Operativo: Lectura y escritura.
Añade capacidad de escritura, pero solo en tareas operativas y reversibles, y siempre tras un aviso y una confirmación por tu parte.
La idea es sencilla: la IA redacta y organiza; tú emites y cobras. Todo lo que mueve dinero, tiene efecto fiscal o afecta a personas se queda en solo lectura.
El asistente puede crear y editar:
Contactos
CRM y pipeline: oportunidades, eventos, embudos, reservas y actividades
Presupuestos y proformas (borradores que tú conviertes en factura)
Proyectos
Inventario operativo: productos, almacenes, pedidos de venta y compra, envíos y órdenes de producción
Bandeja de entrada (subir documentos a procesar) y etiquetas
Se queda siempre en solo lectura:
Contabilidad: asientos, remesas, impuestos/AEAT, pagos y nóminas
Facturas y documentos fiscales: facturas, tickets, SII, factura electrónica y TPV
Equipo y RRHH
Ajustes y configuración
Herramientas de desarrollador y administración del sistema
Firma digital y todo lo que fija precios o facturación
Personalizar los permisos (avanzado)
Además de los dos perfiles recomendados, puedes ajustar los permisos a tu medida con dos modos:
Permiso global: aplica el mismo nivel —ninguno, solo lectura o lectura y escritura— a todas las áreas de golpe.
Permiso por áreas: define el nivel de acceso para cada área por separado (Ventas, Contactos, CRM, Proyectos, Contabilidad, Inventario, Equipo…). Así puedes, por ejemplo, dar solo lectura a todo y activar la escritura únicamente en Contactos.
En todos los casos, el asistente sigue limitado a lo que tu usuario ya puede hacer en Holded.
¿Necesitas que la IA escriba en un área que está en solo lectura (por ejemplo, crear asientos contables)? Desde Permiso por áreas puedes activar la escritura solo en esa área, bajo tu responsabilidad. Los perfiles recomendados no lo incluyen por el riesgo que conlleva.
¿Cuál elijo?
Empieza siempre por Solo lectura. Cubre la mayoría de casos: consultar, analizar y sacar informes.
Pasa a Lectura y escritura solo si quieres que la IA te prepare tareas operativas (crear contactos, mover oportunidades, montar presupuestos…).
¿Necesitas un control más fino? Usa Permiso por áreas para activar la escritura solo donde te haga falta.
