Fast MCP Telegram

Fast MCP Telegram — MCP-сервер сообщества (автор — leshchenko1979). Многопользовательский шлюз Telegram для ИИ-агентов через MTProto User API: HTTP и stdio, 8 инструментов. Ставится через uvx. Доступен и как удалённый сервер. Лицензия MIT.

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

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

Разработчик
leshchenko1979
Лицензия
MIT
Транспорт
stdio, streamable_http
Авторизация
other
ОС
linux, macos, windows
Языки
python

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

Полный доступ к аккаунту Telegram: чтение всех чатов и отправка сообщений от вашего имени. Запускайте локально, в режиме http-auth используйте `read_only`.

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

claude-desktop
{
    "code": "{\n  \"mcpServers\": {\n    \"telegram\": {\n      \"command\": \"uvx\",\n      \"args\": [\"fast-mcp-telegram\"],\n      \"env\": {\n        \"API_ID\": \"your_api_id\",\n        \"API_HASH\": \"your_api_hash\"\n      }\n    }\n  }\n}",
    "file": "claude_desktop_config.json",
    "lang": "json",
    "notes": "Дословно из README, локальный режим stdio",
    "verified": "docs"
}

Что умеет

fast-mcp-telegram — MCP-шлюз к Telegram, который работает от имени вашего аккаунта по протоколу MTProto. Вместо 80 с лишним мелких методов API он даёт ассистенту 8 компактных инструментов:

Инструмент Что делает
search_messages_globally Поиск по всем чатам: несколько слов, фильтры по дате и типу чата
get_messages Чтение сообщений: поиск и просмотр, чтение по id, ответы в постах и темах
send_message Отправка сообщения с файлами, разметкой markdown или html, ответом на сообщение
edit_message Правка отправленного сообщения
find_chats Поиск пользователей, групп и каналов, фильтр по папкам, поиск по username и телефону
get_chat_info Профиль: число участников, описание, статус, темы форума, общие группы
send_message_to_phone Сообщение на номер телефона с автоматическим добавлением контакта
invoke_mtproto Прямой вызов методов Telegram API для опытных пользователей

Вход возможен по QR-коду (без ввода телефона и кода), по номеру телефона или через токен бота. Сервер работает локально по stdio или как общий HTTP-сервер для нескольких пользователей: у каждого свой токен и свой аккаунт Telegram.

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

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

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

Установка

Нужны api_id и api_hash приложения Telegram. Сначала один раз создайте сессию. Вариант с QR-кодом — дословно из документации проекта:

uvx --from fast-mcp-telegram fast-mcp-telegram-setup \
  --api-id="your_api_id" \
  --api-hash="your_api_hash"

В терминале появится QR-код. Откройте Telegram на телефоне → Настройки → Устройства → «Подключить устройство» и отсканируйте его. Если включена двухэтапная проверка, программа спросит пароль. Вместо QR можно передать --phone-number или --bot-api-token для входа ботом.

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

Конфиг приведён дословно из README. Для локального сервера по stdio добавьте блок в конфиг клиента, например в claude_desktop_config.json. Общий порядок — в инструкции как подключить MCP.

claude_desktop_config.json
{
  "mcpServers": {
    "telegram": {
      "command": "uvx",
      "args": ["fast-mcp-telegram"],
      "env": {
        "API_ID": "your_api_id",
        "API_HASH": "your_api_hash"
      }
    }
  }
}

Для удалённого режима http-auth в конфиг вместо команды прописываются адрес сервера и заголовок Authorization с вашим токеном.

Проверка

Попросите ассистента: «Отправь "привет" в мои Избранные в Telegram». Сообщение должно появиться в «Избранном».

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

Найди в Telegram сообщения про отпуск за последний месяц и перескажи главное.
Сколько участников в группе нашего проекта и какие в ней темы?

Риски

Сервер получает полный доступ к вашему аккаунту Telegram: читает все чаты, отправляет и правит сообщения от вашего имени, пишет на номера телефонов. invoke_mtproto вызывает любые методы API. Файл сессии равнозначен входу в аккаунт. У автора есть демо-сервер: при его использовании сессия создаётся на чужом сервере.

Что встроено: в режиме http-auth есть необязательные списки доступа (ACL_ENABLED). Они ограничивают чаты для каждого токена, а read_only: true запрещает отправку, правку и прямые вызовы MTProto. Прямой MTProto по умолчанию закрыт для перечисленных в списке пользователей, а чувствительные поля в его ответах отбрасываются.

Как снизить риски: запускайте сервер локально, храните сессию у себя, включайте read_only для задач чтения и проверяйте текст перед отправкой. Лицензия — MIT.

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

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

Да. Передайте --bot-api-token при настройке или задайте BOT_API_TOKEN в окружении.

Можно ли запретить ассистенту отправлять сообщения?

В режиме http-auth — да, через список доступа с read_only: true.

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

Инструменты

  • search_messages_globally
  • get_messages
  • send_message
  • edit_message
  • find_chats
  • get_chat_info
  • send_message_to_phone
  • invoke_mtproto

Похожие 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

Источники