Qué necesitas antes de empezar
- Holded: la cuenta de la empresa con un plan de pago o en prueba. La API de Holded no está en el plan gratuito, y la conexión la usa.
- Acceso al apartado «Desarrolladores» de Holded, que normalmente tiene el propietario o un administrador de la empresa.
- Claude: sirve cualquier plan, también la cuenta gratuita, que admite un conector personalizado. En Team y Enterprise el conector lo añade primero un propietario de la organización.
isaak.pro es un servicio independiente de Verifactu Business, Solution Partner de Holded; no lo desarrolla Holded. La primera empresa conectada es gratis y la licencia de Holded se contrata aparte, con Holded. Si todavía no usas Holded, empieza por ¿Qué es Holded?.
Paso 1: crea la clave de Holded
La clave (API Token) es lo que permite al conector leer los datos de la empresa. Cada empresa tiene la suya: la clave de una asesoría no da acceso a sus clientes.
- En Holded, entra en Configuración → Desarrolladores → Credenciales.
- Pulsa «+ Agregar API Token» y elige permisos «Por áreas».
- Marca las áreas que quieras consultar. Con «Leer», Claude solo consulta; con «Full», además puede preparar borradores que tú confirmas.
- Copia la clave completa en ese momento: empieza por pat_ y Holded no vuelve a enseñarla entera.
Tienes el detalle con capturas en Crear la clave de Holded y qué permiso necesita cada función en Permisos de Holded para el conector. Marca al menos «Cuenta → Información de la cuenta: Leer», que sirve para identificar la empresa sin confundirla con otra.
Paso 2: añade el conector en Claude
- En Claude, abre Personalizar → Conectores.
- Pulsa «Añadir conector personalizado».
- Ponle un nombre, por ejemplo «Holded», y pega la dirección del conector: https://isaak.pro/mcp
- Pulsa «Añadir» y después «Conectar».
Claude y ChatGPT usan la misma dirección y las mismas funciones. Si también quieres usarlo en ChatGPT, sigue Cómo conectar Holded con ChatGPT.
Paso 3: autoriza tu empresa (o todas)
Al pulsar «Conectar» se abre isaak.pro. Entras con tu email, pegas la clave de Holded y compruebas que el nombre y el CIF son los de tu empresa. Después autorizas a Claude.
Si llevas varias empresas, antes de autorizar pulsa «Conectar otra empresa» y pega la clave de cada una. Al final elige «Autorizar con todas mis empresas». En la conversación, di de qué empresa hablas por su nombre o su CIF. Para asesorías, el detalle está en Asesorías: toda la cartera de Holded en un solo chat.
La clave se guarda cifrada en isaak.pro y nunca se envía a Claude: Claude recibe un acceso propio que puedes revocar desde el panel de isaak.pro o borrando la clave en Holded.
Primeras preguntas para comprobar que funciona
- «¿Con qué empresas puedes trabajar?»
- «Isaak, ponme al día»: un resumen con facturas sin cobrar, compras pendientes de pago, banco sin conciliar y próximos plazos de impuestos.
- «¿Qué facturas tengo vencidas y quién me debe más?»
- «¿Qué movimientos del banco de este mes están sin conciliar y con qué facturas cuadran?»
- «Prepara un borrador de factura para Retail Plus por 3 horas de consultoría a 60 € la hora.»
Tienes más ideas en 12 preguntas que puedes hacerle a tu Holded con IA.
Qué hace y qué no hace
- Consulta ventas, compras, bancos, contactos, contabilidad e impuestos configurados en Holded.
- Prepara borradores de factura, contactos, asientos y conciliaciones; cada cambio lo confirmas tú.
- Nunca borra datos ni hace pagos o transferencias.
- No presenta impuestos. Las estimaciones, como el IVA del trimestre, son orientativas: tú revisas y presentas.
Isaak te ayuda a consultar y preparar la información, pero no sustituye una revisión profesional. Para impuestos y casos concretos, consulta con tu asesoría.
Si algo no funciona
- «Falta este permiso»: edita la clave en Holded y pon esa área en «Leer» o «Full». No hace falta crear otra clave. Recuerda que «Escribir» no incluye «Leer».
- «Clave antigua»: el conector solo acepta las claves nuevas, que empiezan por pat_. Crea una en Credenciales, no en «Api Keys v1».
- En «Desarrolladores» solo aparece «Webhooks»: suele pasar en empresas gestionadas por una asesoría sin licencia propia de Holded; sin licencia propia no se puede crear la clave.
El resto de avisos y qué hacer con cada uno están en Mensajes de error y cómo resolverlos.