Токени, скоупи та безпека
Як працюють підключення через вхід (OAuth) та токени pat-isms: що кожен може робити, скоупи, відключення, термін дії та жорсткі обмеження.
Клієнт MCP діє від вашого імені одним із двох способів: ви входите та схвалюєте його (OAuth, за замовчуванням) або надаєте йому персональний токен доступу, обмежений вибраними вами скоупами.
Вхід (OAuth)
Коли ви додаєте https://account.ismscopilot.com/v1/account/mcp до клієнта без заголовка, клієнт пропонує вам увійти в ISMS Copilot. Сторінка згоди показує адресу, куди надсилатимуться результати, та назву, яку вказав додаток. Схвалюйте лише тоді, коли ви ініціювали підключення зі свого власного інструменту штучного інтелекту.
Одне Схвалення надає один фіксований набір:
| Може | Скоупи |
|---|---|
| Читати ваш обліковий запис, робочі простори, документи (метадані), спогади та профіль компанії | account:read, workspaces:read, documents:read, memories:read, company_context:read |
| Ставити запитання ISMS Copilot та читати відповіді | conversations:create |
| Оновлювати профіль компанії та спогади, а також створювати робочі простори | company_context:write, memories:write, workspaces:write |
Підключення через вхід ніколи не може створювати, переглядати або скасовувати ключі API, а також перевіряти або купувати кредити API. Це доступно лише для токенів. Його відповіді також ніколи не містять полів оновлення плану чи покупки, як-от upgrade_url або extra_usage_buyable.
Зміни, внесені підключеним додатком, позначаються в ISMS Copilot назвою, яку зареєстрував додаток: Added by OAuth app: <name> для спогадів, Updated by OAuth app: <name> для профілю компанії та робочих просторів. Назва обирається самим додатком, тому сприймайте її як підказку, а не доказ. Подальші зміни через веб-додаток або токен замінюють позначку.
Відключення: Налаштування → Підключені додатки, у розділі Підключені агенти. Наступний виклик від цього додатка буде відхилено, а його токен оновлення перестане працювати. Щоб підключитися знову, увійдіть та схваліть повторно.
Персональні токени доступу (запасний варіант)
Використовуйте токен для клієнта, який не може увійти, для CI та безголовних машин, або коли ви хочете вужчий набір скоупів, ніж надає вхід.
Префікс та життєвий цикл
| Крок | Поведінка |
|---|---|
| Створення | Налаштування → Підключені додатки → Створити токен |
| Відображення | Повний секрет показується один раз; починається з pat-isms- |
| Зберігання | Лише в конфігурації клієнта; ніколи не комітьте в git |
| Скасування | На тій самій сторінці Налаштувань; набуває чинності негайно |
| Термін дії | Необов'язковий при створенні |
Скоупи (типові)
Точні позначення в інтерфейсі можуть дещо відрізнятися; мається на увазі:
Обліковий запис
| Можливість | Читання | Запис / дія |
|---|---|---|
| Інформація облікового запису | так | ні |
| Робочі простори | перелік (workspaces:read) | створення особистих робочих просторів за допомогою create_workspace (workspaces:write) |
| Документи | лише перелік метаданих (інструмент отримання за ID недоступний) | ні |
| Спогади | так | створення / редагування при наданні дозволу |
| Контекст компанії | get_company_context (company_context:read) | set_company_context (company_context:write), повна заміна профілю |
| Розмови | недоступно | початок та надсилання при наданні дозволу |
Model API (група Підключені додатки)
| Скоуп | Призначення |
|---|---|
api_keys:read | Перелік метаданих ключів sk-isms (без секретів) |
api_keys:write | Створення / скасування ключів sk-isms через MCP |
api_credits:read | Читання балансу попередньо оплачених кредитів API |
api_credits:checkout | Створення URL-адреси Stripe Checkout для поповнення (людина оплачує в браузері) |
Ці скоупи не дозволяють pat-isms викликати інференс. Оркестратор все одно використовує окремий ключ sk-isms для api.ismscopilot.com. Див. Налаштування з Claude Code або Grok.
Надавайте мінімальний набір для завдання оркестратора. Токен робочого простору лише для читання не може починати розмови.
Жорсткі обмеження (за задумом)
- Створення робочих просторів доступне лише для особистого використання та обмежене. Робочий простір, створений оркестратором, не є спільним для вашої команди, не успадковує Advanced Data Protection вашої організації та обмежений 10 новими робочими просторами на 24 години (кожне створення враховується, включаючи створення через веб-додаток та стартовий робочий простір нового облікового запису). Встановлюйте персону, інструкції та спільний доступ для команди у веб-додатку.
- Записи контексту компанії повністю замінюються.
set_company_contextперезаписує весь профіль полями, які ви передаєте (назва компанії, сектор, масштаб, країна головного офісу, роль у захисті даних, типи даних, регіон хостингу, технологічний стек, примітки); порожній об'єкт очищає його. Спочатку прочитайте його за допомогоюget_company_context, якщо хочете змінити лише одне поле. - Beyond доступний, коли оркестратор передає
mode: "beyond"(Fast є типовим). Платні тарифи, 10 запусків на добу за UTC (50 на Unlimited). Див. Використання режиму Beyond. - Advanced Data Protection не можна перемикати через токен. Оркестратор може повідомляти статус; ви змінюєте його в Налаштуваннях → Захист даних.
- Обмеження швидкості діють (порядку ~120 запитів/хвилину на токен; одночасні розмови обмежені на обліковий запис). Якщо ви досягаєте обмежень, зменшіть навантаження та повторіть спробу.
pat-ismsсам по собі не виконує завершення model-API. Інструменти Model API створюютьsk-ismsта відкривають оформлення кредитів; партнерська оплата Embed залишається окремою.
Контрольний список безпеки
- Називайте токени за пристроєм або призначенням (
claude-laptop,cursor-ci). - Віддавайте перевагу короткому терміну дії для тимчасових машин.
- Скасовуйте токени, якщо ноутбук загублено або секрет CI змінено.
- Ніколи не розміщуйте
pat-isms-…у публічних репозиторіях, скріншотах або запитах на підтримку.
Використання враховується у межах вашої звичайної підписки на чат та лімітів тарифу, а не за попередньо оплаченими кредитами API. Ваш оркестратор також читає кожну отриману відповідь як вхідні дані, тому текст відповіді також враховується у власному контексті та використанні викликаючого інструменту.