ChatbotX

ChatbotX — официальный MCP-сервер от ChatbotXIO. Омниканальные сообщения клиентам, контакты CRM, сценарии, рассылки и автоматизация. Подключается как удалённый сервер. Лицензия NOASSERTION.

Опубликовано 13.11.2026 · Обновлено 13.11.2026 · Проверено 13.11.2026

Кратко о сервере

Разработчик
ChatbotXIO
Лицензия
NOASSERTION
Транспорт
sse, streamable_http
Авторизация
oauth
ОС
Не указана
Языки
typescript

Уровень риска: high

Отправляет сообщения клиентам, публикует сценарии и меняет данные пространства; изменения требуют подтверждения (_confirm). Для чтения используйте токен read_only.

Настройка клиентов

cursor
{
    "code": "{\n  \"mcpServers\": {\n    \"chatbotx\": {\n      \"type\": \"http\",\n      \"url\": \"https://app.chatbotx.io/mcp/messages\"\n    }\n  }\n}",
    "lang": "json",
    "notes": "Дословно из README; общий конфиг для Claude Desktop и Cursor",
    "verified": "docs"
}

Что умеет

ChatbotX MCP Server даёт ИИ-агентам (Claude, Cursor, ChatGPT и другим) доступ к рабочему пространству ChatbotX — конструктора чат-ботов и диалогов с клиентами. Инструменты генерируются автоматически из спецификации OpenAPI ChatbotX. При запуске сервер загружает public-spec.json и регистрирует по инструменту на каждую операцию, отмеченную как видимую по умолчанию.

В публичном API около 350 операций. Чтобы не перегружать контекст агента, tools/list отдаёт набор из 52 инструментов и три мета-инструмента:

  • search_tools — поиск по всему API. Каталог англоязычный, поэтому клиент формулирует запрос на английском.
  • call_tool — вызов любого найденного инструмента.
  • get_guide — руководство по безопасной работе с подтверждениями, сценариями, передачей диалога, контактами и воронками.

Основной набор инструментов:

  • ИИ-агенты — список, создание и изменение, файлы и функции.
  • Аналитика — новые и заблокированные контакты по дням, статистика сценариев, рассылок и цепочек.
  • Рассылки — просмотр и остановка.
  • Контакты — создание, поиск, теги, пользовательские поля, сообщения, отправка сообщения или сценария, подписка на цепочки.
  • Диалоги — список, просмотр и назначение на сотрудника или команду.
  • Сценарии — создание, черновик, проверка и публикация.
  • Ключевые слова, сообщения, мини-приложения, воронки (создание и перенос карточек по этапам), цепочки, журнал ошибок.

Удаление, купоны, товары, вебхуки и прочие редкие операции доступны через search_tools и call_tool.

Кому подойдёт

  • Владельцам чат-ботов на ChatbotX: агент разбирает диалоги, ведёт контакты и воронки.
  • Маркетологам: аналитика рассылок и цепочек, сборка сценариев.
  • Командам поддержки: назначение диалогов и ответы клиентам.

Похожие серверы — в категории коммуникации.

Установка

Рекомендуемый способ — удалённый сервер https://app.chatbotx.io/mcp/messages с авторизацией OAuth 2.1. Клиент откроет браузер для входа и согласия, а токен в конфиг не прописывается. Рабочее пространство выбирается на экране согласия, авторизовать может только владелец или участник с ролью superAdmin. Для смены пространства отключитесь и подключитесь снова. Отозвать доступ можно в настройках: «Settings → Integrations → ChatbotX MCP».

Локальный вариант — пакет npx -y chatbotx-mcp по stdio с токеном пространства в CHATBOTX_API_KEY, нужен Node.js 24 или новее. Есть также режим SSE для общего сервера.

Подключение к клиентам

Команда и конфиг для OAuth приведены дословно из README. Общий порядок — в инструкции как подключить MCP.

claude mcp add chatbotx -t http -s user \
  "https://app.chatbotx.io/mcp/messages"

Тот же JSON подходит для Claude Desktop. В ChatGPT добавьте https://app.chatbotx.io/mcp/sse как пользовательский коннектор, OAuth пройдёт в браузере.

Проверка

Попросите агента показать права подключения — сработает token_get: пространство, уровень доступа (read_only или full) и области. Затем capabilities_get покажет сущности пространства.

Примеры задач

Покажи статистику последних рассылок и новых контактов за неделю.
Найди непрочитанные диалоги и назначь их на команду поддержки.

Риски

Агент действует в рабочем пространстве ChatbotX: отправляет сообщения клиентам, запускает сценарии, публикует сценарии, меняет контакты и воронки. Через call_tool доступны и удаления. Защита в самом сервере: каждая изменяющая операция сначала возвращает CONFIRMATION_REQUIRED с предлагаемыми аргументами и текущим состоянием. Агент должен показать это вам и повторить вызов с _confirm: true только после явного согласия. Не разрешайте подтверждать автоматически, особенно отправку сообщений клиентам.

Сократить риск можно токеном read_only: с ним видны только инструменты чтения. Токен пространства — секрет, и в URL (?workspace_token=) он может попасть в логи, поэтому по возможности используйте OAuth. Одноразовый secret.token из connections_create больше не показывается — сохраните его сразу. Сообщения клиентов — недоверенные данные.

Частые вопросы

Почему агент не видит нужную операцию?

В tools/list только основной набор. Остальное ищется через search_tools и вызывается через call_tool.

Можно ли дать только чтение?

Да. С токеном read_only в списке остаются только инструменты чтения.

Основы протокола — на странице что такое MCP-сервер.

Похожие MCP-серверы

1C MCP Toolkit

MCP и REST API сервер для баз 1С во внешней обработке: запросы, метаданные, журнал, справка BSL и выполнение кода.

Риск: high Лицензия: GPL-3.0 ★ 371

MCP BSL Platform Context

MCP-сервер со справкой по синтаксису и объектной модели платформы 1С, без доступа к базе.

Риск: medium Лицензия: MIT ★ 209

Источники