HelomiWIKI

Остап — ваш Claude, ChatGPT, Kimi чи Gemini у CRM

Остап — другий мозок Helomi (поруч із Ломі): ваш власний Claude, ChatGPT, Kimi чи Gemini, який працює в CRM з правами окремого ШІ-співробітника. Скачуєте файл сесії, кидаєте його у свій чат — ШІ запам'ятовує його, заходить у Helomi і робить те, що попросить той, хто кинув файл: знаходить угоду, створює задачу чи документ, керує програмами й агентами CRM. Ключ API організації не потрібен — думає ваша підписка; для Claude Code, Cursor та інших клієнтів MCP — адреса й токен; для своєї програми — REST.

9 хвОновлено 25.10.2026
Markdown для ШІ
На цій сторінці

Можливості

Що у васЯк підключитиКлюч API потрібен?
Застосунок Claude (claude.ai, ПК, телефон)Файл сесії → навичка .zipні
ChatGPT, Kimi, GeminiФайл сесії → .md у чат, інструкції GPT чи Gem; для ChatGPT — ще GPT Actions через OpenAPIні
Claude Code, Cursor, інший клієнт MCPАдреса <сайт>/mcp + заголовок Authorization: Bearer <токен>ні
Чат прямо в пульті HelomiКлюч організації в ІнтеграціїШІ«Інтеграції → ШІ»так

Хоч би як ви підключились, ШІ бачить лише розділи з «Доступів і лімітів» свого співробітника, обов'язкові поля й воронки діють для нього так само, як для людини, а небезпечні дії чекають «Підтвердити». Налаштування перевізників у «Інтеграціях» — лише з дозволом «Налаштування інтеграцій» у «Доступах і лімітах» цього співробітника (Ломі, Остап, «Claude · сесія», ваш агент — однаково), і кожна така зміна чекає «Підтвердити» адміністратора; ключі й токени ШІ не бачить. Файл сесії, створений до видачі дозволу, інструментів інтеграцій у переліку не має — створіть його заново (інструменти за токеном оновлюються одразу).

1Підключити Остапа

Свого Остапа може мати кожна людина: це окремий ШІ-співробітник зі своїм ключем, доступами й журналом.

  1. ІнтеграціїШІ«Інтеграції → ШІ» → картка «Остап — ваш Claude, ChatGPT, Kimi чи Gemini у CRM» → «Підключити» (або НалаштуванняКомандаШІ-співробітникиДодатиОстап — свій ШІ«Налаштування → Команда → ШІ-співробітники → Додати → Остап — свій ШІ»). Назва типово «Остап» — можна дати свою («Остап Олександра»); так ШІ підписаний у журналі угод і клієнтів.
  2. Прочитайте «Відповідальність», поставте «Розумію» → «Підключити».
  3. Відкриються налаштування Остапа на вкладці «API»: головна дія — чорна «Створити ключ і завантажити файл» (розділ 2). Перевірте НалаштуванняДоступи й ліміти«Налаштування → Доступи й ліміти»: які розділи відкрити й що «Спочатку запитати».
  4. Своє доповнення до інструкції («пиши мені коротко», «рахуй у доларах») — НалаштуванняХарактерМоє доповнення до інструкції«Налаштування → Характер → Моє доповнення до інструкції», вкладка «Для мене»: воно потрапить у наступний файл сесії.

Остап має ті самі доступи, що й Ломі: угоди, клієнти, задачі, склад, документи, фінанси, закупівлі, доставки й «Вхід для ШІ» програм і агентів (Віктор, Ростік, Марія, Артур…). Наявні раніше зовнішні ШІ («Claude Олександра», «Claude · сесія») лишаються зі своїми назвами — це теж мозок, як Остап. Підключає адміністратор організації (або той, хто додав співробітника).

2Застосунок Claude за підпискою — файл сесії

  1. Налаштування співробітника (кружечок «Налаштування» або «Інтеграції → ШІ → «Відкрити»» для Остапа) → вкладка «API» → блок «Файл сесії — підключити свій чат без ключа API» → «Claude» → «Створити ключ і завантажити файл».
  2. Завантажиться пакет навички: для Остапа — helomi-ostap-claude-skill.zip, для Ломі — helomi-lomi-claude-skill.zip. Усередині — опис співробітника (для Ломі — її персона й налаштування), перелік інструментів, адреса сайту і ключ.
  3. У застосунку Claude: НалаштуванняМожливостіНавичкиЗавантажити«Налаштування → Можливості → Навички → Завантажити» і виберіть цей zip. Ту саму навичку можна покласти в теку сесії Claude Code чи Cowork.
  4. Пишіть або кажіть Claude: «Покажи прострочені угоди в Helomi», «Ломі, створи задачу на завтра по угоді 4321».

Ключ у файлі діє як пароль: не пересилайте файл стороннім. Він з'являється на вкладці «API» в таблиці «Токени · N» з назвою «Файл сесії Claude …» і відкликається там же.

Чому не «Connectors»: застосунок claude.ai у «Connectors» не дає вписати заголовок з токеном, тому для нього — навичка, а не адреса MCP. Підказка у шторці «Додати» для Claude досі радить SettingsConnectors«Settings → Connectors».

3ChatGPT, Kimi, Gemini — файл .md або GPT Actions

Файл .md. Той самий блок «Файл сесії» → «ChatGPT», «Kimi» або «Gemini» → «Створити ключ і завантажити файл». Прикріпіть файл у чат, в інструкції свого GPT або в Gem. У файлі — та сама персона, адреса й ключ, а виклики інструментів описані запитами curl.

GPT Actions (ChatGPT). APIТокениНовий токен«API → Токени → Новий токен» → скопіюйте токен. У GPT → Actions → імпорт за адресою OpenAPI з блоку «Адреси й інструкція», авторизація — API key, тип Bearer, вставте токен. Попросіть, наприклад, знайти клієнта за телефоном.

Kimi через MCP. Kimi → MCP-сервери → додати: адреса MCP і токен у заголовку Authorization: Bearer.

4Claude Code, Cursor, будь-який клієнт MCP

  1. APIТокени«API → Токени» → назва (наприклад, «Ноутбук») → «Новий токен» → скопіюйте одразу: він показується один раз.
  2. Адреса MCP — у блоці «Адреси й інструкція» («Скопіювати»), вигляду <сайт>/mcp.
  3. Додайте сервер у клієнт із заголовком Authorization: Bearer <токен>. Для Claude Code: claude mcp add --transport http helomi <сайт>/mcp --header "Authorization: Bearer <токен>"
  4. Попросіть: «Покажи мої угоди в Helomi».

Під час підключення сервер віддає клієнту інструкцію співробітника: для Ломі — її персону, налаштування і розділи доступу.

5Своя програма — REST і OpenAPI

  • Перелік інструментів зі схемами — GET <сайт>/api/ai/tools; OpenAPI лише з інструментами цього токена — <сайт>/api/ai/openapi.json; каталог розділів з полями — GET <сайт>/api/ai/catalog.
  • Створюючи запис, передавайте idempotency_key — повтор не створить дубль.
  • Дія, що чекає людини, повертає pending_id замість результату.

Загальний файл сесії без окремого співробітника теж є: ІнтеграціїШІAnthropic (Claude)«Інтеграції → ШІ → Anthropic (Claude)» (або інший ключ) → «Підключити свій чат — без ключа API» → «Створити ключ і завантажити файл». Тоді з'являється співробітник «Claude · сесія» (або «ChatGPT · сесія»…) зі своїми доступами.

6Відкликати доступ

Налаштування ШІ → APIТокени«API → Токени» → «Відкликати» (перед ним — жовте попередження: відкликання діє миттєво). Програми й чати з цим токеном чи файлом сесії втрачають доступ одразу. Вимкнений співробітник (⋮Вимкнути«⋮ → Вимкнути») теж не працює.

7Кредити API для передплатників Claude Max і Team

Підписка Claude Pro чи Max не може бути «мозком» сервера для всіх працівників — це заборонено правилами Anthropic, тому чат у пульті й майбутній голосовий екран працюють лише на API-ключі. Але власникам Max і Team Anthropic дає щомісячні кредити на Claude API:

  • Max 5x — 100 $ на місяць, Max 20x — 200 $, Team — до 500 $ на всіх;
  • це додатково до ліміту підписки: ліміти чату й Claude Code не змінюються;
  • кредити покривають Claude API і Agent SDK, але не Claude Code і не чат;
  • невикористане згоряє в кінці платіжного циклу.

Як забрати:

  1. claude.ai → Settings → Billing → блок «API credits» → прив'язати організацію Claude Console (створіть її на platform.claude.com; підписці має бути щонайменше 7 днів; прив'язка одна й назавжди; картку в Console додавати не треба).
  2. Кредити видно в Console → Settings → Billing → Promotional credits.
  3. Там само створіть API-ключ і вставте його в ІнтеграціїШІAnthropic (Claude)«Інтеграції → ШІ → Anthropic (Claude)» → «Перевірити» покаже моделі. Ключ не надсилайте в чат.

Джерело: https://platform.claude.com/docs/en/about-claude/api-credits-for-subscribers.

Можливі помилки

Що ви бачитеЧомуЩо зробити
«Потрібен токен ШІ: Authorization: Bearer sgai_…»Клієнт не передає заголовокДодайте заголовок з токеном
«Токен ШІ недійсний або відкликаний»Токен відкликано або вставлено з помилкоюСтворіть новий токен чи файл сесії
«ШІ-співробітника «…» вимкнено — увімкніть його в пульті»Співробітника вимкнено⋮Увімкнути«⋮ → Увімкнути»
«Підключає ШІ адміністратор»Файл сесії створює не адміністраторПопросіть адміністратора
«Забагато запитів: ліміт N на хвилину…»Ліміт у «Доступах і лімітах»Зачекайте або збільште ліміт (НалаштуванняДоступи й ліміти«Налаштування → Доступи й ліміти»)
ШІ каже, що інструмента немаРозділ не відкрито в «Доступах і лімітах»Відкрийте розділ співробітнику
Дія не виконалась, ШІ пише про підтвердженняСпрацювало «Спочатку запитати»Налаштування ШІ → «Огляд» → «Підтвердити» (або вікно агента → «Чекають підтвердження»)

Для ШІ-співробітників

  • Почніть з describe_section і help потрібного розділу; перелік статей — help без ключа.
  • Дія з pending_id чекає людини в пульті Helomi: скажіть про це й не повторюйте її.
  • Ключ із файлу сесії нікому не показуйте і не вставляйте у відповіді.
  • Якщо інструмента нема — розділ закрито в «Доступах і лімітах»: скажіть людині, де його відкрити.
  • Керувати програмами й агентами CRM — через їхній «Вхід для ШІ»: картка describe_section("ai-<key>") і інструменти ai_<key>_* (стан, налаштування, крок, черга, увімкнути/вимкнути, головні дії); небезпечне — через кошик підтверджень.
  • Стара адреса статті help("ai-connect") веде сюди ж.

Додаткова інформація

Цю саму статтю читають ШІ-співробітники Helomi: help("ai-ostap")