ISMS Copilot Docs

Підключення Cursor і Codex

Підключіть ISMS Copilot account MCP до Cursor або Codex за допомогою URL кінцевої точки та заголовка Bearer pat-isms.

Cursor і Codex обидва працюють з MCP через HTTP. Кінцева точка та облікові дані такі ж, як і для Claude Code, відрізняється лише файл конфігурації. На цій сторінці наведено структуру конфігураційних файлів та перевірки, які підтверджують, що з’єднання працює.

1. Створення токена

У chat.ismscopilot.com відкрийте Налаштування → Connected apps → Create token. Надайте потрібні області дії, скопіюйте значення pat-isms-… один раз і збережіть його поза комітними файлами.

Щоб дізнатися про список можливостей та те, що може робити кожен інструмент, див. ISMS Copilot для агентів. Щоб дізнатися про області дії та життєвий цикл токена, див. Токени та області дії.

2. Кінцева точка

https://account.ismscopilot.com/v1/account/mcp

Транспорт: HTTP MCP. Авторизація: Authorization: Bearer pat-isms-…

3. Конфігурація Cursor

Cursor зчитує сервери MCP з файлу mcp.json: на рівні проекту .cursor/mcp.json або глобально ~/.cursor/mcp.json. Станом на 2026-09 запис HTTP-сервера з користувацькими заголовками виглядає так:

{
  "mcpServers": {
    "ismscopilot": {
      "url": "https://account.ismscopilot.com/v1/account/mcp",
      "headers": {
        "Authorization": "Bearer pat-isms-..."
      }
    }
  }
}

Додайте цей запис (у налаштуваннях Cursor, у розділі MCP або створіть файл безпосередньо), потім перезапустіть Cursor і переконайтеся, що ismscopilot з’явився у списку інструментів MCP.

Це звичайний запис HTTP MCP-сервера з користувацьким заголовком Authorization. Якщо збірка Cursor підтримує лише OAuth-конектори або не підтримує користувацькі заголовки, вона не може використовувати цей шлях. Перевірте документацію MCP для цієї версії клієнта перед налагодженням токена.

4. Конфігурація Codex

Codex зчитує ~/.codex/config.toml. Станом на 2026-09 запис HTTP MCP-сервера виглядає так:

[mcp_servers.ismscopilot]
url = "https://account.ismscopilot.com/v1/account/mcp"

[mcp_servers.ismscopilot.http_headers]
"Authorization" = "Bearer pat-isms-..."

Перезапустіть Codex після редагування. Якщо ваша версія Codex використовує іншу назву ключа для HTTP-заголовків, дотримуйтесь її поточної документації MCP. Незмінними залишаються URL і заголовок Bearer pat-isms-….

5. Перевірка працездатності

Попросіть агента показати ваші робочі простори ISMS Copilot. Якщо інструменти не з’являються:

  • перезапустіть клієнт після додавання сервера,
  • переконайтеся, що токен не був обрізаний під час вставки (він починається з pat-isms-),
  • переконайтеся, що URL вказує на хост облікового запису вище, а не на хост API.

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

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

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

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

6. Оновлення токена

Для планового оновлення створіть новий токен, замініть старий токен у mcp.json (Cursor) або config.toml (Codex), перезапустіть клієнт і виконайте перевірку працездатності. Потім скасуйте дію старого токена в налаштуваннях. Якщо старий токен міг бути скомпрометований, скасуйте його негайно перед налаштуванням нового.

Токен діє від вашого імені. Надавайте лише ті області дії, які вам потрібні, і скасовуйте невикористані токени.

На цій сторінці