Telegram + AI: пошаговая настройка

Зачем подключать Telegram к AI?

Если у вас десятки чатов в Telegram, вы знаете это чувство: открываешь приложение — а там 100+ непрочитанных сообщений. Что-то важное, что-то можно пропустить, но разбираться некогда.

AI-ассистент, подключённый к Telegram, решает эту проблему:

• Утренний дайджест — краткое резюме всех непрочитанных: что срочно, что можно отложить
• Поиск по переписке — найти «тот разговор о проекте X» без ручного скролла
• Анализ обсуждений — резюмировать длинные треды, выделить ключевые решения
• Черновики ответов — AI готовит ответ, вы проверяете и отправляете

Как это работает: поток данных

Прежде чем настраивать, важно понимать, что происходит с вашими данными:

1. telegram-mcp работает локально на вашем компьютере и получает сообщения напрямую от серверов Telegram
2. Ваш токен авторизации (session string) никуда не отправляется — он хранится только на вашем устройстве
3. Когда вы просите Claude обработать сообщения (резюме, поиск, черновик), текст сообщений отправляется в Anthropic API для обработки — так же, как если бы вы скопировали и вставили их в Claude вручную

Claude vs ChatGPT: важное различие

Прежде чем настраивать, нужно понять принципиальную разницу между платформами:

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

1. Claude Code — CLI-инструмент от Anthropic (claude.ai/code)
2. Python 3 — обычно уже установлен на Mac. Проверьте командой python3 --version в Терминале
3. Telegram аккаунт — с доступом к my.telegram.org

Если у вас уже установлен Docker — его тоже можно использовать, но Python проще и легче. Docker не обязателен.

Шаг 1: Получение API-ключей Telegram (~5 мин)

Telegram требует регистрации приложения для доступа к API — как пропуск в здание. Это бесплатно и занимает пару минут.

1. Откройте my.telegram.org
2. Введите номер телефона (с кодом страны: +7...)
3. Введите код подтверждения (придёт в Telegram на все устройства)
4. Перейдите в «API development tools»
5. Если у вас ещё нет приложения — создайте:
   • App title: любое (например, «Claude Integration»)
   • Short name: уникальное, латиницей, 5-32 символа (например, «ivan_claude»). Если имя занято — добавьте цифры.
   • Platform: Desktop
6. Запишите api_id (число) и api_hash (строка из 32 символов)

Проверка: У вас должны быть два значения — числовой API ID и 32-символьный API Hash.

Шаг 2: Генерация Session String (~3-5 мин)

Session string — это зашифрованный токен вашей сессии Telegram. Он позволяет приложению действовать от вашего имени без повторного ввода кода при каждом запуске.

Откройте Терминал (на Mac: Cmd+Space, наберите «Terminal», Enter) и выполните:

Способ A: Python (самый лёгкий)

# Установите библиотеку Telegram
pip3 install telethon

# Запустите генератор (нужно будет ввести данные)
python3 -c "
from telethon.sync import TelegramClient
from telethon.sessions import StringSession

api_id = int(input('Enter API ID: '))
api_hash = input('Enter API Hash: ')

with TelegramClient(StringSession(), api_id, api_hash) as client:
    print('\n=== YOUR SESSION STRING ===')
    print(client.session.save())
    print('=== END SESSION STRING ===')
"

Способ B: Docker (если установлен)

docker run -it --rm bayramannakov/telegram-mcp:latest python setup_wizard.py

Программа запросит:

1. API ID — число из шага 1
2. API Hash — строка из шага 1
3. Номер телефона — с кодом страны (+7...)
4. Код подтверждения — придёт в Telegram (проверьте все устройства)
5. Пароль 2FA — если включён

Проверка: Результат — строка из 300-400 символов (буквы, цифры, +, /, =). Если строка короче 100 символов — что-то пошло не так. Скопируйте её аккуратно, без лишних пробелов.

Шаг 3: Безопасное хранение ключей (~1 мин)

На macOS используем Keychain — встроенное защищённое хранилище Apple. Команда security — это его интерфейс в Терминале.

# Сохраните API ID (флаг -U обновит, если запись уже есть)
security add-generic-password -a "api_id" -s "telegram-mcp" -w "ВАШ_API_ID" -U

# Сохраните API Hash
security add-generic-password -a "api_hash" -s "telegram-mcp" -w "ВАШ_API_HASH" -U

# Сохраните Session String (одинарные кавычки — для спецсимволов)
security add-generic-password -a "session_string" -s "telegram-mcp" -w 'ВАША_SESSION_STRING' -U

Проверка:

security find-generic-password -a "api_id" -s "telegram-mcp" -w

Должен вывести ваш API ID. Если видите ошибку — повторите команду сохранения.

Шаг 4: Регистрация MCP-сервера (~2 мин)

MCP (Model Context Protocol) — это «плагины» для Claude Code. Сейчас мы подключим Telegram как плагин.

Если вы используете скилл /telegram-mcp-setup в Claude Code, он создаст скрипт-обёртку автоматически. Если настраиваете вручную — в Терминале:

# Зарегистрируйте MCP-сервер
claude mcp add telegram-mcp -s user -- ~/.local/bin/telegram-mcp-docker

# Проверьте, что сервер добавлен
claude mcp list

Должны увидеть telegram-mcp в списке серверов.

Перезапустите Claude Code — закройте и откройте заново, чтобы MCP-сервер загрузился.

Шаг 5: Проверка подключения (~1 мин)

Откройте Claude Code и попросите:

Покажи мои последние чаты в Telegram

Если всё настроено правильно — увидите список своих чатов.

Безопасность: что нужно знать

Session string — это больше, чем пароль

Обычный пароль требует 2FA для доступа. Session string обходит 2FA — это уже авторизованный токен. Если он утечёт, злоумышленник может:

• Прочитать все сообщения во всех чатах, группах и каналах
• Отправлять сообщения от вашего имени
• Скачивать файлы, фото, документы
• Получить доступ к списку контактов
• Делать всё это незаметно, без уведомлений

Ограничения текущей версии

telegram-mcp даёт полный доступ к аккаунту. Нет режима «только чтение» и нет фильтрации по чатам. Когда Claude читает ваши сообщения, у него есть доступ ко всем чатам.

Правила безопасной работы

1. Никогда не отправляйте автоматически — всегда используйте режим черновика (save_draft), проверяйте и отправляйте вручную
2. Не делитесь session string — он даёт полный доступ к аккаунту
3. Включите 2FA — дополнительная защита вашего Telegram
4. Проверяйте активные сессии — Telegram → Настройки → Конфиденциальность → Активные сессии
5. Обновляйте session string раз в 90 дней — как гигиена безопасности
6. Попробуйте на тестовом аккаунте — если у вас чувствительные бизнес-чаты, сначала протестируйте на вторичном аккаунте

Полное отключение

Чтобы полностью отключить Telegram от Claude Code:

1. Завершите сессию в Telegram: Настройки → Конфиденциальность → Активные сессии → «Завершить все другие сессии»
2. Удалите ключи из Keychain (три команды security delete-generic-password)
3. Удалите MCP-сервер: claude mcp remove telegram-mcp
4. Удалите скрипт-обёртку: rm ~/.local/bin/telegram-mcp-docker

Решение проблем

«Could not find the input entity»

Неправильный формат ID чата. Для супергрупп добавьте -100 в начало ID. Для каналов используйте username без @.

«Session expired»

Session string истёк. Перегенерируйте через тот же скрипт из Шага 2 и обновите в Keychain.

«Docker daemon not running»

Docker Desktop не запущен. Откройте Docker Desktop и подождите 1-2 минуты. Если не используете Docker — эта ошибка не ваша, проверьте, что MCP зарегистрирован с правильным скриптом.

MCP-сервер не появляется в Claude Code

Удалите и добавьте заново: claude mcp remove telegram-mcp, затем повторите регистрацию. Перезапустите Claude Code.

Эта статья — часть серии материалов для продвинутых пользователей AI. На наших курсах вы научитесь эффективно использовать AI-инструменты для создания продуктов и автоматизации рутины.