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`.
Настройка клиентов
{
"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.
{
"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.
PraisonAI
Фреймворк агентов PraisonAI с саморефлексией и поддержкой MCP.
mcp-atlassian
Поиск, чтение, создание и управление контентом Confluence и Jira, включая Server и Data Center.
Jitsu
Управление пайплайнами данных Jitsu: направления, потоки, подключения и функции.