---
title: "Як отримати токен MCP для інстансу ConnectiveOne"
description: "Покрокова інструкція: відкрити /mcp/token, скопіювати токен і конфігурацію Cursor, підключити AI-асистент до вашого інстансу."
---

# Як отримати токен 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 інстансу](/uk/learn/mcp/instance-mcp-overview.md).

## Перед початком

- [x] Ви увійшли в ConnectiveOne (веб-інтерфейс / Конструктор).
- [x] У вас є роль **root** або право модуля **MCP-токен** у вашій ролі.
- [x] У вас встановлено Cursor або інший MCP-клієнт, який підтримує підключення за URL і заголовками з конфігурації.

Якщо права **MCP-токен** немає — попросіть адміністратора увімкнути його в [налаштуванні ролей](/uk/settings/how-to/configure-roles.md) (модуль **MCP-токен** у блоці прав).

## Як це зробити

### Варіант 1 — через меню допомоги

1. У верхній панелі натисніть іконку допомоги (**?**).
2. У списку оберіть **Конфігурація токена MCP**.
3. Якщо ви ще не авторизовані — система відкриє вхід; після успішного входу вас перенаправить на сторінку токена.

### Варіант 2 — прямий перехід за посиланням

- Якщо ви **вже увійшли**: відкрийте у браузері  
  `https://<ваш-домен-connectiveone>/mcp/token`
- Якщо **не увійшли**: відкрийте  
  `https://<ваш-домен-connectiveone>/login?mcp=true`  
  — після входу (email/пароль або Google SSO) відкриється сторінка **Конфігурація токена MCP**.

### Скопіюйте токен або конфігурацію

На сторінці **Конфігурація токена MCP**:

1. У полі **Токен авторизації** натисніть **Скопіювати токен**, якщо потрібен лише ключ.
2. Або натисніть **Скопіювати конфігурацію** під блоком **Конфігурація Cursor** — так зручніше для Cursor: у буфер потрапить повний JSON з URL сервера, адресою інстансу та токеном.
3. Зверніть увагу на рядок **Токен дійсний до** — запишіть дату, щоб вчасно оновити токен.

### Додайте конфігурацію в Cursor

1. Відкрийте Cursor.
2. Відкрийте налаштування MCP:
   - у проєкті — файл `.cursor/mcp.json`, або
   - глобально — через **Preferences: Open User Settings (JSON)** (Cmd/Ctrl + Shift + P).
3. Вставте скопійований JSON (або додайте блок `connectiveone-engine` до наявного `mcpServers`).
4. Збережіть файл і **перезапустіть Cursor**, щоб підключення застосувалося.

### За потреби змініть preset

На сторінці токена є таблиця preset'ів (**minimal**, **analysis**, **setup**, **scenario**, **full**). Якщо потрібен інший набір інструментів — після вставки конфігурації в Cursor змініть значення preset у відповідному заголовку згідно з таблицею на сторінці. Preset **full** відкриває всі інструменти; дії можуть бути незворотними — використовуйте лише якщо розумієте ризики.

## Що відбувається після

Після перезапуску Cursor AI-асистент може викликати інструменти ConnectiveOne для вашого інстансу — у межах прав вашого користувача та обраного preset.

## Як переконатися, що все вдалось

- У Cursor у списку MCP-серверів з'являється підключення **connectiveone-engine** без помилки авторизації.
- Запитайте асистента про дані інстансу (наприклад, список ботів) — відповідь має базуватися на реальних даних, а не на помилці доступу.

## Якщо щось не працює

| Симптом | Що зробити |
|--------|------------|
| Повідомлення про відсутність доступу на `/mcp/token` | Потрібна роль root або право **MCP-токен** у ролі. Зверніться до адміністратора або [налаштуйте роль](/uk/settings/how-to/configure-roles.md). |
| Сторінка `/mcp/token` не відкривається (404) | Можливо, інстанс ще не оновлено до версії з цією функцією. Зверніться до адміністратора або підтримки. |
| Помилка авторизації в Cursor після підключення | Токен прострочений або скопійовано неповністю. Відкрийте `/mcp/token` знову, скопіюйте нову конфігурацію, оновіть `mcp.json`, перезапустіть Cursor. |
| Пункт **Конфігурація токена MCP** не видно в меню **?** | У вашої ролі немає права **MCP-токен**. |

## Пов'язані матеріали

- [MCP інстансу ConnectiveOne — огляд](/uk/learn/mcp/instance-mcp-overview.md)
- [MCP — інструменти для Fast Line Pro](/uk/learn/mcp/mcp-overview.md)
- [Налаштувати ролі](/uk/settings/how-to/configure-roles.md)