Вход по QR-коду

MCP Telegram использует аутентификацию по QR-коду — номер телефона не нужен.

Вход через бинарник

TELEGRAM_API_ID=YOUR_ID TELEGRAM_API_HASH=YOUR_HASH ./mcp-telegram-login

В терминале появится QR-код:

1. Откройте Telegram на телефоне
2. Перейдите в Настройки → Устройства → Подключить устройство
3. Отсканируйте QR-код

Сессия сохраняется в ~/.mcp-telegram/session и используется автоматически. Вход нужен только один раз.

Вход через npx

TELEGRAM_API_ID=YOUR_ID TELEGRAM_API_HASH=YOUR_HASH npx @overpod/mcp-telegram login

Вход через Claude Desktop

Если вы используете Claude Desktop, терминал не нужен:

1. Добавьте MCP-сервер в конфиг (см. настройка Claude Desktop)
2. Перезапустите Claude Desktop
3. Попросите Claude: «Выполни telegram-login»
4. Будет сгенерировано изображение с QR-кодом
5. Если изображение не видно, оно сохранено в ~/.mcp-telegram/qr-login.png
6. Отсканируйте в Telegram (Настройки → Устройства → Подключить устройство)

Проверка подключения

После входа попросите ассистента выполнить telegram-status — должна вернуться информация о вашем аккаунте.

Пользовательский путь к сессии

TELEGRAM_SESSION_PATH=/path/to/session ./mcp-telegram-login

Это полезно при использовании нескольких аккаунтов.

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

• Файл сессии имеет права 0600 (доступ только владельцу)
• Директория сессии имеет права 0700
• Сессия даёт полный доступ к вашему аккаунту — обращайтесь как с паролем
• Одна сессия на процесс — использование одного файла в нескольких процессах вызывает AUTH_KEY_DUPLICATED

Следующий шаг

→ Настройте MCP-клиент: Claude Desktop · Claude Code · Cursor