MCP-сервер ChatPush · n8n AI Agent

n8n + MAX, WhatsApp*, Telegram и SMS: AI Agent пишет клиентам через ChatPush MCP

AI Agent в n8n получает инструменты ChatPush по MCP: отправить сообщение, включить каскад каналов, проверить статус доставки. Триггер запускает сценарий, агент решает, что и кому написать, ChatPush доставляет.

Сегодня работает на self-hosted n8n. Сервер бесплатный и открытый: GitHub, npm.

Демо:
ТриггерWebhook
АгентAI Agent
Chat Model
ToolChatPush MCP
Журнал выполнения

Упрощённое демо: сообщения из примера никуда не отправляются. Имена инструментов и параметры настоящие.

Честно про статус

Что работает в n8n сегодня

У n8n два способа подключить MCP-сервер к агенту, а ChatPush MCP пока запускается только командой. Поэтому всё зависит от того, где работает ваш n8n.

Работает сегодня

Self-hosted n8n + community-узел

Узел n8n-nodes-mcp запускает сервер ChatPush командой npx на той же машине, где работает n8n.

Инструкция
Для разработчиков

Self-hosted n8n + свой HTTP-сервер

Запускаете сервер ChatPush из репозитория в HTTP-режиме и подключаете встроенный узел MCP Client Tool.

Как запустить
Скоро

n8n Cloud и подключение по ссылке

Встроенному узлу MCP Client Tool нужна ссылка на сервер. Удалённый сервер ChatPush готовится.

Что можно уже сейчас

MCP (Model Context Protocol) — открытый протокол, по которому ИИ-агент получает новые инструменты: сервер описывает действия, агент вызывает их сам. Встроенный узел MCP Client Tool подключается к серверу по адресу (транспорт HTTP Streamable или устаревший SSE) и запускать сервер командой не умеет. Неверифицированные community-узлы в n8n Cloud недоступны. Источники: документация n8n и исходный код узла, проверено 16.11.2026.

Схема сценария

Триггер → AI Agent → ChatPush MCP → мессенджеры

Нажмите на узел, чтобы увидеть, что в нём настроить.

Триггер

Подойдёт любой триггер n8n: Webhook из CRM или сайта, Schedule Trigger для напоминаний по расписанию, Chat Trigger для ручных команд. Триггер передаёт агенту данные события: имя клиента, телефон, дату и время.

AI Agent

Узел AI Agent получает задачу и сам решает, какой инструмент вызвать. В поле System Message задайте правила: формат номера, порядок каналов, когда ничего не отправлять. Готовый текст есть ниже.

Chat Model

К агенту подключается модель, которую вы уже используете в n8n. Ей нужна поддержка вызова инструментов: без неё агент не сможет обратиться к ChatPush.

ChatPush MCP

Инструмент агента. Сегодня это узел MCP Client из пакета n8n-nodes-mcp: он запускает npx -y chatpush-mcp-server и передаёт агенту 19 инструментов ChatPush. Фильтра инструментов у этого узла нет, поэтому правила для агента задайте в System Message. Выбрать отдельные инструменты можно во встроенном MCP Client Tool (поле Tools to Include): это второй способ подключения.

Мессенджеры

ChatPush отправляет сообщение в MAX, WhatsApp*, Telegram или SMS с номеров, подключённых в вашем кабинете. При каскаде каналы идут по порядку: не дошло в один, сообщение уходит в следующий, SMS последним. Как это устроено: умный каскад.

Подключение

Как подключить ChatPush MCP к AI Agent в n8n

Выберите вкладку под свой n8n. Первый способ рабочий уже сегодня.

Что понадобится

  • Аккаунт ChatPush: регистрация, первые 10 дней бесплатно.
  • API-токен из раздела «Интеграции» в кабинете.
  • Мессенджеры, подключённые в кабинете по QR-коду: MAX, WhatsApp* или Telegram.
  • Self-hosted n8n, где доступна команда npx (Node.js 20 или новее), и права владельца или администратора.
  1. Получите токен ChatPush

    Зарегистрируйтесь на chatpush.ru, скопируйте API-токен в разделе «Интеграции» и подключите в кабинете MAX, WhatsApp* или Telegram по QR-коду.

  2. Установите узел n8n-nodes-mcp

    В n8n откройте Settings → Community Nodes, нажмите Install, введите n8n-nodes-mcp, подтвердите, что понимаете риски, и нажмите Install.

    Если n8n работает в режиме очередей (queue mode), узел ставится вручную, после этого n8n нужно перезапустить:

    Терминал · ручная установка
    mkdir -p ~/.n8n/nodes
    cd ~/.n8n/nodes
    npm i n8n-nodes-mcp
  3. Создайте credential

    Тип MCP Client (STDIO) API: Command — npx, Arguments — -y chatpush-mcp-server, Environments — CHATPUSH_TOKEN=ваш_токен.

    n8n · поля credential
    Credential · MCP Client (STDIO) API
    Command:       npx
    Arguments:     -y chatpush-mcp-server
    Environments:  CHATPUSH_TOKEN=ваш_токен

    В Docker токен можно передать переменной окружения контейнера, тогда поле Environments остаётся пустым:

    docker-compose.yml
    services:
      n8n:
        image: n8nio/n8n
        environment:
          # узел n8n-nodes-mcp передаст серверу переменную без префикса MCP_
          - MCP_CHATPUSH_TOKEN=ваш_токен
          # нужна только для n8n 1.79–1.84:
          # - N8N_COMMUNITY_PACKAGES_ALLOW_TOOL_USAGE=true
        ports:
          - "5678:5678"
        volumes:
          - ~/.n8n:/home/node/.n8n
  4. Добавьте инструменты агенту

    К узлу AI Agent подключите два узла MCP Client: первый с операцией List Tools, второй с операцией Execute Tool, где имя инструмента и параметры заполняет модель.

    n8n · настройки двух узлов-инструментов
    Узел 1 · MCP Client
    Connection Type:  Command Line (STDIO)
    Operation:        List Tools
    
    Узел 2 · MCP Client
    Connection Type:  Command Line (STDIO)
    Operation:        Execute Tool
    Tool Name:        {{ $fromAI('tool', 'имя инструмента ChatPush') }}
    Tool Parameters:  {{ $fromAI('tool_parameters', 'параметры инструмента в JSON', 'json') }}

    В списке инструментов у n8n есть и встроенный MCP Client Tool. Для этого способа нужен узел MCP Client из установленного пакета: у него есть поле Connection Type.

  5. Проверьте

    Спросите агента в чате сценария: «Какой у меня баланс в ChatPush?»

Про переменную N8N_COMMUNITY_PACKAGES_ALLOW_TOOL_USAGE. В README узла она названа обязательной, но это верно только для n8n 1.79–1.84. Начиная с 1.85.0 n8n убрал этот флаг: community-узлы доступны агенту как инструменты всегда.

Свой HTTP-сервер и встроенный узел MCP Client Tool

Способ для тех, кто не ставит community-узлы. Сервер ChatPush MCP умеет работать в HTTP-режиме (Streamable HTTP): запустите его из репозитория рядом с n8n. Токен сервер не хранит, он приходит в заголовке каждого запроса.

Терминал · запуск сервера в Docker
git clone https://github.com/ChatPush/mcp-chatpush.git
cd mcp-chatpush
docker build -t chatpush-mcp-server .
docker run -p 3000:3000 -e CHATPUSH_ALLOWED_HOSTS=имя_хоста chatpush-mcp-server

имя_хоста — имя, по которому n8n обращается к серверу, без порта. Проверка: адрес http://имя_хоста:3000/healthz отвечает "status":"ok". Затем добавьте агенту встроенный инструмент:

n8n · настройки узла MCP Client Tool
Узел · MCP Client Tool (встроенный)
Endpoint:          http://имя_хоста:3000/mcp
Server Transport:  HTTP Streamable
Authentication:    Bearer Auth  →  токен ChatPush
Tools to Include:  Selected  →  get_account, send_message, get_delivery_status

В HTTP-режиме send_file принимает файл только в base64. Наружу в интернет такой сервер без HTTPS не выставляйте.

Скоро

n8n Cloud и подключение по ссылке

Удалённый сервер ChatPush MCP готовится. После запуска подключение сведётся к одному встроенному узлу MCP Client Tool: адрес сервера, транспорт HTTP Streamable, авторизация Bearer Auth с токеном ChatPush. Это заработает и в n8n Cloud. Сейчас адрес ещё не работает.

Что можно уже сейчас в n8n Cloud: вызывать API ChatPush узлом HTTP Request или перенести сценарий на self-hosted n8n.

Пушок у ноутбука с CRM, уведомления уходят в телефон
Ассистент работает за компьютером, клиент получает сообщение в мессенджере
Готовые промпты

System Message и задачи для агента

Первый текст вставьте в поле System Message узла AI Agent. Остальные — в поле с задачей: выражения в фигурных скобках подставят данные из триггера.

System Message для AI Agent

Ты помощник салона. Сообщения клиентам отправляй только инструментами ChatPush. Номер телефона передавай в международном формате без плюса, например 79991234567. Порядок каналов: MAX, затем WhatsApp, затем Telegram, SMS последним. После отправки вызови get_delivery_status и верни: номер доставки, канал, статус. Если во входных данных нет номера или текста, ничего не отправляй и верни причину. Одному клиенту по одному событию отправляй одно сообщение.

поле System Message

Напоминание о записи

Клиент {{ $json.name }}, телефон {{ $json.phone }}, запись {{ $json.date }} в {{ $json.time }}. Отправь напоминание о записи: сначала MAX; если не дойдёт, WhatsApp, затем SMS.

send_message

Статус заказа

Заказ {{ $json.order_id }} готов к выдаче. Сообщи об этом клиенту на номер {{ $json.phone }} и верни номер доставки.

send_message

Проверка доставки

Проверь статус доставки {{ $json.delivery_id }} и ответь одной строкой: доставлено, не доставлено или ещё в пути.

get_delivery_status

Счёт файлом

Отправь клиенту на номер {{ $json.phone }} счёт по ссылке {{ $json.invoice_url }} в WhatsApp.

send_file

Проверка подключения

Какой у меня баланс в ChatPush и какие мессенджеры подключены?

get_account
Инструменты

Что получает AI Agent: 19 инструментов ChatPush

Агент сам выбирает инструмент под задачу. Полные описания лежат в репозитории на GitHub.

Отправка

  • send_message
    текст в MAX, WhatsApp*, Telegram, SMS; каскад, отложенная отправка, приоритет, ответ на сообщение
  • send_file
    документ, фото, аудио или видео в WhatsApp* или Telegram, до 100 МБ
  • send_bulk
    одно сообщение по списку номеров

Контроль

  • get_delivery_status
    статус доставки простыми словами
  • delete_delivery
    удалить доставленное сообщение в WhatsApp* или Telegram
  • get_phone_info
    страна и оператор номера
  • get_utm_tags
    UTM-метки рассылок

Аккаунт и входящие

  • get_account
    баланс, тариф, статус мессенджеров
  • get_balance
    баланс и маршрут отправки
  • get_messenger_auth_link
    ссылка на QR для подключения WhatsApp* или Telegram
  • create_webhook
    вебхук на входящие и статусы, ещё 4 инструмента для вебхуков
  • set_chat_client_name
    имя контакта в веб-мессенджере
  • create_sub_customer
    дочерние аккаунты, ещё 2 инструмента

Сценарий отправляет настоящие сообщения настоящим людям

  • Пока тестируете, подставляйте в триггер свой номер и запускайте сценарий вручную. Проверяйте текст и список номеров перед рассылкой.
  • Не публикуйте токен: храните его в credential или в переменной окружения. В текст промпта и в экспортированный сценарий токен попадать не должен.
  • Рассылайте только по своей базе и только тем, кто дал согласие на рассылку (ст. 18 закона «О рекламе», 38-ФЗ). Подробнее: как получить согласие.
  • Community-узлы получают полный доступ к машине, где работает n8n: об этом предупреждает сама n8n. Ставьте их на сервер, который вы контролируете.
Вопросы

n8n и ChatPush MCP: частые вопросы

Как подключить MCP-сервер к AI Agent в n8n?
У n8n два пути. Встроенный узел MCP Client Tool подключает сервер по ссылке: транспорт HTTP Streamable или SSE (устаревший). Community-узел n8n-nodes-mcp запускает сервер командой (stdio) и ставится только на self-hosted n8n. ChatPush MCP сегодня запускается командой npx, поэтому рабочая схема сейчас: self-hosted n8n и community-узел.
Работает ли ChatPush MCP в n8n Cloud?
Пока нет. Неверифицированные community-узлы в n8n Cloud недоступны, а встроенному MCP Client Tool нужна ссылка на сервер. Удалённый сервер ChatPush по ссылке готовится. До его запуска используйте self-hosted n8n или вызывайте API ChatPush узлом HTTP Request.
Нужна ли переменная N8N_COMMUNITY_PACKAGES_ALLOW_TOOL_USAGE?
Только в n8n версий 1.79–1.84. Начиная с версии 1.85.0 n8n убрал этот флаг, и community-узлы доступны агенту как инструменты без настройки.
Есть ли в n8n узел для MAX?
Среди встроенных узлов n8n мессенджера MAX нет: мы сверили документацию n8n 16.11.2026. MAX подключают сторонними узлами. С ChatPush MCP агент получает MAX вместе с WhatsApp*, Telegram, SMS и каскадом каналов одним подключением.
Чем ChatPush MCP отличается от узла Telegram в n8n?
Встроенный узел Telegram работает от имени бота: бот пишет тем, кто уже начал с ним диалог, и в чаты, куда его добавили. ChatPush отправляет по номеру телефона: с аккаунта компании в Telegram или через бота. Если сообщение не дошло, ChatPush пробует следующий канал каскада.
Как собрать WhatsApp-бота в n8n с AI Agent?
Исходящие сообщения агент отправляет инструментом send_message. Для входящих создайте в ChatPush вебхук на адрес узла Webhook в n8n: ChatPush передаст входящее сообщение в сценарий, агент подготовит ответ и отправит его клиенту.
Может ли сценарий отправить одно сообщение дважды?
Сервер ChatPush MCP при сбое сети не повторяет отправку сам. В n8n оставьте выключенной настройку Retry On Fail у узла агента и попросите агента в System Message сначала проверять статус доставки.
Сколько это стоит?
MCP-сервер ChatPush бесплатный и открытый (лицензия MIT). Отправка сообщений идёт по вашему тарифу ChatPush, первые 10 дней бесплатно.
Календарь с сообщениями на разные дни
Отложенная отправка: сообщения уходят в нужное время

Соберите первого агента с отправкой в мессенджеры

Зарегистрируйтесь, подключите мессенджеры по QR-коду и добавьте ChatPush в сценарий n8n. Первые 10 дней бесплатно.

Ещё про ИИ и нейросети

Бесплатные инструменты

Вся справка и инструменты →

Made on
Tilda