ChatbotX MCP

MCP-сервер платформы ChatbotX: контакты, диалоги, потоки, рассылки и автоматизации в WhatsApp, Instagram и других каналах

  • 1 111 ★ репозитория
  • Последний коммит
MCP-серверОфициальный

Широкий доступ

Почему такой уровень

  • Агент может отправлять сообщения и рассылки клиентам от имени бизнеса, включая каналы вроде WhatsApp и Instagram
  • Токен открывает контакты и диалоги всего рабочего пространства, а `call_tool` вызывает любую операцию API, в том числе удаление
Все причины и проверки

chatbotxio/chatbotx

Установка

В терминале, через SkillFoxx CLI

npx skillfoxx add mcp/chatbotx

Определит агенты на машине, покажет уровень доступа и зафиксирует версию.

Другие способы установки

Доступ и проверки

Как мы проверяем

Широкий доступИнструмент может менять данные, выполнять команды или работать с секретами.

  • Агент может отправлять сообщения и рассылки клиентам от имени бизнеса, включая каналы вроде WhatsApp и Instagram
  • Токен открывает контакты и диалоги всего рабочего пространства, а `call_tool` вызывает любую операцию API, в том числе удаление

Это чужой код. Посмотрите файлы в репозитории перед установкой.

Что делает

ChatbotX — открытая платформа чат-маркетинга, аналог ManyChat: один рабочий кабинет для WhatsApp, TikTok, Facebook, Instagram, Telegram, почты и веб-чата. MCP-сервер дает агенту доступ к рабочему пространству: контакты CRM, потоки, последовательности, рассылки и ИИ-автоматизации. Инструменты не описаны вручную. Сервер при запуске читает спецификацию OpenAPI платформы и регистрирует по одному инструменту на операцию, помеченную как доступная по умолчанию. В публичном API около 350 операций, поэтому агенту показывают подобранный набор и три служебных инструмента: `search_tools` ищет нужную операцию по всему API, `call_tool` выполняет ее по имени, `get_guide` отдает инструкции по безопасной работе с согласованиями, потоками, контактами и воронками. Подключаются удаленно по OAuth 2.1 или локально по stdio с токеном рабочего пространства.

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

Подходит, если

  • Нужно найти в CRM контакты с определенным тегом и подготовить для них рассылку
  • Сценарий бота в WhatsApp надо проверить и поправить, не открывая визуальный конструктор потоков
  • Агент разбирает входящие диалоги и передает сложные обращения оператору
  • Магазин на Shopify или WooCommerce хочет сверить воронку продаж с данными ChatbotX

Не подходит, если

  • Рабочего пространства ChatbotX нет: сервер управляет только им
  • Требуется одноразовая рассылка по базе: массовая отправка из агента без проверки легко уйдет не тем адресатам
  • Нужен точный ответ на узкий вопрос по одной операции API: проще вызвать ее напрямую

Пример запроса к агенту

Найди контакты с тегом «вернуть клиента» и покажи черновик рассылки для них, без отправки

MCP

Транспорт
http, sse, stdio
Авторизация
OAuth

Переменные окружения

CHATBOTX_API_URL
Адрес API вместе с префиксом `/api`, нужен локальному stdio-серверу

Ограничения

Набор инструментов строится по спецификации OpenAPI и обновляется в фоне примерно раз в пять минут, поэтому список может меняться без перезапуска. Каталог `search_tools` целиком на английском: клиент должен сам перевести запрос в формулу «действие плюс ресурс». Удаленно авторизовать сервер могут только владельцы рабочего пространства и суперадминистраторы, токен действует на то рабочее пространство, которое выбрано при согласии. Чтобы сменить пространство, соединение отключают и создают заново. Каналы вроде WhatsApp требуют своих учетных данных у Meta.

Как отключить. Отключите сервер в клиенте, например `claude mcp remove chatbotx`, и отзовите доступ в разделе Settings, Integrations, ChatbotX MCP кабинета.

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

Какой адрес у удаленного сервера ChatbotX?

Для Streamable HTTP это https://app.chatbotx.io/mcp/messages, для устаревшего SSE https://app.chatbotx.io/mcp/sse. Адрес один для всех аккаунтов, рабочее пространство выбирают на экране согласия.

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

В публичном API около 350 операций, и полный список перегрузил бы контекст. В списке инструментов остается подобранный набор, остальное агент находит через `search_tools` и запускает через `call_tool`.

Можно ли работать без OAuth?

Да, для stdio и старых подключений остались токены рабочего пространства. В локальном сервере адрес API задают переменной `CHATBOTX_API_URL` вместе с префиксом `/api`.

Платформу можно поставить на свой сервер?

Да, проект открытый. Для самостоятельного размещения есть отдельный репозиторий chatbotx-docker-compose, который поднимает готовые образы командой `docker compose up`.

Что такое get_guide?

Служебный инструмент, который отдает инструкции по безопасной работе с согласованиями, потоками, передачей диалога оператору, контактами и воронками. Его вызывают перед рабочими сценариями с этими сущностями.

Обсуждение

Вопросов и отзывов пока нет.

MCP-серверы
Российский стек

MCP-сервер для чат-ботов SendPulse: аккаунт, диалоги и отправка сообщений в WhatsApp, Telegram, Instagram и другие каналы

MCP-серверРасширенный доступ
Российский стек

MCP-сервер для WhatsApp-ботов и SMS в SendPulse: контакты, сообщения с кнопками, сценарии, триггеры и живой чат

MCP-серверШирокий доступ2Звезды репозитория
Официальный

Официальный MCP-сервер Chatway: агент разбирает диалоги живого чата, отвечает клиентам, назначает операторов и ищет по базе знаний

MCP-серверШирокий доступ34Звезды репозитория
Официальный

Открытая CRM для малых команд с MCP: контакты, сделки и задачи доступны Claude и другим агентам, черновики ответов за вами

MCP-серверШирокий доступ221Звезды репозитория
Официальный

Официальный MCP конкретного портала Битрикс24: внешний агент по OAuth или токену читает и меняет задачи, сделки, встречи и письма

MCP-серверШирокий доступ

Bitrix24 MCP от Bit2Beat

Bitrix24 MCP Server

Российский стек

MCP-сервер Битрикс24 через входящий вебхук: CRM, задачи, диск, календарь, чат, бизнес-процессы и перенос настроек между порталами

MCP-серверШирокий доступ6Звезды репозитория

Сравнение с похожими

Карточки с тем же главным запросом: чем они отличаются.

ИнструментОфициальныйАвторизацияЗвезды репозиторияГлавное отличие
ChatbotX (эта карточка)даOAuth1 111
MCP-сервер для чат-ботов SendPulseнетOAuth0сервер для чат-ботов SendPulse с фиксированным набором операций, а не для открытой платформы ChatbotX с самостоятельным размещением
WhatsApp MCP Serverнетне нужна6 866сервер к личному аккаунту WhatsApp, без CRM, потоков и рассылок платформы

Коротко о README

Текст открывается заголовком об агентной платформе чат-маркетинга для OpenClaw, Hermes и Claude и сравнением с ManyChat, Chatfuel и Wati. Дальше идут стек на TypeScript и Next.js, запуск локальной инфраструктуры через Docker Compose и карта монорепозитория, где `apps/mcp-server` отвечает за MCP.

Бейдж для README

Сообщить о проблеме