# MCP-сервер

MCP-сервер позволяет подключить данные ROMI center к AI-ассистентам — Claude, ChatGPT, VS Code, Cursor и другим. После подключения можно задавать вопросы прямо в чат: «Какой канал принёс больше всего лидов в апреле?», «Сравни расходы этого месяца с прошлым», «Покажи топ-10 кампаний по ROAS» — и получать ответы на реальных данных проекта.

## Как подключиться

Перейдите в «Отчёты → MCP-сервер» и нажмите «Подключить».

![Страница MCP-сервера](https://help-ru.romi.center/images/mcp-server/01-mcp-overview.png)

На первом шаге выберите тип клиента:

**Claude** — подключение через OAuth. ROMI center сгенерирует адрес MCP-сервера. Вставьте его в настройки Claude (Integrations → Add integration). После добавления в таблице появится строка со статусом «Ожидание» — она станет «Активен» при первом обращении.

**ChatGPT** — аналогично: OAuth-подключение через адрес сервера в настройках ChatGPT.

**VS Code / Cursor / Windsurf** — то же, только адрес вставляется в конфигурацию IDE.

**Другие клиенты** — ключ-токен (bearer). Введите название ключа, нажмите «Создать ключ». На следующем шаге ключ будет показан один раз — скопируйте его сразу, повторно он не отображается. Используйте ключ как Bearer-токен при обращении к MCP API.

## Что умеет ассистент после подключения

После подключения AI-ассистент получает доступ к инструментам для работы с данными проекта:

*   Смотреть список таблиц в хранилище
*   Читать структуру таблиц (какие поля, типы)
*   Выполнять SQL-запросы и возвращать результаты

Ассистент не может изменять данные — только читать.

Примеры вопросов которые можно задать:

*   «Покажи расход по каналам за последние 30 дней»
*   «Какой день недели даёт наибольшее количество заявок?»
*   «Сравни CPC Яндекс Директа и VK Рекламы за апрель»
*   «Построй воронку: показы → клики → заявки → сделки»

## Управление подключениями

На странице MCP-сервера отображается таблица всех подключений с их статусом:

**Ожидание** — подключение создано, AI ещё не обращался к серверу.

**Активен** — подключение работает, данные передаются.

**Отозван** — доступ отозван вручную.

Чтобы отозвать доступ конкретного клиента — нажмите «Отозвать» в строке подключения. Это не затрагивает другие подключения.

## Блок «Активность»

Под таблицей подключений — счётчик обращений за последние 7 дней и время последнего запроса. По ссылке «Показать последние обращения» раскрывается список с деталями: какое подключение обращалось, какой инструмент использовал и когда.

## Что дальше

*   Вернуться к дашбордам → [Как создать дашборд](https://help-ru.romi.center/kak-sozdat-dashbord)
*   Подключить внешний BI → [Подключить свой BI](https://help-ru.romi.center/podklyuchit-svoy-bi)