Telegram MCP для Claude Code: подключение и настройка

MCP: Telegram в Claude Code

Telegram MCP даёт Claude Code доступ к вашему Telegram: читать диалоги, проверять непрочитанные сообщения, готовить черновики ответов и управлять чатами. Claude сможет работать с Telegram по вашей просьбе — например: «Покажи непрочитанные сообщения» или «Подготовь черновик ответа в рабочий чат».

Требуется: Claude Code (macOS
| Windows),
Node.js (установка)

---

1. Получите API ID и API Hash

1. Откройте в браузере: my.telegram.org/auth
2. Введите свой номер телефона (с кодом страны, например

+79001234567) и нажмите Next

1. Telegram пришлёт код в приложение (не SMS!) — введите его на

сайте

1. После входа нажмите API development tools
2. Заполните форму:

App title — любое название (например, Claude MCP)

1. Short name — короткое имя (например,

claudemcp)

1. Platform — выберите Desktop
2. URL и Description — можно оставить

пустым

1. Нажмите Create application. Если вылезает ошибка — выключите VPN и попробуйте снова
2. Скопируйте и сохраните App api_id (число) и

App api_hash (строка из букв и цифр)

Важно: Эти ключи дают полный доступ к вашему
Telegram. Никому их не показывайте и не публикуйте.

---

2. Авторизуйте Telegram MCP

В терминале выполните команду, подставив свои данные:

npx -y @chaindead/telegram-mcp auth --app-id ТВОЙ_APP_ID --api-hash ТВОЙ_API_HASH --phone ТВОЙ_НОМЕР

Пример:

npx -y @chaindead/telegram-mcp auth --app-id 12345678 --api-hash abc123def456 --phone +79001234567

Telegram пришлёт код подтверждения в приложение. Введите его в терминале.

Если у вас 2FA: добавьте флаг
--password с паролем:

npx -y @chaindead/telegram-mcp auth --app-id ТВОЙ_APP_ID --api-hash ТВОЙ_API_HASH --phone ТВОЙ_НОМЕР --password ТВОЙ_2FA_ПАРОЛЬ

---

3. Добавьте Telegram MCP в Claude Code

После успешной авторизации:

claude mcp add telegram -e TG_APP_ID=ТВОЙ_APP_ID -e TG_API_HASH=ТВОЙ_API_HASH -- npx -y @chaindead/telegram-mcp

Пример:

claude mcp add telegram -e TG_APP_ID=12345678 -e TG_API_HASH=abc123def456 -- npx -y @chaindead/telegram-mcp

---

4. Проверьте работу

claude

Спросите:

Покажи мои непрочитанные сообщения в Telegram

Если Claude показывает информацию из Telegram — всё работает!

---

Что можно делать с Telegram MCP

Работа с сообщениями:

Проверь непрочитанные важные сообщения в Telegram

Сделай саммари всех непрочитанных сообщений

Проанализируй непрочитанные и подготовь черновики ответов где нужно

Организация чатов:

Проанализируй мои диалоги и предложи структуру папок

Помоги категоризировать чаты по важности

Найди все рабочие переписки и предложи как их организовать

Коммуникация:

Следи за чатом "Проект" на предмет обновлений по релизу

Подготовь вежливый черновик ответа на последнее сообщение в чате с Машей

Проверь, есть ли неотвеченные вопросы в моих чатах

---

Доступные инструменты

• Инструмент: tg_me; Что делает: Информация о вашем аккаунте
• Инструмент: tg_dialogs; Что делает: Список диалогов (можно фильтровать по непрочитанным)
• Инструмент: tg_dialog; Что делает: Сообщения из конкретного чата
• Инструмент: tg_read; Что делает: Отмечает сообщения как прочитанные
• Инструмент: tg_send; Что делает: Создаёт черновик сообщения в чате

---

Проверка установки

claude mcp list

В списке должен быть telegram.

---

Частые проблемы

«claude: command not found»

Claude Code не установлен. Пройдите гайд по установке (macOS | Windows).

«npx is not recognized»

Node.js не установлен. Установите по гайду, перезапустите терминал.

Telegram не присылает код

• Код приходит в приложение Telegram, а не по

SMS

• Проверьте, что номер введён с кодом страны

(+79001234567)

• Попробуйте ещё раз через пару минут

Ошибка авторизации или «Invalid API credentials»

• Проверьте, что App ID и API Hash скопированы правильно, без

пробелов

• App ID — число, API Hash — строка из букв и цифр
• Убедитесь, что приложение создано на my.telegram.org/apps

MCP добавился, но Claude не видит Telegram

• Перезапустите Claude Code
• Уточните запрос: явно упомяните «в Telegram»
• Проверьте, что авторизация прошла успешно (шаг 2)

«Session expired»

Повторите авторизацию с флагом --new:

npx -y @chaindead/telegram-mcp auth --app-id ТВОЙ_APP_ID --api-hash ТВОЙ_API_HASH --phone ТВОЙ_НОМЕР --new

ERROR при создании приложения на my.telegram.org

Выключите VPN и попробуйте снова.

---

Безопасность

• API ключи дают полный доступ к аккаунту Telegram —

не публикуйте их

• Сессия хранится локально. Завершить можно в

Telegram: Настройки → Устройства

---

Готово!

Теперь в Claude Code доступны:

• Чтение сообщений — диалоги и непрочитанные
• Черновики ответов — Claude подготовит, вы

отправите

• Организация — анализ чатов, категоризация, отметка

прочитанным

Официальный репозиторий: chaindead/telegram-mcp