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.
Настройка клиентов
{
"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 и выполнение кода.
MCP BSL Platform Context
MCP-сервер со справкой по синтаксису и объектной модели платформы 1С, без доступа к базе.
Spree Commerce: открытая платформа электронной коммерции для B2B и маркетплейсов
Открытая платформа электронной коммерции Spree для B2B и маркетплейсов.
Spree Commerce: документация для ИИ-агентов
Документация Spree Commerce для агентов-программистов.