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

Claude виконує роботу. ISMS Copilot є експертом з відповідності, якого він консультує та перевіряє виконану роботу. Ви приймаєте рішення та підписуєтесь.

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

Що вам потрібно

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

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

Вже підключені за допомогою особистого токена доступу? Спочатку видаліть цей сервер, інакше Claude Code продовжить його використовувати: claude mcp remove ismscopilot.

1. Додайте сервер (токен не потрібен):

claude mcp add --scope user --transport http ismscopilot https://account.ismscopilot.com/v1/account/mcp

2. У сеансі Claude Code виконайте /mcp, виберіть ismscopilot і дотримуйтесь кроків у браузері. З терміналу команда claude mcp login ismscopilot робить те саме.
3. Увійдіть в ISMS Copilot і натисніть Підтвердити на сторінці згоди.

Потім запитайте, наприклад, "покажи мої робочі простори ISMS Copilot."

claude.ai та Claude Desktop підключаються до того самого URL-адреси сервера з тим самим входом: див. Підключення будь-якого клієнта MCP. ChatGPT підключається так само, як спеціальний додаток MCP: див. ту саму сторінку. Для Cursor та Codex див. Підключення Cursor та Codex.

Резервний варіант: підключення за допомогою особистого токена доступу

Використовуйте токен, коли вхід неможливий, наприклад у CI або на безголовій машині:

1. У ISMS Copilot відкрийте Налаштування, потім Підключені додатки.
2. Натисніть Створити токен. Дайте йому назву (наприклад, "Claude Code CI"), виберіть дозволи, які він повинен мати (див. Дозволи), і скопіюйте токен. Ви побачите його лише один раз.
3. Вставте команду, що відображається, у свій термінал. Вона виглядає так:

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

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

Підключення може читати та виконувати наступне, і нічого більше. Підключення через вхід отримує всі рядки нижче; токен отримує рядки, які покривають його дозволи:

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

Вибір способу відповіді (Fast, Think та Beyond)

Сервер не обирає режим. Ваш оркестратор використовує Fast за замовчуванням, Think для перевірок та багатоетапного аналізу, а 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.
• "Використовуй Beyond" або "запусти це в Beyond" достатньо для Beyond. Без цього оркестратор все одно може вибрати Beyond для остаточної перевірки перед аудитом або для тривалого дослідження.

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

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

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

Підключення через вхід (Claude, ChatGPT): текст помилки вказує ліміт та час його скидання, без пропозиції оновлення. JSON містить reset_at, але ніколи upgrade_url, usage_url або extra_usage_buyable. Поля оновлення та покупки, описані нижче, з'являються лише для підключень через особистий токен доступу.

Підключення використовує той самий ліміт використання, що й чат-додаток: ліміт вашого тарифу з часом скидання, який показує додаток. Якщо 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 і доступний перелив вашого тарифного плану (одиночні платні облікові записи з вимкненим Advanced Data Protection; ніколи для командного пулу), скажіть оркестратору продовжити: на ваш явний дозвіл він повторно надсилає з overflow_consent: true, і хід виконується на тому самому переливі до 2x, який пропонує веб-додаток (відповідь містить overflow_active: true).
4. Продовжувати використовувати інструменти читання. Робочі простори, спогади, документи та інформація про обліковий запис продовжують працювати після досягнення ліміту чату.

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

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

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

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

Дозволи

Коли ви входите та натискаєте Підтвердити, інструмент отримує один фіксований набір: читання вашого облікового запису, робочих просторів, документів (метаданих), спогадів та компаній; запит до ISMS Copilot, читання відповідей та позначення зупиненої відповіді як невдалої; створення, зміна та видалення компаній, пов'язування їх з робочими просторами або розрив зв'язку, редагування спогадів та створення робочих просторів. Він не може створювати API-ключі або купувати кредити. Зміни, які він вносить, позначаються в ISMS Copilot назвою інструменту, як Added by OAuth app: <name> або Updated by OAuth app: <name>.

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

Ви можете переглядати та відключати кожне підключення в будь-який час у Налаштуваннях, Підключені додатки: токени у списку токенів, підключення через вхід у розділі Підключені агенти.

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

Якщо підключення через вхід перестало працювати (наприклад, після його відключення), виконайте /mcp, виберіть ismscopilot та увійдіть знову.

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

claude mcp remove ismscopilot

Потім додайте сервер знову, через вхід або з новим токеном.

Безпека

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

Виправлення неполадок

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