Як отримати токен 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-токен.