chigwell — Telegram MCP·chigwell

chigwell — Telegram MCP — подключение и инструкция

Telegram MCP от chigwell подключает ИИ-клиент к Telegram-аккаунту для чтения чатов и разрешённых действий пользователя.

Рабочие сервисыЛокальноAPI-ключ

Что умеет этот сервер

01

Telegram MCP от chigwell подключает ИИ-клиент к Telegram-аккаунту для чтения чатов и разрешённых действий пользователя.

02

Сервер использует пользовательскую Telegram session, а не Bot API token.

03

Ограничь доступ нужными chat IDs и каталогами файлов.

Задача для знакомства

Через Telegram MCP chigwell в read-only прочитай последние сообщения только указанного чата. Ничего не отправляй и не пересылай.

Уточнить результат

Проверь действующую session и режим read-only. Для длительной работы README рекомендует persistent file session; при проблемах reconnect не создавай бесконечные новые логины.

Как подключить

Выберите подходящий способ

Подключить chigwell — Telegram MCP MCP

Склонируй chigwell/telegram-mcp и выполни uv sync. Создай session через uv run session_string_generator.py --qr либо --phone. В клиенте укажи uv --directory /полный/путь/telegram-mcp run main.py и Telegram env из README. Для первого подключения выбери TELEGRAM_EXPOSED_TOOLS=read-only.

Что понадобится

  • uv, Telegram API_ID/API_HASH и собственная защищённая session. Доступ к аккаунту включает приватные чаты.
  1. 01

    Подготовь окружение

    uv, Telegram API_ID/API_HASH и собственная защищённая session. Доступ к аккаунту включает приватные чаты.

  2. 02

    Установи и настрой

    Склонируй chigwell/telegram-mcp и выполни uv sync. Создай session через uv run session_string_generator.py --qr либо --phone. В клиенте укажи uv --directory /полный/путь/telegram-mcp run main.py и Telegram env из README. Для первого подключения выбери TELEGRAM_EXPOSED_TOOLS=read-only.

  3. 03

    Открой новую сессию

    Убедись, что клиент видит инструменты именно этого сервера, и выполни первый небольшой сценарий.

Первый запрос — пример для чата агента

Через Telegram MCP chigwell в read-only прочитай последние сообщения только указанного чата. Ничего не отправляй и не пересылай.

Как проверить

Проверь действующую session и режим read-only. Для длительной работы README рекомендует persistent file session; при проблемах reconnect не создавай бесконечные новые логины.

Подставь собственные пути, адреса и доступы только в локальные настройки. Команды запуска, MCP-конфигурация и текст первого запроса вводятся в разных местах; их назначение указано над примером.

README и установка автора

Что умеет chigwell — Telegram MCP

Telegram MCP от chigwell подключает ИИ-клиент к Telegram-аккаунту для чтения чатов и разрешённых действий пользователя.

Сервер использует пользовательскую Telegram session, а не Bot API token. PyPI-пакет telegram-mcp принадлежит другому проекту: эта карточка описывает установку из GitHub.

Что подготовить перед подключением

uv, Telegram API_ID/API_HASH и собственная защищённая session. Доступ к аккаунту включает приватные чаты.

Как установить и подключить

Склонируй chigwell/telegram-mcp и выполни uv sync. Создай session через uv run session_string_generator.py --qr либо --phone. В клиенте укажи uv --directory /полный/путь/telegram-mcp run main.py и Telegram env из README. Для первого подключения выбери TELEGRAM_EXPOSED_TOOLS=read-only.

Добавь выбранную запись в существующую конфигурацию клиента, сохранив остальные серверы. Формат и расположение настроек зависят от клиента: JSON-пример для Claude Desktop не нужно целиком вставлять в TOML-файл другого приложения. После изменения перечитай конфигурацию или открой новую сессию.

Как пользоваться: первый сценарий

Ограничь доступ нужными chat IDs и каталогами файлов. Начни с чтения одного разрешённого диалога; для дальнейших действий точно указывай чат и message ID.

Как проверить результат и решить проблемы

Проверь действующую session и режим read-only. Для длительной работы README рекомендует persistent file session; при проблемах reconnect не создавай бесконечные новые логины.

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

Ограничения

Session предоставляет доступ от имени пользователя. Отправка сообщений, реакции, пересылки и файлы — реальные действия, а не черновики.

Исходники и документация

Репозиторий: chigwell/telegram-mcp. В README доступны актуальные варианты установки, требования и примеры настройки. Перед обновлением сохрани рабочую конфигурацию и проверь изменения версии.

Другие подключения — в каталоге MCP-серверов Нейролюба.

Вопросы о chigwell — Telegram MCP

Telegram MCP от chigwell подключает ИИ-клиент к Telegram-аккаунту для чтения чатов и разрешённых действий пользователя.
Вернуться в библиотеку