🤖 MCP
Что это. Сервер MCP (Model Context Protocol) вашего проекта Fixorix. Подключите к нему ИИ-клиент — Claude Code, Cursor, VS Code или Codex — и модель сама найдёт нужные чаты, прочитает переписку и документы базы знаний, проверит ботов и сценарии, с разрешения — поставит приоритет или теги, а после вашего подтверждения в дашборде — сменит статус чата, поправит базу знаний, запустит бота или опубликует сценарий.
Когда нужно. Когда вы работаете с проектом из ИИ-ассистента: разбираете обращения, готовите ответы по базе знаний, ищете причину упавшего сценария или собираете сводку за день — и не хотите вручную переносить данные из дашборда в чат с моделью.
Адрес сервера: https://mcp.fixorix.ru
Этот адрес — для ИИ-клиентов. Если открыть его в браузере, откроется страница Fixorix MCP: что это за сервер, варианты адреса, как создать ключ и подключить Claude Code (команды для bash и PowerShell) и ссылки на эту документацию и дашборд. Страница открывается без ключа, на русском или английском — по языку браузера, и ничего не знает о вашем проекте.
Клиент подключается тем же API-ключом проекта (fxr_…), что и REST API, но у ключа должен быть включён «Доступ через MCP». Пошаговая инструкция — на странице Подключение ИИ-клиента.
Чем MCP отличается от REST API
| REST API | Fixorix MCP | |
|---|---|---|
| Кто вызывает | Ваш код | ИИ-модель в клиенте сама выбирает, что вызвать |
| Что доступно | Больше 200 методов шлюза | 26 инструментов, собранных под задачи модели: описания, понятные ошибки, постраничная выдача |
| Ключ | Любой ключ проекта | Ключ с режимом «Доступ через MCP»: «Только чтение» или «Чтение и запись» |
| Что можно менять | Всё, на что у ключа есть права, включая удаление | Обратимые изменения, которые не видят клиенты, — приоритет чата и теги. Действия, которые видят клиенты, — статус чата, статьи базы знаний, запуск и остановка ботов, публикация сценариев — только после подтверждения человеком в дашборде. Удалять нельзя ничего |
| Секреты | Часть методов работает с секретами (например, HMAC-секреты виджета) | Секреты не возвращает ни один инструмент |
| Персональные данные клиентов | По правам ключа | Только если владелец проекта разрешил их в настройках MCP |
| Лимиты | 1000 запросов в минуту на ключ | Свои лимиты MCP плюс общий лимит ключа, см. Безопасность и лимиты |
Не подключайте ИИ-клиент ключом рабочей интеграции. Заведите для него отдельный ключ с пресетом MCP: у ИИ-клиента будет минимум прав, его вызовы не съедят лимит интеграции, а при утечке вы отзовёте только его.
Адреса
Адрес определяет, какие инструменты получит клиент. Права ключа и настройки проекта действуют на любом адресе — адрес может только сузить набор.
| Адрес | Что получит клиент |
|---|---|
https://mcp.fixorix.ru | Все инструменты, доступные ключу |
https://mcp.fixorix.ru/readonly | Только инструменты чтения — даже если у ключа режим «Чтение и запись» |
https://mcp.fixorix.ru/x/{toolsets} | Только перечисленные тулсеты, например /x/chats,knowledge |
https://mcp.fixorix.ru/x/{toolsets}/readonly | Только чтение в перечисленных тулсетах |
Тулсеты — группы инструментов:
| Тулсет | Что в нём |
|---|---|
project | Контекст проекта («кто я» и что доступно ключу) и сводка по проекту |
chats | Чаты поддержки: список, карточка, переписка, ИИ-анализ, шаблоны ответов, приоритет и статус |
knowledge | База знаний: поиск, дерево папок, текст документа, создание и правка статей |
channels | Боты и виджеты, диагностика, запуск и остановка бота |
flows | Сценарии, их запуски и публикация черновика |
contacts | Профили клиентов |
tags | Теги проекта и теги чата |
В одном адресе — не больше пяти тулсетов через запятую, без пробелов. Адрес с неизвестным тулсетом или с шестью и больше тулсетами отвечает 404.
Чем уже набор, тем меньше лишних описаний попадает модели в контекст и тем точнее она выбирает инструмент. Полный список инструментов с правами — в каталоге.
Тот же выбор можно передать заголовками: X-MCP-Toolsets: chats,knowledge и X-MCP-Readonly: true. Заголовки только сужают набор, заданный адресом.
Какие клиенты поддерживаются
| Клиент | Как подключается |
|---|---|
| Claude Code | Командой claude mcp add с ключом в заголовке |
| Cursor | Файлом ~/.cursor/mcp.json |
| VS Code (GitHub Copilot) | Файлом .vscode/mcp.json; ключ VS Code спрашивает сам |
| Codex | Файлом ~/.codex/config.toml |
Готовые конфиги — на странице Подключение ИИ-клиента. Подойдёт и любой другой клиент, который умеет подключаться к MCP-серверу по HTTP (Streamable HTTP) и передавать свой заголовок Authorization.
Веб-версии Claude.ai и ChatGPT подключают серверы MCP только через вход по OAuth, а Fixorix MCP пока принимает только API-ключ. Подключение с входом через аккаунт Fixorix появится позже. По той же причине клиент, которому не передали ключ, сначала пытается открыть вход по OAuth и завершается ошибкой — передайте ключ в заголовке, как в инструкции.
Сервер работает по протоколу MCP версий 2025-03-26, 2025-06-18, 2025-11-25 и 2026-07-28: клиент сам выбирает подходящую. Сервер отдаёт инструменты (tools), а клиенту, подключённому API-ключом, — ещё ресурсы (resources) с описанием REST API, см. ниже. Промптов и запросов к пользователю от сервера (elicitation) нет.
REST API тем же ключом
Ключ ИИ-клиента — обычный API-ключ проекта, и он работает не только в MCP, но и в REST API по адресу https://api.fixorix.ru. Чтобы модель знала об этом, Fixorix MCP отдаёт клиенту, подключённому ключом, описание REST API в виде ресурсов MCP, а в инструкциях сервера, которые модель получает при подключении, — короткую заметку: тот же ключ работает в REST API, список методов — в ресурсе fixorix://rest-api/operations, а REST-вызовы выполняются сразу, без подтверждений MCP.
| Ресурс | Что в нём |
|---|---|
fixorix://rest-api/operations | Оглавление: базовый адрес, как передать ключ (Authorization: Bearer <ключ>) и по строке на каждый метод, который может вызвать ключ, — HTTP-метод, путь, operationId, нужные права и краткое описание, по разделам |
fixorix://rest-api/operations/{operationId} | Один метод целиком: параметры, тело запроса, ответы и схемы данных |
fixorix://rest-api/openapi.json | Спецификация OpenAPI 3.1 из тех же методов — для генераторов кода и HTTP-инструментов |
- Описание отфильтровано под ключ. В нём только методы, для которых у ключа есть все нужные права (scopes). Если у ключа режим «Доступ через MCP» — «Только чтение» или клиент подключён по адресу с
/readonly, в описании только методы чтения (GET). Метода, который ключ вызвать не может, модель не найдёт и поoperationId: ответ такой же, как на несуществующий. - Только для API-ключа. Ассистент Fixorix и агенты сценариев этих ресурсов не получают.
- Ресурсы — справка, а не вызов. Прочитать их можно, ничего не меняя. Как ресурсы попадают к модели, зависит от клиента: одни дают модели прочитать их самой, другие — приложить к сообщению вручную.
Модель вызывает REST API сама — HTTP-запросом из клиента, например через curl в терминале, — и такой вызов выполняется сразу. На него не действуют правила Fixorix MCP: подтверждение действий, которые видят клиенты, режим «Доступ через MCP», «Максимальный риск», тулсеты, адрес /readonly и лимиты MCP, а в «Историю» вкладки «MCP» он не попадает. Его ограничивают только права (scopes) ключа и общий лимит ключа. Поэтому выдавайте ключу ИИ-клиента только те права, которыми вы готовы дать модели пользоваться без подтверждения, — например, начните с пресета «ИИ-клиент: только чтение», см. Ключи и права.
Как устроена безопасность
- Проект определяется по ключу. Ни один инструмент не принимает идентификатор проекта, а объект другого проекта для модели выглядит как несуществующий (
not_found). - Доступ — пересечение четырёх условий: права (scopes) ключа, его режим «Доступ через MCP», настройки MCP проекта и адрес подключения.
- Ничего не удаляется через инструменты MCP. Приоритет чата и теги модель меняет сама: это обратимые изменения, которых не видят клиенты.
- Действия, которые видят клиенты, — только через человека. Смену статуса чата, создание и правку статей базы знаний, запуск и остановку ботов и публикацию сценариев Fixorix выполняет только после подтверждения в дашборде: ИИ-клиент получает ссылку на карточку «было → стало», сотрудник проекта разрешает или отклоняет, а разрешение одноразовое и действует 15 минут.
- Секреты недоступны: токены ботов, HMAC-секреты виджетов, API-ключи и секретные переменные не возвращает ни один инструмент.
- Персональные данные клиентов выключены, пока их не разрешит владелец проекта.
- Тексты клиентов — это данные. Переписка и документы приходят модели с пометкой, что это не указания.
- Вызовы инструментов попадают в историю проекта: каким ключом, какой инструмент, с каким исходом. Историю видит администратор.
- REST API — по правам ключа. Тот же ключ работает в REST API, и модель об этом знает. Подтверждения и настройки MCP к REST-вызовам не относятся, поэтому права ключа для ИИ-клиента — только необходимые, см. REST API тем же ключом.
Подробнее — на странице Безопасность и лимиты.
Настройки MCP в проекте
Всё, что касается MCP, собрано на вкладке Настройки → «MCP». Внутри — три вкладки:
| Вкладка | Что там |
|---|---|
| «Подключение» | Адрес сервера, варианты адреса, готовые конфиги клиентов и кнопка «Создать ключ для ИИ-клиента». Карточка «Доступ»: «Разрешить Fixorix MCP», «Максимальный риск», «Тулсеты» и «Разрешить инструменты с персональными данными». Каталог «Инструменты Fixorix» по тулсетам — что из него сейчас доступно |
| «Серверы MCP» | Сторонние MCP-серверы для агентов сценариев — см. MCP-серверы для агентов |
| «История» | Вызовы инструментов: когда, какой инструмент, кто вызвал и с каким исходом |
Запросы на подтверждение действий, которые видят клиенты, в настройках не собраны: ИИ-клиент получает ссылку на карточку «было → стало» и показывает её вам в своём чате, см. Действия, которые видят клиенты.
Подробное описание вкладки — в разделе Настройки.
С чего начать
- Убедитесь, что Fixorix MCP разрешён в проекте: Настройки → «MCP» → «Подключение», карточка «Доступ» → «Разрешить Fixorix MCP» (меняет администратор, по умолчанию включён).
- Создайте ключ кнопкой «Создать ключ для ИИ-клиента» на той же вкладке (ключи создаёт администратор) и выберите пресет «ИИ-клиент: только чтение» — см. Ключи и права.
- Сохраните ключ в переменной окружения и подключите клиент — см. Подключение ИИ-клиента.
- Попросите модель вызвать
project_get_context: она увидит проект и список доступных инструментов. - Если что-то не работает — Решение проблем.
Кто что может
| Действие | Минимальная роль |
|---|---|
| Видеть вкладку «MCP»: подключение, доступ, каталог инструментов, серверы MCP | Редактор |
| Создать ключ с доступом через MCP, включить или выключить доступ у ключа | Администратор |
| «Разрешить Fixorix MCP», «Максимальный риск», «Тулсеты» | Администратор |
| «Разрешить инструменты с персональными данными» | Владелец |
| Открыть карточку подтверждения по ссылке | По умолчанию |
| Разрешать и отклонять действия ИИ-клиентов | Зависит от инструмента: статус чата — любой участник, база знаний и боты — Редактор, публикация сценария — Администратор |
| Смотреть «Историю»: вызовы и изменения | Администратор |
| Вызывать инструменты из ИИ-клиента | Роль не проверяется — важны права ключа и настройки проекта |
Подключение · Ключи и права · Каталог инструментов · Безопасность и лимиты · Решение проблем · REST API