Ir al contenido principal

Conecta Holded con IA

Conecta tu cuenta de Holded con IA y gestiona tu día a día directamente desde una conversación, sin escribir una línea de código.

Escrito por Natalia López

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:

  1. Abre claude.ai → Personalizar → Conectores

  2. Busca "Holded"

  3. Haz clic en Conectar

  4. Inicia sesión en Holded y autoriza el acceso

  5. 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)

  1. Abre claude.ai → icono de perfil → Personalizar → Conectores

  2. Haz clic en "+" → Añadir conector personalizado

  3. Pega https://mcp.holded.com/mcp

  4. Haz clic en Conectar: el navegador te redirige al inicio de sesión de Holded

  5. Autoriza el acceso y listo

Claude Desktop

  1. Abre Claude Desktop → Ajustes → Conectores

  2. Haz clic en Añadir conector personalizado

  3. Pega https://mcp.holded.com/mcp

  4. Se 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)

  1. Abre ChatGPT → Ajustes → activa el Modo desarrollador

  2. Ve a Apps y Conectores → Añadir / Crear app

  3. Introduce la URL del servidor https://mcp.holded.com/mcp

  4. Completa 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.

¿Ha quedado contestada tu pregunta?