Підключення ISMS Copilot до Claude Code

Ви можете використовувати свій обліковий запис ISMS Copilot безпосередньо з Claude Code, Cursor або будь-яким сумісним з MCP інструментом ШІ. Після підключення ваш інструмент ШІ може переглядати ваші робочі простори та документи, читати нотатки, а також вести справжні діалоги з ISMS Copilot, діючи від вашого імені та в межах діючої підписки.

Що вам знадобиться

• Обліковий запис ISMS Copilot. Підключення покривається вашою підпискою, без окремої оплати.
• Термінал із встановленим Claude Code (або іншим MCP-клієнтом).
• Деякі можливості залежать від вашого тарифного плану (дивіться Вибір режиму відповідей).

Підключення за три кроки

1. У ISMS Copilot відкрить Налаштування, потім Connected apps.
2. Натисніть Create token. Надайте йому ім’я (наприклад, "Claude Code laptop"), виберіть потрібні дозволи (дивіться Дозволи), і скопіюйте токен. Ви побачите його лише один раз.
3. Вставте показану команду у термінал. Вона виглядає так:

claude mcp add --scope user --transport http ismscopilot https://account.ismscopilot.com/v1/account/mcp --header "Authorization: Bearer pat-isms-..."

Потім запустіть свій інструмент ШІ та запитайте, наприклад: "list my ISMS Copilot workspaces".

Для Cursor, Codex або будь-якого іншого MCP-клієнта, який приймає власний заголовок Bearer, додайте URL-адресу сервера https://account.ismscopilot.com/v1/account/mcp разом із токеном як заголовок Bearer. Дивіться Підключення будь-якого MCP-клієнта. Клієнти, які підключаються лише через OAuth, наприклад конектори ChatGPT, поки що не підтримуються.

Що може робити ваш інструмент ШІ

Токен із підключенням може читати та виконувати наступне (і нічого іншого; кожному рядку потрібен відповідний дозвіл):

Отже, зі свого інструменту ШІ ви можете переглядати робочі простори та документи, створювати особистий робочий простір, додавати або редагувати нотатку, а також вести обґрунтований діалог з ISMS Copilot, не виходячи з редактора.

Вибір режиму відповідей (Fast, Think i Beyond)

Коли ви починаєте або продовжуєте діалог зі свого інструменту ШІ, ви вибираєте режим. Підключення не визначає його автоматично з питання. Якщо оркестратор не вказує mode, ISMS Copilot використовує Fast.

• Fast (за замовчуванням): швидкі відповіді, без розгорнутого міркування.
• Think: глибше міркування для складніших питань. Лише для платних планів. На безкоштовному плані запит Think перемикається на Fast.
• Beyond: багатокроковий план, створення чернетки та перевірка. Лише для платних планів, 10 запусків на добу за UTC (50 на Unlimited). Триває кілька хвилин. Оркестратор має передати mode: "beyond" у create_conversation або send_message, потім опитувати get_reply кожні 10-20 секунд, поки запуск не завершиться. Якщо Beyond не може виконатися, хід відповідає через звичайний потік і містить beyond_denied_reason.

На практиці:

• "Think carefully about this" достатньо для Think.
• "Use Beyond" або "run this in Beyond" достатньо для Beyond. Оркестратор не підвищує рівень складного питання самостійно.

Хід у режимі Fast або Think, який не готовий миттєво, повертає status: "generating". Потім оркестратор опитує get_reply кожні 2-5 секунд, поки не поверне complete.

Дивіться Використання режиму Beyond.

Якщо ви досягли ліміту використання

Підключення використовує той самий 4-годинний вікно сесії за UTC, що й додаток чату. Якщо create_conversation або send_message досягає ліміту, перший текст помилки містить речення про очікування або оновлення (включно з часом скидання), а JSON-блок містить reset_at. Індивідуальні облікові записи та власники організацій також отримують upgrade_url. Члени організацій отримують замість цього речення про команду: запитайте власника про додаткове використання або зачекайте до наступного 4-годинного вікна. Їхній JSON містить quota_scope, org_role і extra_usage_buyable, а посилання для оновлення відсутнє.

Ви можете:

1. Зачекати до reset_at.
2. Відкрити upgrade_url у браузері, увійшовши в той самий обліковий запис ISMS Copilot (індивідуальні облікові записи та власники організацій).
3. Якщо JSON містить fallback_available: true, а ваш план має доступний резерв (індивідуальні платні облікові записи з вимкненим Розширеним захистом даних, ніколи для спільного пулу команди), повідомте оркестратору продовжити: за вашою явною згодою він повторно надсилає запит із overflow_consent: true, і хід виконується з тим самим резервом до 2x, який пропонує веб-додаток (відповідь містить overflow_active: true).
4. Продовжувати використовувати інструменти читання. Робочі простори, нотатки, документи та інформація про обліковий запис працюють навіть після досягнення ліміту чату.

Дивіться Що робити, якщо ви досягли ліміту використання.

Налаштування залишаються у веб-додатку

Захищені налаштування облікового запису доступні лише для читання через підключення (контекст компанії, згаданий вище, є єдиним профілем, який може замінити токен із дозволом company_context:write). Зокрема, Розширений захист даних (який маршрутизує ваші дані через європейського провайдера з нульовим зберіганням) не можна ввімкнути або вимкнути зі свого інструменту ШІ.

Якщо ви запитаєте свій інструмент ШІ про захист даних, він може повідомити, чи ввімкнено його для вашого облікового запису, і вкаже вам на Налаштування, Захист даних за адресою chat.ismscopilot.com, щоб змінити його. Це зроблено навмисно: токен підключення не має змоги змінити глобальне налаштування місцезнаходження даних.

Дозволи

Під час створення токена ви вибираєте точно, що він може робити (читати робочі простори, читати документи, читати та записувати нотатки, починати діалоги тощо). Надайте лише ті дозволи, які вам потрібні. Токен, який лише читає ваші робочі простори, не може змінювати нотатки або починати діалоги.

Ви можете переглядати та скасовувати будь-який токен у будь-який час у Налаштування, Connected apps.

Повторне підключення або оновлення токена

Якщо ви вже підключалися раніше та хочете підключитися знову (наприклад, після створення нового токена), спочатку видаліть існуючий сервер. Інакше ваш інструмент ШІ збереже старий токен:

claude mcp remove ismscopilot

Потім вставте нову команду з Налаштування, Connected apps.

Безпека

• Токен діє від вашого імені, тому він може отримувати доступ саме до того, до чого має доступ ваш обліковий запис, обмежений надаными вами дозволами.
• Він покривається вашою підпискою, без окремої оплати.
• Ви можете скасувати його в будь-який час у Налаштування, Connected apps. Скасування набирає чинності миттєво.
• Ставтеся до токена як до пароля. Якщо він був скомпрометований, скасуйте його та створіть новий.

Усунення несправностей

• Підключено, але інструменти не відображаються: повторно виконайте команду підключення з прапорцем --scope user або виконайте claude mcp remove ismscopilot і додайте його знову.
• Помилка аутентифікації: можливо, токен було скасовано або він застарів. Створіть новий у Налаштування, Connected apps.
• Режим Think не здається глибшим: Think вимагає платного плану. На безкоштовному плані він перемикається на Fast.
• Beyond виконувався як звичайна відповідь: ймовірно, оркестратор не вказав mode. Попросіть його надіслати mode: "beyond" або скажіть "use Beyond" у наступному ході. Перевірте beyond_denied_reason, якщо запит Beyond було понижено.