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

Ви можете використовувати свій обліковий запис 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)

Коли ви починаєте або продовжуєте розмову з вашого AI-інструмента, ви обираєте режим. Підключення не вибирає його з питання. Якщо оркестратор пропускає 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. Оркестратор не покращить складне питання самостійно.

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

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

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

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

Підключення використовує те саме 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 і доступний перелив вашого тарифу (окремі платні облікові записи з вимкненим 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 був знижено.