Telegram API MCP
telegram-api-mcp
MCP-сервер для Telegram Bot API: сообщения, каналы, форумы, платежи и длинные посты от имени бота с учетом лимитов Telegram
- 33 ★ репозитория
- Последний коммит
- MIT
Широкий доступ
Почему такой уровень
- Агент может публиковать, удалять сообщения и банить участников от имени бота
- Есть методы платежей и подарков за звезды Telegram
- Требует секретный токен бота
Установка
- Работает в
- Сервисы
Ручная установка
claude mcp add telegram -- npx telegram-api-mcp -e TELEGRAM_BOT_TOKEN=your_tokenДля экономии контекста добавьте -e TELEGRAM_META_MODE=true.
Доступ и проверки
Как мы проверяемШирокий доступИнструмент может менять данные, выполнять команды или работать с секретами.
- Агент может публиковать, удалять сообщения и банить участников от имени бота
- Есть методы платежей и подарков за звезды Telegram
- Требует секретный токен бота
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Сервер открывает агенту все методы Telegram Bot API: отправку и правку сообщений, медиа, опросы, управление чатами и участниками, форумы, стикеры, платежи, истории и подарки. Длинные посты с заголовками, таблицами и медиа публикуются через rich messages, а инструмент telegram_format заранее объясняет агенту формат сложных параметров. Режим meta-mode заменяет полный список инструментов двумя: поиском метода и его вызовом, что экономит контекст. Встроены ограничение частоты запросов, повторы при ошибках 429 и 5xx, circuit breaker и проверка параметров через Zod.
Для кого. Для тех, кто ведет Telegram-каналы и группы или разрабатывает ботов и хочет управлять ими через агента.
Подходит, если
- Нужно публиковать посты в канал от имени бота прямо из агента
- Нужно модерировать группу: закреплять, удалять, ограничивать участников
- Нужно отлаживать бота и проверять методы Bot API без своего кода
Не подходит, если
- Нужен доступ к личному аккаунту Telegram, а не к боту
- Нельзя давать агенту право писать и удалять сообщения в рабочих чатах
Пример запроса к агенту
Опубликуй в канал @mychannel пост с заголовком, таблицей цен и картинкойMCP
- Транспорт
- stdio
- Авторизация
- API-ключ
Переменные окружения
TELEGRAM_BOT_TOKENобязательная, секрет- Токен бота от BotFather
TELEGRAM_DEFAULT_CHAT_ID- Чат по умолчанию для всех инструментов
TELEGRAM_META_MODE- true включает режим из двух инструментов
TELEGRAM_ALLOWED_UPLOAD_DIRS- Каталоги, из которых разрешена загрузка файлов, через запятую
Ограничения
Работает только от имени бота: нужен токен от BotFather, и бот должен быть добавлен в нужные чаты с правами администратора. Подпись к медиа по-прежнему ограничена лимитом Telegram, для длинных текстов нужен send_rich_message. Сервер ходит только на api.telegram.org, доступность этого адреса из России без VPN зависит от провайдера.
Как отключить. Выполните claude mcp remove telegram или удалите блок telegram из конфигурации MCP клиента. Токен бота можно отозвать в BotFather.
Частые вопросы
Зачем meta-mode?
Вместо полного набора инструментов агент видит два: telegram_find и telegram_call. Контекст почти не расходуется, а доступ ко всему API сохраняется.
Попадет ли токен в ответы агента?
Нет, по README токен маскируется в ответах, логах и сообщениях об ошибках.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
Telegram — все инструментыMCP-сервер на Telethon: агент читает и отправляет сообщения, управляет чатами, контактами и папками вашего аккаунта Telegram
MCP Telegram с записью: агент отправляет, правит и удаляет сообщения, ищет чаты, ведет черновики и скачивает медиа в вашем аккаунте через MTProto
Telegram MCP от chaindead
Telegram MCP
MCP-сервер на Go для вашего Telegram: агент читает диалоги и непрочитанное, отмечает прочитанным, ответы кладет в черновики
MCP Telegram для чтения: агент получает список диалогов и непрочитанные сообщения вашего аккаунта через MTProto, писать от вашего имени он не умеет
MCP-мост из VK в Telegram
vk-tg-bridge
MCP-сервер на 4 инструмента: забирает посты со стены VK, фильтрует по правилам и публикует в Telegram через Bot API
MCP контент-фабрика для Telegram, VK и MAX
publish-mcp
MCP-сервер генерирует, переводит и публикует посты в Telegram, VK, MAX и Threads: бренд-профиль, анализ конкурентов и картинки одним пайплайном
Из блога
Коротко о README
README перечисляет покрытие Bot API по категориям, от сообщений и чатов до бизнес-аккаунтов и управляемых ботов. Есть команды подключения для Claude Code и Claude Desktop, вариант с чатом по умолчанию и сборка из исходников. Отдельно описаны rich messages с их лимитами, meta-mode, архитектура с декларативным реестром методов и скрипт сверки реестра с официальной документацией. В разделе безопасности указаны маскировка токена, защита загрузки файлов и отсутствие телеметрии. Лицензия MIT.