telegram-bot-mcp
telegram-bot-mcp — MCP-сервер сообщества (автор — FantomaSkaRus1). Полное покрытие Telegram Bot API: 174 инструмента для сообщений, чатов, стикеров, платежей и форумов. Лицензия MIT.
Опубликовано 13.11.2026 · Обновлено 13.11.2026 · Проверено 13.11.2026
Кратко о сервере
- Разработчик
- FantomaSkaRus1
- Лицензия
- MIT
- Транспорт
- stdio
- Авторизация
- token_env
- ОС
- Не указана
- Языки
- javascript
Уровень риска: high
С токеном бота отправляет и удаляет сообщения, управляет участниками и настройками бота. Давайте боту минимальные права администратора и храните токен в окружении.
Настройка клиентов
{
"code": "claude mcp add -e TELEGRAM_BOT_TOKEN=your_token telegram -- node /path/to/mcp-telegram/index.js",
"lang": "bash",
"notes": "Дословно из README",
"verified": "docs"
}
Что умеет
telegram-bot-mcp — MCP-сервер для Telegram Bot API. По данным README, он даёт 174 инструмента и покрывает весь Bot API: сообщения, чаты, стикеры, форумы, истории и другие разделы. Ассистент управляет вашим ботом в Telegram: отправляет и редактирует сообщения, настраивает чаты и самого бота.
- Сообщения: отправка текста, фото, видео, аудио, документов, геопозиции, опросов, кубиков, стикеров и медиагрупп, редактирование, пересылка, копирование, удаление, закрепление и реакции.
- Чаты: информация, настройки, права, ссылки-приглашения, управление участниками, верификация.
- Бот: команды, профиль, настройки, описание, кнопка меню, права администратора.
- Стикеры: создание, изменение и удаление наборов, загрузка стикеров, пользовательские эмодзи.
- Форумы: создание, изменение, закрытие, повторное открытие и удаление тем.
- Истории: публикация, изменение, удаление, репост.
- Бизнес-аккаунты, игры и вебхуки: бизнес-сообщения и подключения, отправка игр и рекорды, установка и удаление вебхуков.
Переменная TELEGRAM_DEFAULT_CHAT_ID задаёт чат по умолчанию, чтобы не указывать chat_id в каждом вызове, а TELEGRAM_DEFAULT_THREAD_ID — тему по умолчанию в форумных супергруппах.
Кому подойдёт
- Владельцам ботов и каналов: публикации, закрепы и рассылка в чаты от имени бота по текстовой просьбе.
- Администраторам сообществ: управление участниками, ссылками-приглашениями и темами форума.
- Разработчикам ботов: быстрые эксперименты с методами Bot API без написания кода.
Похожие серверы — в категории коммуникации.
Установка
Сервер ставится из исходников: склонируйте репозиторий и установите зависимости командой npm install. Затем укажите путь к index.js в конфигурации клиента.
Обязательная переменная — TELEGRAM_BOT_TOKEN, токен бота от @BotFather. Необязательные — TELEGRAM_DEFAULT_CHAT_ID и TELEGRAM_DEFAULT_THREAD_ID. Бот может писать только в те чаты, куда его добавили или где пользователь начал с ним диалог.
Подключение к клиентам
Команда и конфиг приведены дословно из README. Замените путь и токен на свои. Общий порядок — в инструкции как подключить MCP.
claude mcp add -e TELEGRAM_BOT_TOKEN=your_token telegram -- node /path/to/mcp-telegram/index.jsПроверка
Попросите ассистента получить информацию о боте. Затем отправьте тестовое сообщение в чат, где бот состоит. Если запросы не проходят, проверьте токен и путь к index.js.
Примеры задач
Отправь в наш канал пост с этим текстом и закрепи его.Создай в форумной группе тему «Вопросы новичков» и пришли ссылку-приглашение.Риски
С токеном бота ассистент получает все права бота: отправляет и удаляет сообщения, управляет участниками там, где бот администратор, меняет профиль бота и вебхуки. Ошибочная рассылка или удаление участников затронет живые чаты. Токен бота даёт полный контроль над ним.
Как снизить риски: выдавайте боту только нужные права администратора, храните токен в переменных окружения и не публикуйте конфиг с ним. Проверяйте сообщения перед отправкой в публичные чаты. Лицензия — MIT.
Частые вопросы
Можно ли не указывать chat_id каждый раз?
Да. Задайте TELEGRAM_DEFAULT_CHAT_ID, а для тем форума — TELEGRAM_DEFAULT_THREAD_ID.
Работает ли с личным аккаунтом?
Нет, сервер работает через Bot API, то есть от имени бота.
Основы протокола — на странице что такое MCP-сервер.
Похожие MCP-серверы
Ruflo
Команды и рои агентов, память и хуки для Claude Code и Codex.
PraisonAI
Фреймворк агентов PraisonAI с саморефлексией и поддержкой MCP.
mcp-atlassian
Поиск, чтение, создание и управление контентом Confluence и Jira, включая Server и Data Center.
Jitsu
Управление пайплайнами данных Jitsu: направления, потоки, подключения и функции.