Для разработчиков · GigaChat API, LangChain и ChatPush MCP

GigaChat MCP: агент на ГигаЧате отправляет сообщения в MAX, WhatsApp*, Telegram и SMS

Сразу о главном: в приложении ГигаЧат подключить свой MCP-сервер сейчас нельзя. Эта страница для тех, кто пишет код на GigaChat API.

Агент на LangChain получает инструменты ChatPush через langchain-mcp-adapters, как в официальном туториале Сбера. GigaChat решает, кому и куда написать, а ChatPush отправляет сообщение с номера вашей компании.

Работает сегодня: агент сам запускает сервер командой npx -y chatpush-mcp-server. Сервер открытый и бесплатный, отправка — по вашему тарифу ChatPush.

agent.py · GigaChat-2-Maxпример
Сценарий:
Честно про статус на 17.11.2026

Где ГигаЧат умеет MCP, а где нет

Нет

Приложение ГигаЧат

Своих MCP-серверов в приложении и в агентах ГигаЧата в справке Сбера нет. Если вы ищете ГигаЧат-бота в MAX, чтобы переписываться с ним самим, это другая задача: ИИ в MAX.

Function calling

GigaChat API

Модель вызывает функции, MCP подключает фреймворк. Сбер показывает это в туториале GigaChain «Работа GigaChat-агента с MCP-сервером». У модели GigaChat 2 Max в возможностях указана поддержка функций.

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

Агент + ChatPush MCP

Агент запускает сервер ChatPush командой npx на той же машине. Подключение по ссылке mcp.chatpush.ru готовится.

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

Как агент на GigaChat отправляет сообщение: пять узлов

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

→→→→

Ваш код

Любой Python-сервис: обработчик вебхука из CRM, задача по расписанию для напоминаний, чат-бот для менеджеров. Он передаёт агенту задачу обычными словами и данные: имя клиента, телефон, время записи.

Подключение · Python

GigaChat + ChatPush MCP: агент на Python за шесть шагов

Код построен по туториалу Сбера и обновлён под текущие версии библиотек. Мы установили пакеты и проверили: сервер ChatPush запускается, агент получает 19 инструментов, все они переводятся в функции GigaChat. Запрос к GigaChat с вашим ключом — ваш первый тест.

  1. Получите токен ChatPush. Зарегистрируйтесь, откройте в кабинете раздел «Интеграции» и скопируйте API-токен. Подключите MAX, WhatsApp* или Telegram по QR-коду. Регистрация, первые 10 дней бесплатно.
  2. Получите ключ GigaChat API. В личном кабинете Studio: проект GigaChat API → «Настройки API» → «Получить ключ». Authorization Key показывается один раз, сохраните его.
  3. Установите пакеты. Нужны Python 3.11+ и Node.js 20+ (проверка: node --version).
    терминал
    pip install -U langchain-gigachat langchain-mcp-adapters langchain
  4. Задайте переменные окружения. Для компаний вместо GIGACHAT_API_PERS — GIGACHAT_API_B2B или GIGACHAT_API_CORP.
    терминал
    export GIGACHAT_CREDENTIALS="ваш_ключ_авторизации"
    export GIGACHAT_SCOPE="GIGACHAT_API_PERS"
    export CHATPUSH_TOKEN="ваш_токен"
  5. Создайте agent.py. Агент берёт инструменты ChatPush и работает в цикле: так он может показать рассылку и дождаться вашего «да».
    agent.py
    import asyncio
    import os
    
    from langchain.agents import create_agent
    from langchain_gigachat import GigaChat
    from langchain_mcp_adapters.client import MultiServerMCPClient
    
    RULES = (
        "Ты отправляешь сообщения клиентам компании через ChatPush. "
        "Номера пиши в формате 79991234567. Если канал не назван, спроси. "
        "Перед рассылкой покажи текст и список номеров и жди подтверждения. "
        "После отправки проверь статус доставки."
    )
    
    
    async def main():
        client = MultiServerMCPClient({
            "chatpush": {
                "transport": "stdio",
                "command": "npx",
                "args": ["-y", "chatpush-mcp-server"],
                "env": {"CHATPUSH_TOKEN": os.environ["CHATPUSH_TOKEN"]},
            }
        })
        tools = await client.get_tools()  # 19 инструментов ChatPush
        model = GigaChat(model="GigaChat-2-Max")  # ключ и scope из GIGACHAT_*
        agent = create_agent(model, tools, system_prompt=RULES)
    
        messages = []
        while True:
            text = input("Вы: ").strip()
            if not text:
                break
            messages.append({"role": "user", "content": text})
            result = await agent.ainvoke({"messages": messages})
            messages = result["messages"]
            print("Агент:", messages[-1].content)
    
    
    asyncio.run(main())
  6. Запустите python agent.py и спросите:
    • Какой у меня баланс в ChatPush?
    Первый запуск дольше: npx скачивает пакет сервера. В консоль сервер пишет строку ChatPush MCP Server v1.0.1 — 19 tools loaded, это нормально.

Источники: developers.sber.ru (туториал GigaChain «Работа GigaChat-агента с MCP-сервером», обновлён 15.05.2026; «Получение ключа» для физлиц), исходники langchain-mcp-adapters 0.3.2, langchain-gigachat 0.5.1 и langchain 1.5.0 из PyPI. Проверено 17.11.2026.

MAX

ГигаЧат + MAX: российская модель пишет клиентам в российский мессенджер

Агент отправляет сообщения в MAX по номеру телефона с аккаунта вашей компании, добавлять клиента в контакты не нужно. Если у клиента нет MAX, каскад передаст сообщение в WhatsApp*, Telegram или по SMS.

Задачи, которые отдают агенту

  • Напоминания о записи из выгрузки CRM: каждому своё время и адрес.
  • Статусы заказов и коды подтверждения, с запасным каналом SMS.
  • Файлы в MAX: счёт, договор, фото. Подпись к файлу сервер передаёт только в WhatsApp*, в MAX текст отправьте отдельным сообщением.
  • Рассылки по своей базе после проверки текста и списка.
  • Аккаунт MAX подключается в кабинете ChatPush: MAX в ChatPush. Обзор: MAX MCP-сервер.

Что написать агенту

  • Напомни в MAX всем из файла zapisi.csv: время и адрес. Кому не дойдёт — по SMS. Сначала покажи список
  • Отправь в MAX на +7 999 123-45-67 файл ./schet-118.pdf, потом напиши: счёт на оплату во вложении
  • Напиши в MAX на +7 999 123-45-67: заказ №1045 собран. Не дойдёт — отправь по SMS
Помощник

Что передать агенту: готовые фразы

Выберите задачу и канал. Фразу можно ввести в цикле агента или собрать в своём коде из данных CRM.

Канал:
Задача агентуНапиши в MAX на +7 999 123-45-67: Анна, ваш заказ готов, заберите до 20:00

GigaChat вызовет: send_message
Агент вернёт номер отправки. По нему потом можно проверить статус.

Возможности

19 инструментов, которые получит GigaChat

Агент выбирает инструмент по задаче. Если какие-то действия агенту не нужны, отфильтруйте список tools по имени перед create_agent.

ОтправкаСообщение, файл или рассылка по списку. Каскад, отложенная отправка, приоритет, ответ на сообщение.send_messagesend_filesend_bulk
ДоставкаСтатус простыми словами, удаление доставленного сообщения, страна и оператор номера.get_delivery_statusdelete_deliveryget_phone_info
АккаунтБаланс, подключённые каналы, UTM-метки, ссылка на подключение мессенджера, имя контакта.get_accountget_balanceget_utm_tagsget_messenger_auth_linkset_chat_client_name
ВебхукиВаш сервис получает входящие сообщения, статусы доставки и события входа.create_webhookget_webhooklist_webhooksupdate_webhookdelete_webhook
СубклиентыОтдельные клиенты внутри аккаунта, у каждого свой токен.create_sub_customerlist_sub_customersget_sub_customer

Исходный код сервера: GitHub, пакет chatpush-mcp-server в npm.

Безопасность

Четыре правила до первой отправки

Агент отправляет настоящие сообщения настоящим людям. Тестируйте на своём номере.

1

Подтверждение перед рассылкой

Запишите правило в system_prompt, а массовую отправку запускайте только после «да» человека.

2

Токены в переменных

CHATPUSH_TOKEN и ключ GigaChat держите в окружении или хранилище секретов, не в коде и не в репозитории.

3

Рассылки только по своей базе

Рекламные сообщения — тем, кто дал согласие: статья 18 закона «О рекламе» (38-ФЗ). Как получить согласие

4

Лишние инструменты уберите

Если агенту не нужны удаление сообщений и вебхуки, не передавайте их. При сбое связи сервер сам не повторяет отправку.

Золотой ключ перед открытым сейфом
Токен ChatPush даёт доступ к отправке: храните его как пароль
Вопросы

Частые вопросы: GigaChat, MCP и отправка сообщений

Поддерживает ли GigaChat MCP?
В самом GigaChat API нет инструмента для MCP: модель умеет вызов функций (function calling). MCP-сервер подключает фреймворк. Сбер показывает это в официальном туториале GigaChain «Работа GigaChat-агента с MCP-сервером»: агент на LangChain получает инструменты сервера через библиотеку langchain-mcp-adapters, а GigaChat решает, какой из них вызвать.
Можно ли подключить MCP-сервер в приложении ГигаЧат?
Сейчас нет. В справке Сбера по приложению ГигаЧат и по агентам такой функции нет (проверено 17.11.2026). Связка ГигаЧата и ChatPush работает в коде разработчика через GigaChat API.
Как отправить сообщение через GigaChat API?
GigaChat API сам сообщения в мессенджеры не отправляет: он пишет текст и выбирает, какую функцию вызвать. Отправку делает ChatPush. Дайте агенту на GigaChat инструменты ChatPush MCP, и по просьбе «напиши в MAX на +7…» он вызовет send_message, а ChatPush доставит сообщение в MAX, WhatsApp*, Telegram или по SMS.
Какие библиотеки нужны?
Python 3.11 или новее и пакеты langchain-gigachat, langchain-mcp-adapters и langchain. Для запуска сервера ChatPush нужен Node.js 20 или новее: агент сам выполнит команду npx -y chatpush-mcp-server.
Почему в туториале Сбера async with MultiServerMCPClient, а у вас нет?
С версии langchain-mcp-adapters 0.1.0 клиент нельзя открывать через async with: библиотека выдаст ошибку. Теперь инструменты берут так: client = MultiServerMCPClient(...), затем tools = await client.get_tools(). Функция create_react_agent из langgraph тоже помечена устаревшей, её заменила create_agent из langchain.agents.
Вызывает ли GigaChat несколько инструментов сразу?
Нет. По описанию langchain-gigachat, GigaChat API не поддерживает несколько вызовов функций в одном ответе. Агент вызывает инструменты по очереди: например, сначала send_message, затем get_delivery_status.
Сколько это стоит?
MCP-сервер ChatPush бесплатный, лицензия MIT. Отправка идёт по вашему тарифу ChatPush: «Старт» 2 500 ₽ (1 мессенджер), «Плюс» 4 000 ₽ (2), «Супер» 6 500 ₽ (3) за номер в месяц, первые 10 дней бесплатно. SMS оплачиваются отдельно за сообщение. Токены GigaChat оплачиваются по тарифам Сбера.
Где взять ключ GigaChat API?
В личном кабинете Studio откройте проект GigaChat API, раздел «Настройки API», нажмите «Получить ключ». Authorization Key показывается один раз, сохраните его сразу. Ключ кладите в переменную GIGACHAT_CREDENTIALS, версию API — в GIGACHAT_SCOPE: GIGACHAT_API_PERS для физлиц, GIGACHAT_API_B2B или GIGACHAT_API_CORP для компаний.
Python ругается на сертификат при запросе к GigaChat. Что делать?
Укажите путь к нужному сертификату в переменной GIGACHAT_CA_BUNDLE_FILE, как советует описание langchain-gigachat. Отключать проверку сертификатов можно только для локальной разработки.
Отправит ли агент сообщение дважды при сбое связи?
Сервер ChatPush сам не повторяет отправку, если ответ не пришёл. Агент сначала проверит статус сообщения и только потом решит, нужна ли повторная отправка.

Дайте агенту на GigaChat ваши каналы связи

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

Made on
Tilda