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

С токеном бота отправляет и удаляет сообщения, управляет участниками и настройками бота. Давайте боту минимальные права администратора и храните токен в окружении.

Настройка клиентов

claude-code
{
    "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.

Риск: medium Лицензия: MIT ★ 82 058

PraisonAI

Фреймворк агентов PraisonAI с саморефлексией и поддержкой MCP.

Риск: medium Лицензия: MIT ★ 9 327

mcp-atlassian

Поиск, чтение, создание и управление контентом Confluence и Jira, включая Server и Data Center.

Риск: high Лицензия: MIT ★ 6 118

Jitsu

Управление пайплайнами данных Jitsu: направления, потоки, подключения и функции.

Риск: medium Лицензия: MIT ★ 5 132

Источники