Подключение ИИ-приложений (MCP)

MonoChat MCP Server позволяет ИИ-приложению с поддержкой Model Context Protocol (MCP), например Claude Code или Cursor, работать с вашим аккаунтом MonoChat. ИИ-приложение запрашивает данные у MonoChat через фиксированный набор инструментов и видит только то, что видите вы.

MonoChat MCP Server доступен на любом тарифе, без ограничений по тарифу.

Подключение действует от вашего имени

ИИ-приложение, подключённое с вашим ключом доступа, действует как ваш пользователь. Оно получает доступ к тенантам, к которым есть доступ у вас, и ни к чему больше. Отзывайте подключения, которыми больше не пользуетесь.

Что может ИИ-приложение

Эти инструменты доступны для любого подключения:

Инструмент	Что делает
`list_tenants`	Возвращает список тенантов, доступных подключению.
`list_sessions`	Возвращает список сессий диалогов тенанта, сначала новые, при необходимости только `opened`, `assigned` или `closed`.
`get_session`	Возвращает одну сессию диалога.
`list_messages`	Возвращает список сообщений сессии, сначала новые.
`search_customers`	Ищет клиентов тенанта по ключевому слову.
`list_message_templates`	Возвращает список шаблонов сообщений одного канала тенанта.

Текст сообщений поступает от клиентов и операторов. Это данные для чтения ИИ-приложением, а не инструкции.

У подключения есть область доступа: Только чтение или Чтение и запись. Подключение только для чтения никогда не видит инструменты, которые изменяют данные. Все перечисленные выше инструменты только читают.

Создание подключения

Подключение принадлежит вашему аккаунту, а не тенанту. Сначала необходимо настроить двухэтапную проверку (по e-mail или через приложение-аутентификатор).

Откройте настройки профиля, выберите вкладку MCP-подключения и нажмите Создать.
Введите название, выберите область (по умолчанию Только чтение) и срок действия в днях (по умолчанию 90, не более 365).
Введите 6-значный код подтверждения из вашего способа двухэтапной проверки. Если вы используете проверку по e-mail, сначала нажмите Отправить код подтверждения.
Скопируйте ключ доступа. Он показывается только один раз; начинается с mcp_sk_.

Можно иметь не более 10 активных подключений.

Подключение ИИ-приложения

Сервер находится по адресу https://app.monochat.ai/api/mcp-server (используйте собственный адрес MonoChat, если MonoChat работает на ваших серверах) и ожидает ключ доступа как bearer-токен в заголовке Authorization.

Claude Code

claude mcp add --transport http monochat https://app.monochat.ai/api/mcp-server \
  --header "Authorization: Bearer <access key>"

Cursor

Добавьте сервер в ~/.cursor/mcp.json:

{
  "mcpServers": {
    "monochat": {
      "url": "https://app.monochat.ai/api/mcp-server",
      "headers": { "Authorization": "Bearer <access key>" }
    }
  }
}

Любой другой MCP-клиент, поддерживающий потоковый HTTP-транспорт и пользовательские заголовки, подключается так же.

Ограничения

Вызовы считаются за минуту: 60 на подключение, 300 на аккаунт и 600 на тенант, а одновременно допускается не более 4 вызовов на подключение. Некоторые инструменты считаются как более одного вызова. При достижении лимита сервер отвечает статусом 429 и заголовком Retry-After; ИИ-приложение должно подождать указанное число секунд.

Отзыв подключения

Каждое подключение на вкладке MCP-подключения показывает статус, область, срок действия и последнее использование. Нажмите Отозвать, чтобы сразу закрыть доступ ИИ-приложению. Отозванное или истёкшее подключение нельзя использовать снова; создайте новое.

Управление доступом по MCP для организации

Пользователи, которые могут менять настройки организации, управляют её доступом по MCP в разделе Настройки › Организация › MCP-сервер.

Отключить доступ по MCP для этой организации: включите и нажмите Сохранить, чтобы отклонять любой вызов MCP к этой организации, с любого подключения любого пользователя. Организация больше не появляется в list_tenants. Выключите и сохраните, чтобы снова разрешить доступ по MCP.
Вызовы MCP: каждый вызов инструмента, указывающего эту организацию, сначала новые, включая отклонённые. В каждой строке показаны пользователь, подключение, инструмент, статус (Успешно или Не удалось), IP-адрес и время. Вызовы пользователей, которые не являются участниками этой организации, не показываются.

Что может ИИ-приложение​

Создание подключения​

Подключение ИИ-приложения​

Claude Code​

Cursor​

Ограничения​

Отзыв подключения​

Управление доступом по MCP для организации​