MCP-серверы → Telegram Bot API
✓ Бесплатно · уже работает

MCP-сервер для Telegram Bot API

Подключите токен вашего Telegram-бота в кабинете Neurly — и Claude Code, Cursor или любой MCP-совместимый агент сможет читать данные бота: информацию о чатах и каналах, список администраторов, число подписчиков, входящие апдейты и статус вебхука. Только чтение, без риска что-то отправить или сломать.

Подключить за 5 минут Документация

Бесплатно · ключи шифруются · инструменты только для чтения

Кому полезно

Владельцам Telegram-каналов и групп с ботами — следить за числом подписчиков, составом админов и состоянием бота, не открывая BotFather и консоль.
Разработчикам ботов — отлаживать интеграцию прямо из Claude Code: проверить getWebhookInfo, посмотреть последние апдейты и понять, почему бот молчит.
Комьюнити-менеджерам — быстро отвечать на вопросы «кто админ», «сколько участников», «какие права у пользователя» данными из API, а не вручную.
Агентствам, ведущим ботов клиентов — один MCP-эндпоинт вместо самописных скриптов под каждый бот-токен.

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

Никаких дашбордов и выгрузок — обычный вопрос в чате. Агент сам выберет нужные инструменты Telegram Bot API, вызовет их и посчитает ответ.

Сколько участников сейчас в моём канале и кто входит в список администраторов?
Настроен ли вебхук у бота: какой URL, сколько ожидающих апдейтов, была ли последняя ошибка доставки?
Покажи последние входящие сообщения бота через getUpdates и сгруппируй их по чатам.
Какой статус у пользователя с id 123456789 в моей группе — участник, админ или он в бане?
Проверь через getMe, что токен бота рабочий, и скажи, какие у бота имя и username.
Из какого чата пришло больше всего апдейтов за сегодня?
…агент вызывает инструменты Telegram Bot API и отвечает цифрами вашего аккаунта

8 инструментов — только чтение

Технические детали — для разработчиков
Какие ключи нужны
Токен бота от @BotFather вида «123456:ABC-DEF…»; передаётся прямо в URL запроса: https://api.telegram.org/bot<token>/METHOD. Пользователь берёт токен в диалоге с BotFather (команда /newbot или /token) и добавляет его в кабинете Neurly, где он хранится в зашифрованном виде.
Лимиты API
Точные лимиты на чтение не публикуются; известные ограничения на отправку — около 30 сообщений в секунду на бота (платные рассылки расширяют до 1000/с за Telegram Stars), не более 1 сообщения в секунду в один чат и ~20 в минуту в одну группу. При превышении API отвечает HTTP 429 с полем retry_after.
Что учитываем за вас
  • getUpdates и вебхук взаимоисключающие: пока у бота настроен webhook, метод getUpdates возвращает ошибку 409 — MCP-сервер это учитывает и подсказывает состояние через getWebhookInfo.
  • Непрочитанные апдейты хранятся на серверах Telegram не дольше 24 часов; пагинация getUpdates идёт по offset = последний update_id + 1.
  • Бот видит только «свои» данные: чаты, куда он добавлен, и адресованные ему сообщения. Историю чужих переписок или произвольные каналы Bot API не отдаёт — это ограничение Telegram, а не Neurly.
  • Все ответы API приходят в JSON-обёртке {ok, result}; актуальная версия — Bot API 10.x, метод getMe позволяет мгновенно проверить валидность токена.

Как подключить

1
Зарегистрируйтесь в Neurly
Без карты. MCP-вызовы бесплатны — баланс не расходуется.
2
Подключите Telegram Bot API
Скопируйте токен бота из диалога с @BotFather (команда /newbot или /token) и вставьте его в разделе «MCP» кабинета Neurly. Чтобы агент видел данные канала или группы — добавьте туда бота.
3
Добавьте эндпоинт в клиент
Одна команда в Claude Code или пара строк конфига в Cursor — инструменты появятся у агента.
claude mcp add --transport http neurly https://neurly.ru/v1/mcp --header "Authorization: Bearer sk-neurly-..."
Начать бесплатно

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

Что такое MCP-сервер для Telegram Bot API простыми словами?

Это готовый «мост» между вашим Telegram-ботом и ИИ-агентом. Model Context Protocol (MCP) — открытый стандарт, по которому Claude Code, Cursor и другие агенты подключают внешние инструменты. Neurly хостит такой сервер у себя: вы добавляете токен бота в кабинете, агент получает набор read-only инструментов (getMe, getChat, getUpdates и другие) и может отвечать на вопросы о вашем боте живыми данными — без написания кода и установки чего-либо локально.

Как подключить бота к Claude Code или Cursor?

Зарегистрируйтесь на neurly.ru, в разделе «MCP» кабинета вставьте токен бота из @BotFather, затем добавьте эндпоинт Neurly в свой клиент: в Claude Code это одна команда claude mcp add, в Cursor — пять строк в ~/.cursor/mcp.json. Готовые сниппеты — в кабинете. Чтобы агент видел данные канала или группы, добавьте туда бота.

Безопасно ли передавать Neurly токен бота?

Токен хранится в зашифрованном виде и не попадает в логи. Все инструменты MCP-сервера — только чтение: агент не может отправлять сообщения от имени бота, менять настройки, банить пользователей или удалять что-либо. В любой момент токен можно отозвать в кабинете Neurly или перевыпустить через @BotFather — старый сразу перестанет действовать.

Сколько это стоит?

MCP-серверы Neurly бесплатны и останутся бесплатными. Нужен только аккаунт на neurly.ru с положительным балансом — сам баланс при работе MCP-инструментов не расходуется. Сам Telegram Bot API тоже бесплатен для чтения данных.

Чем Bot API отличается от «полного» доступа к Telegram и что бот сможет показать?

Bot API работает от имени бота, а не вашего личного аккаунта (в отличие от клиентского MTProto API). Бот видит только чаты, куда его добавили, и адресованные ему сообщения; непрочитанные апдейты Telegram хранит максимум 24 часа. Зато через него доступны точные данные о каналах и группах бота: число подписчиков, администраторы и их права, статус любого участника, состояние вебхука. Читать чужие каналы или личные переписки нельзя — это ограничение самого Telegram.

Уже есть community MCP-серверы для Telegram — зачем hosted-вариант Neurly?

Да, в open source существуют MCP-серверы для Telegram (как для Bot API, так и для клиентского API), официального от Telegram нет. Их нужно устанавливать локально, настраивать окружение и самому заботиться о хранении токена. Hosted-вариант Neurly ничего не требует ставить: один эндпоинт, токен зашифрован на нашей стороне, инструменты строго read-only, а рядом в том же кабинете — остальные интеграции Neurly (например, Ozon Seller). Подключение сводится к одной строке конфигурации в Claude Code или Cursor.

Другие MCP-серверы

DaData Ozon Seller API Roistat Webasyst / Shop-Script Wildberries Битрикс24 Т-Банк (бизнес) Яндекс.Метрика 1С:Предприятие 2ГИС amoCRM API Яндекс.Карт Borzo (Достависта) BotHelp Boxberry Calltouch Carrot quest Chat2Desk Checko CloudPayments CoMagic DashaMail DPD Ecwid Frontpad GetCourse hh.ru iiko InSales Jivo Kaiten Lamoda LiveDune Mindbox PromoPult Pyrus RetailCRM Robokassa Rusprofile RUTUBE Salebot Sendsay SMS.ru SMSC.ru SuperJob Tilda Topvisor UIS Unisender VK API VK Реклама Wazzup YCLIENTS YouGile Zadarma Авито Альфа-Банк (бизнес) АТОЛ Онлайн ВТБ (бизнес) Деловые Линии Контур.Диадок Контур.Фокус Контур.Экстерн Контур.Эльба Манго Офис Мегамаркет Мегаплан Модульбанк МойКласс МойСклад Московская биржа Моё дело МТС Exolve ПланФакт Планфикс Почта России ПЭК СберБизнес СБИС (Saby) СДЭК СПАРК-Интерфакс Т-Инвестиции Т-Касса Точка Банк Финолог Хантфлоу ЦБ РФ Честный ЗНАК Эвотор ЮKassa Юздеск Яндекс 360 Яндекс.Вебмастер Яндекс.Вордстат Яндекс.Директ Яндекс.Диск Яндекс.Доставка Яндекс.Маркет Яндекс.Трекер Все MCP-серверы →