> Усі статті WIKI Helomi: /wiki/llms.txt

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

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

## Можливості
| Що у вас | Як підключити | Ключ 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 досі радить «Settings → Connectors».

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

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

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

## 4. Claude Code, Cursor, будь-який клієнт MCP
1. «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)» (або інший ключ) → «Підключити свій чат — без ключа API» → «Створити ключ і завантажити файл». Тоді з'являється співробітник «Claude · сесія» (або «ChatGPT · сесія»…) зі своїми доступами.

## 6. Відкликати доступ
Налаштування ШІ → «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)» → «Перевірити» покаже моделі. Ключ не надсилайте в чат.

Джерело: 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")` веде сюди ж.

## Додаткова інформація
- Пов'язані статті: [ШІ-співробітники](ai-employees.md), [Ломі](kamila.md), [Ключі моделей](int-ai-keys.md), [ШІ-творець](ai-creator.md).