Як отримати токен MCP для інстансу ConnectiveOne?
Якщо ви хочете, щоб AI-асистент (наприклад, у Cursor) працював з вашим інстансом ConnectiveOne — переглядав ботів, користувачів, чати чи статистику — спочатку потрібен токен зі сторінки Конфігурація токена MCP. Нижче — як його отримати і куди вставити.
Коли знадобиться
- Підключаєте Cursor до інстансу ConnectiveOne вперше.
- Термін дії попереднього токена закінчився — AI-асистент показує помилку авторизації.
- Потрібно видати доступ до сторінки токена користувачу без ролі root (через право MCP-токен у ролі).
Що важливо знати
- Конфігурація токена MCP — сторінка в ConnectiveOne за адресою
/mcp/token, де генерується токен і готова конфігурація для Cursor. - Токен авторизації — довгостроковий ключ доступу для MCP-клієнта. Дійсний приблизно 30 днів; після цього потрібно згенерувати новий на тій самій сторінці.
- Конфігурація Cursor — готовий JSON-блок на сторінці; його можна скопіювати одним натисканням і вставити в налаштування MCP у Cursor.
- Preset — режим набору інструментів (на сторінці є таблиця preset'ів). У згенерованій конфігурації за замовчуванням використовується analysis (переважно перегляд і аналітика).
Про відмінність MCP інстансу від MCP-інструментів у Fast Line Pro — у огляді MCP інстансу.
Перед початком
Ви увійшли в ConnectiveOne (веб-інтерфейс / Конструктор). У вас є роль root або право модуля MCP-токен у вашій ролі. У вас встановлено Cursor або інший MCP-клієнт, який підтримує підключення за URL і заголовками з конфігурації.
Якщо права MCP-токен немає — попросіть адміністратора увімкнути його в налаштуванні ролей (модуль MCP-токен у блоці прав).
Як це зробити
Варіант 1 — через меню допомоги
- У верхній панелі натисніть іконку допомоги (?).
- У списку оберіть Конфігурація токена MCP.
- Якщо ви ще не авторизовані — система відкриє вхід; після успішного входу вас перенаправить на сторінку токена.
Варіант 2 — прямий перехід за посиланням
- Якщо ви вже увійшли: відкрийте у браузері
https://<ваш-домен-connectiveone>/mcp/token - Якщо не увійшли: відкрийте
https://<ваш-домен-connectiveone>/login?mcp=true
— після входу (email/пароль або Google SSO) відкриється сторінка Конфігурація токена MCP.
Скопіюйте токен або конфігурацію
На сторінці Конфігурація токена MCP:
- У полі Токен авторизації натисніть Скопіювати токен, якщо потрібен лише ключ.
- Або натисніть Скопіювати конфігурацію під блоком Конфігурація Cursor — так зручніше для Cursor: у буфер потрапить повний JSON з URL сервера, адресою інстансу та токеном.
- Зверніть увагу на рядок Токен дійсний до — запишіть дату, щоб вчасно оновити токен.
Додайте конфігурацію в Cursor
- Відкрийте Cursor.
- Відкрийте налаштування MCP:
- у проєкті — файл
.cursor/mcp.json, або - глобально — через Preferences: Open User Settings (JSON) (Cmd/Ctrl + Shift + P).
- у проєкті — файл
- Вставте скопійований JSON (або додайте блок
connectiveone-engineдо наявногоmcpServers). - Збережіть файл і перезапустіть Cursor, щоб підключення застосувалося.
За потреби змініть preset
На сторінці токена є таблиця preset'ів (minimal, analysis, setup, scenario, full). Якщо потрібен інший набір інструментів — після вставки конфігурації в Cursor змініть значення preset у відповідному заголовку згідно з таблицею на сторінці. Preset full відкриває всі інструменти; дії можуть бути незворотними — використовуйте лише якщо розумієте ризики.
Що відбувається після
Після перезапуску Cursor AI-асистент може викликати інструменти ConnectiveOne для вашого інстансу — у межах прав вашого користувача та обраного preset.
Як переконатися, що все вдалось
- У Cursor у списку MCP-серверів з'являється підключення connectiveone-engine без помилки авторизації.
- Запитайте асистента про дані інстансу (наприклад, список ботів) — відповідь має базуватися на реальних даних, а не на помилці доступу.
Якщо щось не працює
| Симптом | Що зробити |
|---|---|
Повідомлення про відсутність доступу на /mcp/token | Потрібна роль root або право MCP-токен у ролі. Зверніться до адміністратора або налаштуйте роль. |
Сторінка /mcp/token не відкривається (404) | Можливо, інстанс ще не оновлено до версії з цією функцією. Зверніться до адміністратора або підтримки. |
| Помилка авторизації в Cursor після підключення | Токен прострочений або скопійовано неповністю. Відкрийте /mcp/token знову, скопіюйте нову конфігурацію, оновіть mcp.json, перезапустіть Cursor. |
| Пункт Конфігурація токена MCP не видно в меню ? | У вашої ролі немає права MCP-токен. |