Telegram API MCP
telegram-api-mcp
MCP-сервер для Telegram Bot API: сообщения, каналы, форумы, платежи и длинные посты от имени бота с учетом лимитов Telegram
Установка
claude mcp add telegram -- npx telegram-api-mcp -e TELEGRAM_BOT_TOKEN=your_tokenДля экономии контекста добавьте -e TELEGRAM_META_MODE=true.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Сервер открывает агенту все методы Telegram Bot API: отправку и правку сообщений, медиа, опросы, управление чатами и участниками, форумы, стикеры, платежи, истории и подарки. Длинные посты с заголовками, таблицами и медиа публикуются через rich messages, а инструмент telegram_format заранее объясняет агенту формат сложных параметров. Режим meta-mode заменяет полный список инструментов двумя: поиском метода и его вызовом, что экономит контекст. Встроены ограничение частоты запросов, повторы при ошибках 429 и 5xx, circuit breaker и проверка параметров через Zod.
Для кого. Для тех, кто ведет Telegram-каналы и группы или разрабатывает ботов и хочет управлять ими через агента.
Подходит, если
- Нужно публиковать посты в канал от имени бота прямо из агента
- Нужно модерировать группу: закреплять, удалять, ограничивать участников
- Нужно отлаживать бота и проверять методы Bot API без своего кода
Не подходит, если
- Нужен доступ к личному аккаунту Telegram, а не к боту
- Нельзя давать агенту право писать и удалять сообщения в рабочих чатах
Пример запроса к агенту
Опубликуй в канал @mychannel пост с заголовком, таблицей цен и картинкойОграничения
Работает только от имени бота: нужен токен от BotFather, и бот должен быть добавлен в нужные чаты с правами администратора. Подпись к медиа по-прежнему ограничена лимитом Telegram, для длинных текстов нужен send_rich_message. Сервер ходит только на api.telegram.org, доступность этого адреса из России без VPN зависит от провайдера.
Как отключить. Выполните claude mcp remove telegram или удалите блок telegram из конфигурации MCP клиента. Токен бота можно отозвать в BotFather.
MCP
- Транспорт
- stdio
- Авторизация
- API-ключ
| Переменные окружения | |
|---|---|
| TELEGRAM_BOT_TOKEN обязательная, секрет | Токен бота от BotFather |
| TELEGRAM_DEFAULT_CHAT_ID | Чат по умолчанию для всех инструментов |
| TELEGRAM_META_MODE | true включает режим из двух инструментов |
| TELEGRAM_ALLOWED_UPLOAD_DIRS | Каталоги, из которых разрешена загрузка файлов, через запятую |
Проверка безопасности
- Агент может публиковать, удалять сообщения и банить участников от имени бота
- Есть методы платежей и подарков за звезды Telegram
- Требует секретный токен бота
Коротко о README
README перечисляет покрытие Bot API по категориям, от сообщений и чатов до бизнес-аккаунтов и управляемых ботов. Есть команды подключения для Claude Code и Claude Desktop, вариант с чатом по умолчанию и сборка из исходников. Отдельно описаны rich messages с их лимитами, meta-mode, архитектура с декларативным реестром методов и скрипт сверки реестра с официальной документацией. В разделе безопасности указаны маскировка токена, защита загрузки файлов и отсутствие телеметрии. Лицензия MIT.
Частые вопросы
Зачем meta-mode?
Вместо полного набора инструментов агент видит два: telegram_find и telegram_call. Контекст почти не расходуется, а доступ ко всему API сохраняется.
Попадет ли токен в ответы агента?
Нет, по README токен маскируется в ответах, логах и сообщениях об ошибках.
Похожие
Marketing Skills: маркетинговые скиллы для агентов
Marketing Skills for AI Agents
Около пятидесяти скиллов по CRO, копирайтингу, SEO, аналитике, рекламе и запуску продукта для кодовых агентов
Скилл, который убирает из текста приметы ИИ-письма по списку Википедии и не добавляет выдуманных фактов
Скиллы для контента: иллюстрации к статьям, обложки, инфографика, комиксы, перевод, конвертация URL в Markdown и публикация в соцсети
Китайская версия скилла Humanizer: находит и убирает приметы AI-текста в материалах на китайском