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 (cuando esté 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
Funciona hoy en todos los clientes de Claude. 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 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.
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.
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. |