Fixorix MCP — ИИ-ассистент в вашем проекте, внешние системы у агентов

В Fixorix появился MCP. Подключите Claude Code, Cursor, VS Code или Codex к своему проекту — и модель сама разберёт очередь обращений, найдёт ответ в базе знаний или причину упавшего сценария, а чего нет среди инструментов — сделает через REST API тем же ключом. А агенты сценариев теперь работают с вашей CRM, учётной системой или сервисом записи через их MCP-серверы — без программирования.

Что такое MCP

Model Context Protocol — открытый стандарт, по которому ИИ-клиенты подключаются к внешним сервисам. Сервис описывает свои инструменты, а модель сама решает, какой вызвать, и получает данные напрямую, без копирования из одного окна в другое.

ИИ-ассистент работает с проектом

Адрес сервера — https://mcp.fixorix.ru. Клиент подключается обычным API-ключом проекта, у которого включён «Доступ через MCP». Писать код не нужно: готовые конфиги для всех четырёх клиентов дашборд собирает сам.

Что может модель — 26 инструментов в семи группах:

• Чаты. Найти обращения по статусу и группе, прочитать переписку, получить сводку или классификацию разговора, подобрать шаблон ответа.
• База знаний. Поиск, дерево папок и полный текст документа.
• Боты и сценарии. Диагностика бота, структура сценария, его запуски и разбор упавшего прогона.
• Сводка по проекту. Одним вызовом: чаты по статусам и приоритетам, непрочитанные, сценарии, упавшие за сутки, и боты, которые не работают.
• Профили клиентов и теги.

Работает это так: «Что у нас сегодня с поддержкой?», «Почему сценарий записи упал у этого клиента?», «Подготовь ответ на это обращение по базе знаний» — модель сама находит нужные данные в проекте.

→ Fixorix MCP · Подключение ИИ-клиента · Каталог инструментов

И весь REST API — тем же ключом

26 инструментов — это то, что модели удобнее всего вызывать. Но ключ ИИ-клиента — обычный API-ключ проекта, и он работает в REST API, где больше 200 методов. Модель об этом знает: при подключении Fixorix MCP отдаёт ей описание REST API в виде ресурсов MCP:

• оглавление — все методы, которые может вызвать этот ключ: путь, нужные права и краткое описание;
• каждый метод целиком — параметры, тело запроса, ответы и схемы данных;
• спецификацию OpenAPI 3.1 — для генераторов кода и HTTP-инструментов.

Описание собрано под конкретный ключ: в нём только методы, на которые у ключа есть права, а у ключа «только чтение» — только методы чтения. Если для задачи нет инструмента, модель найдёт нужный метод и вызовет его сама, например через curl в терминале.

REST-вызовы выполняются сразу

На вызовы REST API не действуют подтверждения и настройки MCP: их ограничивают только права ключа. Выдавайте ключу ИИ-клиента только те права, которыми готовы дать модели пользоваться без подтверждения, — и начните с пресета «ИИ-клиент: только чтение».

→ REST API тем же ключом

Границы для модели

Модели, которая работает с вашим проектом, нужны чёткие границы. В инструментах MCP мы их заложили с самого начала:

• Внутреннее — сама. Приоритет чата и теги модель меняет сама: клиенты этих изменений не видят, а вернуть прежнее можно тем же инструментом.
• Видимое клиентам — после подтверждения. Сменить статус чата, создать или поправить статью базы знаний, запустить или остановить бота, опубликовать сценарий модель может только после подтверждения сотрудником. ИИ-клиент показывает ссылку на карточку «было → стало», сотрудник разрешает или отклоняет действие. Разрешение одноразовое и действует 15 минут.
• Секретов нет. Токены ботов, HMAC-секреты виджетов, API-ключи и секретные переменные не отдаёт ни один инструмент.
• Персональные данные клиентов выключены, пока их не разрешит владелец проекта.
• Тексты клиентов — это данные. Переписка и документы приходят модели с пометкой, что это не указания для неё.
• Всё в истории. Каждый вызов инструмента — каким ключом, какой инструмент, с каким исходом — виден администратору.

Набор инструментов можно сузить адресом: https://mcp.fixorix.ru/readonly — только чтение, https://mcp.fixorix.ru/x/chats,knowledge — только чаты и база знаний.

→ Безопасность и лимиты

Ключ для ИИ-клиента

В окне создания API-ключа появился переключатель «Для ИИ-клиента (MCP)» и два пресета:

• «ИИ-клиент: только чтение» — модель только читает данные проекта;
• «ИИ-клиент: оператор» — ещё ставит приоритет и теги, а с подтверждением меняет статус чата и статьи базы знаний.

Пресет сам отметит нужные права. Права, которые через REST API дают больше, чем нужно инструментам MCP, — контакты, управление ботами, запись сценариев — вынесены в отдельные галочки.

Чтобы проверить, какой ключ стоит в интеграции, вызовите новый метод GET /v1/key: он вернёт проект, права, срок действия и режим доступа через MCP.

→ Ключи и права

Новая вкладка «MCP» в настройках

Всё, что связано с MCP, собрано в Настройки → «MCP»:

• «Подключение» — адрес сервера, готовые конфиги клиентов, кнопка «Создать ключ для ИИ-клиента» и настройки доступа: разрешён ли MCP в проекте, какой максимальный риск допустим, какие группы инструментов включены, разрешены ли персональные данные;
• «Серверы MCP» — сторонние серверы для агентов, о них ниже;
• «История» — все вызовы инструментов.

→ Настройки проекта

Агенты сценариев вызывают ваши системы

Это вторая половина новости. Если у вашей CRM, учётной системы или сервиса записи есть MCP-сервер, подключите его на вкладке «Серверы MCP» — и его инструменты станут навыками агента сценария. Найти клиента в CRM, проверить статус заказа, посмотреть свободные слоты записи — без блока «HTTP запрос» под каждый метод.

• До 10 серверов на проект. Авторизация — токеном или своими заголовками. Секрет хранится зашифрованным, прочитать его после сохранения нельзя.
• Автор сценария решает, что получит агент. Он выбирает инструменты, описывает модели, когда их вызывать, и при необходимости закрепляет значения аргументов.
• Подтверждение оператора — на выбор: каждый вызов, один раз за разговор или без подтверждения. Если в запросе к внешнему сервису есть телефон, email, номер карты или паспорта, вызов подтверждает оператор — всегда.
• Инструмент не меняется незаметно. Навык закрепляет версию инструмента. Если сервер её изменил, навык покажет, что поменялось, и не будет работать, пока автор его не обновит.
• Инструменты Fixorix тоже доступны агенту: профиль клиента текущего чата — например, чтобы передать его id в CRM, — и полный текст документа базы знаний.

Каждый вызов виден в трассе прогона: сервер, инструмент, статус и пометка, что ответ пришёл из внешнего сервиса.

→ MCP-серверы для агентов · Навыки агента

Агенты отвечают естественнее

Попутно мы переработали то, как агент ведёт разговор:

• Агент отвечает клиенту обычным текстом, а навыки и завершение вызывает как инструменты — так, как модели и обучены.
• Одно сообщение вместо двух. Если модель пишет «сейчас поищу» и тут же вызывает навык, это сообщение клиенту не уходит: агент отвечает, когда результат уже получен.
• Новое действие «Ожидание». Когда всё нужное уже сказано, агент молча передаёт ход клиенту, а не пишет лишнее.

→ Агентский режим

Что дальше

Веб-версии Claude.ai и ChatGPT подключают MCP-серверы только через вход по OAuth. Следующий шаг — вход через аккаунт Fixorix: проект можно будет подключить прямо из браузера, без ключа. Дальше в планах — сторонние MCP-серверы с входом через OAuth для агентов.

С чего начать

1. Откройте Настройки → «MCP» → «Подключение».
2. Нажмите «Создать ключ для ИИ-клиента» и выберите пресет «ИИ-клиент: только чтение».
3. Скопируйте готовый конфиг для своего клиента.
4. Попросите модель: «Вызови project_get_context и расскажи, что мне доступно».

Если что-то не заработало — загляните в Решение проблем или напишите нам.