Telegram·KornArs

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

MCP Telegram подключает агента к Telegram-боту: получение доступных сообщений и отправка ответов через Bot API.

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

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

01

MCP Telegram подключает агента к Telegram-боту: получение доступных сообщений и отправка ответов через Bot API.

02

Вариант KornArs основан на mcp-telegram с python-telegram-bot.

03

Добавь бота в тестовый чат и отправь ему сообщение.

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

Через Telegram MCP покажи данные тестового бота и доступные сообщения. Ничего никому не отправляй без указания конкретного чата.

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

Сверь bot identity, chat ID и фактически полученное сообщение. Отсутствие истории может быть ограничением Bot API или прав, а не ошибкой MCP. При отправке проверь сам чат.

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

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

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

Установи CLI командой uv tool install mcp-telegram. В клиенте задай command mcp-telegram, args [start] и BOT_TOKEN в локальном env. Если GUI-клиент не видит бинарник, укажи полный путь, найденный which или where.

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

  • uv, MCP-клиент и токен отдельного Telegram-бота. Доступные чаты и сообщения зависят от добавления бота, прав и настроек Telegram.
  1. 01

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

    uv, MCP-клиент и токен отдельного Telegram-бота. Доступные чаты и сообщения зависят от добавления бота, прав и настроек Telegram.

  2. 02

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

    Установи CLI командой uv tool install mcp-telegram. В клиенте задай command mcp-telegram, args [start] и BOT_TOKEN в локальном env. Если GUI-клиент не видит бинарник, укажи полный путь, найденный which или where.

  3. 03

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

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

Команда подключения из документации

uv tool install mcp-telegram

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

Через Telegram MCP покажи данные тестового бота и доступные сообщения. Ничего никому не отправляй без указания конкретного чата.

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

Сверь bot identity, chat ID и фактически полученное сообщение. Отсутствие истории может быть ограничением Bot API или прав, а не ошибкой MCP. При отправке проверь сам чат.

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

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

Что умеет Telegram

MCP Telegram подключает агента к Telegram-боту: получение доступных сообщений и отправка ответов через Bot API.

Вариант KornArs основан на mcp-telegram с python-telegram-bot. Это бот-соединение по BOT_TOKEN, не вход в личный Telegram-аккаунт и не доступ ко всей переписке пользователя.

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

uv, MCP-клиент и токен отдельного Telegram-бота. Доступные чаты и сообщения зависят от добавления бота, прав и настроек Telegram.

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

Установи CLI командой uv tool install mcp-telegram. В клиенте задай command mcp-telegram, args [start] и BOT_TOKEN в локальном env. Если GUI-клиент не видит бинарник, укажи полный путь, найденный which или where.

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

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

Добавь бота в тестовый чат и отправь ему сообщение. Попроси агента прочитать доступные данные; отправку ответа сначала проверь в этом тестовом чате с известным получателем.

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

Сверь bot identity, chat ID и фактически полученное сообщение. Отсутствие истории может быть ограничением Bot API или прав, а не ошибкой MCP. При отправке проверь сам чат.

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

Ограничения

Токен бота не даёт историю всех личных чатов. Нельзя путать этот вариант с Telegram MCP на пользовательской сессии MTProto; у них разные настройки и область доступа.

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

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

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

Вопросы о Telegram

MCP Telegram подключает агента к Telegram-боту: получение доступных сообщений и отправка ответов через Bot API.
Вернуться в библиотеку