Telegram MCP — Telegram в инструментах агента
Korra Hub: https://korra-agent.online/library/telegram-mcp/
Сверено: 29.09.2026

Подключает Telegram через MCP: поиск сообщений, чтение выбранных чатов и работа с перепиской.

ЗАДАНИЕ ДЛЯ АГЕНТА
Помоги настроить и использовать Telegram MCP для задачи ниже.

Официальные источники — начни с них:
- Репозиторий проекта: https://github.com/chigwell/telegram-mcp
- README: установка и использование: https://github.com/chigwell/telegram-mcp/blob/main/README.md
- Telegram API приложения: https://my.telegram.org/apps

Сначала прочитай инструкции по указанным ссылкам, определи мою систему и доступную тебе среду выполнения. Если инструмент уже установлен и подходит для задачи, используй его. Если источник недоступен, сообщи об этом. Если понадобится ключ или вход в аккаунт, не проси присылать его в чат: подскажи, куда его сохранить.

Установка и проверка:
Клонируй строго chigwell/telegram-mcp и установи через uv sync по README. Не используй pip install telegram-mcp или uvx telegram-mcp: это другой проект. До нового входа проверь существующее подключение. Секреты и сессию храни локально. Для первого теста задай TELEGRAM_EXPOSED_TOOLS=read-only, ограничь выбранные чаты и выключи автоматическую транскрибацию. Проверь список доступных инструментов MCP.

Команды подключения для разных агентов — выбери свой:
Claude Code:
   git clone --depth 1 https://github.com/chigwell/telegram-mcp.git ~/telegram-mcp
   cd ~/telegram-mcp && uv sync && cp .env.example .env
   claude mcp add --scope user telegram -- uv --directory ~/telegram-mcp run main.py
Codex:
   git clone --depth 1 https://github.com/chigwell/telegram-mcp.git ~/telegram-mcp
   cd ~/telegram-mcp && uv sync && cp .env.example .env
   codex mcp add telegram -- uv --directory ~/telegram-mcp run main.py
Cursor:
   {
     "mcpServers": {
       "telegram": {
         "command": "uv",
         "args": [
           "--directory",
           "/полный/путь/telegram-mcp",
           "run",
           "main.py"
         ]
       }
     }
   }
Hermes:
   git clone --depth 1 https://github.com/chigwell/telegram-mcp.git ~/telegram-mcp
   cd ~/telegram-mcp && uv sync && cp .env.example .env
   hermes mcp add telegram --command uv --args --directory ~/telegram-mcp run main.py
OpenClaw:
   git clone --depth 1 https://github.com/chigwell/telegram-mcp.git ~/telegram-mcp
   cd ~/telegram-mcp && uv sync && cp .env.example .env
   openclaw mcp add telegram --command uv --arg --directory --arg ~/telegram-mcp --arg run --arg main.py
Korra:
   git clone --depth 1 https://github.com/chigwell/telegram-mcp.git ~/telegram-mcp
   cd ~/telegram-mcp && uv sync && cp .env.example .env
   korra mcp add telegram --command uv --args --directory ~/telegram-mcp run main.py
Если ты другой агент, подключи тем способом, который принят у тебя.

Моя задача:
Помоги прочитать последние сообщения одного выбранного мной чата и выписать задачи с авторами и ссылками. Ничего не отправляй, не удаляй и не помечай прочитанным специально. Если для доступа нужен вход, проведи меня через него без передачи кодов и сессии в чат.

В конце сообщи, что настроено, какую версию использовал, что проверил и где находится результат. Если запуск не удался, покажи конкретную ошибку.

КОМАНДЫ ПО АГЕНТАМ
--- Claude Code (по документации агента)
Переменные TELEGRAM_API_ID, TELEGRAM_API_HASH, TELEGRAM_SESSION_STRING — в файле .env в папке проекта. Строку сессии даёт uv run session_string_generator.py --qr: вход по QR-коду, который вы сканируете в Telegram. Код из SMS в чат не отправляйте.
git clone --depth 1 https://github.com/chigwell/telegram-mcp.git ~/telegram-mcp
cd ~/telegram-mcp && uv sync && cp .env.example .env
claude mcp add --scope user telegram -- uv --directory ~/telegram-mcp run main.py
Проверить: claude mcp get telegram
Откатить: claude mcp remove telegram -s user

--- Codex (по документации агента)
Переменные TELEGRAM_API_ID, TELEGRAM_API_HASH, TELEGRAM_SESSION_STRING — в файле .env в папке проекта. Строку сессии даёт uv run session_string_generator.py --qr: вход по QR-коду, который вы сканируете в Telegram. Код из SMS в чат не отправляйте.
git clone --depth 1 https://github.com/chigwell/telegram-mcp.git ~/telegram-mcp
cd ~/telegram-mcp && uv sync && cp .env.example .env
codex mcp add telegram -- uv --directory ~/telegram-mcp run main.py
Проверить: codex mcp get telegram
Откатить: codex mcp remove telegram

--- Cursor (по документации агента)
Скачайте проект и добавьте сервер в ~/.cursor/mcp.json — путь к папке полный. Переменные TELEGRAM_API_ID, TELEGRAM_API_HASH, TELEGRAM_SESSION_STRING — в файле .env в папке проекта. Строку сессии даёт uv run session_string_generator.py --qr: вход по QR-коду, который вы сканируете в Telegram. Код из SMS в чат не отправляйте.
{
  "mcpServers": {
    "telegram": {
      "command": "uv",
      "args": [
        "--directory",
        "/полный/путь/telegram-mcp",
        "run",
        "main.py"
      ]
    }
  }
}
Проверить: Customize → MCP
Откатить: удалите запись telegram из mcp.json

--- Hermes (по документации агента)
Попросите агента: он выполнит команды сам; на вопрос о выборе инструментов — Enter. Потом отправьте в чат /reload-mcp. Переменные TELEGRAM_API_ID, TELEGRAM_API_HASH, TELEGRAM_SESSION_STRING — в файле .env в папке проекта. Строку сессии даёт uv run session_string_generator.py --qr: вход по QR-коду, который вы сканируете в Telegram. Код из SMS в чат не отправляйте.
git clone --depth 1 https://github.com/chigwell/telegram-mcp.git ~/telegram-mcp
cd ~/telegram-mcp && uv sync && cp .env.example .env
hermes mcp add telegram --command uv --args --directory ~/telegram-mcp run main.py
Проверить: hermes mcp test telegram
Откатить: hermes mcp remove telegram

--- OpenClaw (по документации агента)
Переменные TELEGRAM_API_ID, TELEGRAM_API_HASH, TELEGRAM_SESSION_STRING — в файле .env в папке проекта. Строку сессии даёт uv run session_string_generator.py --qr: вход по QR-коду, который вы сканируете в Telegram. Код из SMS в чат не отправляйте.
git clone --depth 1 https://github.com/chigwell/telegram-mcp.git ~/telegram-mcp
cd ~/telegram-mcp && uv sync && cp .env.example .env
openclaw mcp add telegram --command uv --arg --directory --arg ~/telegram-mcp --arg run --arg main.py
Проверить: openclaw mcp probe telegram
Откатить: openclaw mcp unset telegram

--- Korra (по документации агента)
Попросите агента: он скачает проект в свою среду и подключит сервер сам (uv и Node в Korra есть). Потом отправьте в чат /reload-mcp. Можно и через кабинет: «MCP → Добавить сервер» → команда и аргументы из блока. Переменные TELEGRAM_API_ID, TELEGRAM_API_HASH, TELEGRAM_SESSION_STRING — в файле .env в папке проекта. Строку сессии даёт uv run session_string_generator.py --qr: вход по QR-коду, который вы сканируете в Telegram. Код из SMS в чат не отправляйте.
git clone --depth 1 https://github.com/chigwell/telegram-mcp.git ~/telegram-mcp
cd ~/telegram-mcp && uv sync && cp .env.example .env
korra mcp add telegram --command uv --args --directory ~/telegram-mcp run main.py
Проверить: korra mcp test telegram
Откатить: korra mcp remove telegram

ЧТО УЧЕСТЬ
По умолчанию сервер открывает все инструменты, включая отправку и удаление сообщений, — для начала задайте TELEGRAM_EXPOSED_TOOLS=read-only. Ставьте именно chigwell/telegram-mcp: одноимённый пакет в PyPI принадлежит другому проекту.

ИСТОЧНИКИ
- Репозиторий проекта: https://github.com/chigwell/telegram-mcp
- README: установка и использование: https://github.com/chigwell/telegram-mcp/blob/main/README.md
- Telegram API приложения: https://my.telegram.org/apps

Ключи и пароли не присылай в чат и не выводи: попроси человека сохранить их и проверь только наличие.