Chatroost — неофициальный MCP-сервер Telegram

Chatroost — неофициальный MCP-сервер Telegram — MCP-сервер сообщества (автор — mcp-telegram). Неофициальный сервер Telegram: чтение, поиск, ответы и реакции в вашем аккаунте. Подключается как удалённый сервер. Лицензия MIT.

Опубликовано 13.11.2026 · Обновлено 14.11.2026 · Проверено 13.11.2026

Кратко о сервере

Разработчик
mcp-telegram
Лицензия
MIT
Транспорт
stdio
Авторизация
token_env
ОС
Не указана
Языки
typescript

Уровень риска: high

Полный доступ к личному аккаунту Telegram: отправка, правка и удаление сообщений, профиль, приватность, администрирование групп. Файл сессии равноценен входу в аккаунт; инструменты отправки файлов читают домашнюю и временные папки.

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

cursor
{
    "code": "{\n  \"mcpServers\": {\n    \"telegram\": {\n      \"command\": \"npx\",\n      \"args\": [\n        \"@overpod/mcp-telegram\"\n      ],\n      \"env\": {\n        \"TELEGRAM_API_ID\": \"YOUR_ID\",\n        \"TELEGRAM_API_HASH\": \"YOUR_HASH\"\n      }\n    }\n  }\n}",
    "file": ".cursor/mcp.json",
    "lang": "json",
    "notes": "README: тот же JSON, что для Claude Desktop",
    "verified": "docs"
}

Что умеет

Telegram MCP Server (пакет @overpod/mcp-telegram) подключает ИИ-ассистента к Telegram по протоколу MTProto. Он работает от имени вашего личного аккаунта, а не через ограниченный Bot API. В README перечислено около 140 инструментов: от чтения и отправки сообщений до историй, папок, статистики каналов и настроек приватности.

  • Сообщения: список чатов, непрочитанное, чтение, отправка, правка, пересылка и удаление, отложенные сообщения, реакции, опросы, стикеры и медиа.
  • Поиск: по чатам, по сообщениям в чате и глобально по всем чатам (telegram-search-global).
  • Темы форумов: список тем, сообщения и непрочитанное по каждой теме.
  • Папки чатов: создание, правка, удаление и сортировка.
  • Профиль и приватность: профиль, эмодзи-статус, сеансы, таймеры автоудаления, глобальные настройки приватности.
  • Администрирование: подписи в каналах, антиспам, режим форума, одобрение заявок на вступление.
  • Статистика каналов и супергрупп, бусты, Telegram Business.
  • Истории: чтение, публикация, правка и удаление.

Есть вход по QR-коду, сохранение сессии между перезапусками, работа через SOCKS5 или MTProxy и общий фоновый процесс для нескольких клиентов. Звёзды, групповые звонки и быстрые ответы включаются отдельными переменными окружения.

Кому подойдёт

  • Тем, кто живёт в Telegram: ассистент разберёт непрочитанное, найдёт нужное сообщение и подготовит ответ.
  • Администраторам каналов и групп: статистика, заявки на вступление, истории и настройки в одном месте.
  • Тем, у кого несколько аккаунтов: каждый аккаунт подключается отдельным сервером со своим файлом сессии.

Другие серверы — в категории коммуникации.

Установка

Нужен Node.js 18 или новее и данные приложения Telegram: API_ID и API_HASH со страницы my.telegram.org (раздел API development tools).

Вход по QR-коду:

TELEGRAM_API_ID=YOUR_ID TELEGRAM_API_HASH=YOUR_HASH npx @overpod/mcp-telegram login

Отсканируйте код в Telegram: Настройки → Устройства → Подключить устройство. Если включён облачный пароль, передайте его в TELEGRAM_2FA_PASSWORD: по README пароль используется только локально и не сохраняется.

Другие варианты: глобальная установка npm install -g @overpod/mcp-telegram, готовые бинарники для Linux, macOS и Windows со страницы релизов или Docker.

Подключение к клиентам

Команда и конфиг приведены дословно из README. Для Cursor README советует добавить тот же JSON, что и для Claude Desktop. Общий порядок — в инструкции как подключить MCP.

claude mcp add telegram -s user \
  -e TELEGRAM_API_ID=YOUR_ID \
  -e TELEGRAM_API_HASH=YOUR_HASH \
  -- npx @overpod/mcp-telegram

В Claude Desktop можно войти без терминала: попросите ассистента выполнить telegram-login, и он покажет QR-код.

Проверка

Попросите ассистента выполнить telegram-status. Он должен подтвердить подключение к аккаунту. Если сессии нет, повторите вход по QR-коду.

Инструменты

Инструмент Что делает Доступ
telegram-status Состояние подключения чтение
telegram-list-chats, telegram-get-unread Чаты и непрочитанное чтение
telegram-read-messages Сообщения чата чтение
telegram-search-global Поиск по всем чатам чтение
telegram-send-message Отправка сообщения запись
telegram-edit-message, telegram-delete-message Правка и удаление запись
telegram-create-folder Папка чатов запись
telegram-ban-user Блокировка участника группы запись

Примеры задач

Покажи непрочитанные сообщения и выдели те, где меня о чём-то спрашивают.
Найди во всех чатах сообщение со ссылкой на договор за прошлую неделю.
Сделай папку «Работа» и добавь в неё рабочие чаты.

Риски

Сервер получает полный доступ к личному аккаунту: может отправлять, править и удалять сообщения, менять профиль и приватность, банить участников в группах, где вы администратор. Файл сессии в ~/.mcp-telegram равноценен входу в аккаунт. Инструменты отправки файлов читают файлы из домашней и временных папок.

Как снизить риски: просите ассистента показывать текст перед отправкой, храните API_HASH и файл сессии в безопасности, не включайте инструменты Звёзд без необходимости. Если перестали пользоваться сервером, завершите сеанс в разделе «Устройства». Лицензия — MIT.

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

Это бот или мой аккаунт?

Ваш аккаунт. Сервер работает через MTProto как пользовательский клиент, поэтому видит ваши чаты.

Можно ли подключить несколько аккаунтов?

Да. Для каждого аккаунта задайте свой TELEGRAM_SESSION_PATH и добавьте отдельный сервер.

Что делать, если Telegram заблокирован?

README описывает работу через SOCKS5 или MTProxy (переменные TELEGRAM_PROXY_*) и режим WSS на порту 443.

Основы протокола — на странице что такое MCP-сервер.

Инструменты

  • telegram-status
  • telegram-list-chats
  • telegram-get-unread
  • telegram-read-messages
  • telegram-search-global
  • telegram-send-message
  • telegram-edit-message
  • telegram-delete-message
  • telegram-create-folder
  • telegram-ban-user

Похожие MCP-серверы

Scrapling MCP Server

Веб-скрапинг Scrapling: скрытные HTTP-запросы, настоящие браузеры и CSS-селекторы.

Риск: medium Лицензия: BSD-3-Clause ★ 104 215

World Monitor

Глобальная аналитика в реальном времени: конфликты, рынки, энергетика, торговля, судоходство и кибербезопасность.

Риск: medium Лицензия: AGPL-3.0 ★ 90 905

mcp

Поиск, отчёты и анализ первопричин по метрикам, логам, системам, контейнерам и сетевым соединениям в Netdata.

Риск: medium Лицензия: GPL-3.0 ★ 81 465

Netdata

Мониторинг инфраструктуры Netdata: метрики, логи, алерты и поиск аномалий с ML.

Риск: medium Лицензия: GPL-3.0 ★ 81 465

Источники