Что нужно заранее
- Holded: аккаунт компании на платном тарифе или в бесплатном пробном периоде (prueba gratuita). API Holded нет в бесплатном тарифе, а подключение работает через него.
- Доступ к разделу «Desarrolladores» (разработчики) в Holded — обычно он есть у владельца или администратора компании.
- Claude: подходит любой тариф, включая бесплатный, где можно добавить один свой коннектор. В Team и Enterprise коннектор сначала добавляет владелец организации.
isaak.pro — независимый сервис Verifactu Business, партнёра Holded (Solution Partner); его разрабатывает не Holded. Первая подключённая компания бесплатна, а лицензия Holded оплачивается отдельно, у самого Holded. Если вы ещё не знакомы с Holded, начните со статьи Что такое Holded?.
Шаг 1: создайте ключ Holded
API-ключ (API Token) позволяет коннектору читать данные компании. У каждой компании свой ключ: ключ бухгалтерской фирмы (asesoría) не даёт доступа к её клиентам.
- В Holded откройте Configuración → Desarrolladores → Credenciales (настройки → разработчики → учётные данные).
- Нажмите «+ Agregar API Token» и выберите права «Por áreas» (по разделам).
- Отметьте нужные разделы. С правом «Leer» (чтение) Claude только смотрит данные; с «Full» он ещё и готовит черновики (borrador), которые подтверждаете вы.
- Сразу скопируйте ключ целиком: он начинается с pat_, и полностью Holded его больше не покажет.
Подробная инструкция со скриншотами — в статье Как создать ключ Holded (на испанском), а какие права нужны каждой функции — в статье Права ключа API Holded. Обязательно отметьте «Cuenta → Información de la cuenta: Leer»: так компанию можно определить и не перепутать с другой.
Шаг 2: добавьте коннектор в Claude
- В Claude откройте Настройки → Коннекторы.
- Нажмите «Добавить свой коннектор».
- Укажите название, например «Holded», и вставьте адрес коннектора: https://isaak.pro/mcp
- Нажмите «Добавить», а затем «Подключить».
Claude и ChatGPT используют один и тот же адрес и одинаковые функции. Если хотите работать и в ChatGPT, смотрите Как подключить Holded к ChatGPT.
Шаг 3: разрешите доступ к компании (или ко всем)
После нажатия «Подключить» откроется isaak.pro. Войдите по email, вставьте ключ Holded и проверьте, что название и налоговый номер (CIF) — вашей компании. Затем разрешите доступ Claude. Экран разрешения на испанском.
Если у вас несколько компаний, перед разрешением нажмите «Conectar otra empresa» (подключить другую компанию) и вставьте ключ каждой. В конце выберите «Autorizar con todas mis empresas» (разрешить для всех моих компаний). В разговоре называйте компанию по имени или по CIF. Для бухгалтерских фирм подробности — в статье весь портфель Holded в одном чате.
Ключ хранится в isaak.pro в зашифрованном виде и никогда не передаётся Claude: Claude получает собственный доступ, который можно отозвать в панели isaak.pro или удалив ключ в Holded.
Первые вопросы, чтобы проверить работу
- «С какими компаниями ты можешь работать?»
- «Isaak, что у меня на сегодня?» — сводка: неоплаченные счета (facturas), покупки к оплате, несверенные банковские операции и ближайшие налоговые сроки.
- «Какие счета просрочены и кто должен больше всех?»
- «Какие банковские операции за этот месяц не сверены и с какими счетами они совпадают?»
- «Подготовь черновик счёта для Retail Plus: 3 часа консультаций по 60 € в час.»
Больше идей — в статье 12 вопросов, которые можно задать своему Holded с помощью ИИ.
Что коннектор делает и чего не делает
- Показывает продажи, покупки, банки, контакты, бухгалтерию и настроенные в Holded налоги.
- Готовит черновики счетов, контактов, проводок и банковской сверки (conciliación); каждое изменение подтверждаете вы.
- Никогда не удаляет данные и не делает платежей или переводов.
- Не подаёт налоговые декларации. Оценки, например декларации по НДС, модель 303 (IVA, modelo 303), ориентировочные: проверяете и подаёте вы.
Isaak помогает смотреть и готовить информацию, но не заменяет проверку специалиста. По налогам и конкретным ситуациям советуйтесь со своим консультантом-бухгалтером (asesor).
Если что-то не работает
- «Не хватает права»: отредактируйте ключ в Holded и поставьте для этого раздела «Leer» или «Full». Новый ключ не нужен. «Escribir» (запись) не включает «Leer» (чтение).
- «Старый ключ»: коннектор принимает только новые ключи, которые начинаются с pat_. Создайте ключ в Credenciales, а не в «Api Keys v1».
- В «Desarrolladores» есть только «Webhooks»: так бывает у компаний, которые ведёт бухгалтерская фирма без собственной лицензии Holded; без своей лицензии ключ создать нельзя.
Остальные сообщения и что с ними делать — в статье сообщения об ошибках и как их исправить (на испанском).