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

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

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

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

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

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

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

## Вход через npx

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

## Вход через Claude Desktop

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

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

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

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

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

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

Это полезно при [использовании нескольких аккаунтов](/ru/guides/multiple-accounts).

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

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

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

→ Настройте MCP-клиент: [Claude Desktop](/ru/platforms/claude-desktop) · [Claude Code](/ru/platforms/claude-code) · [Cursor](/ru/platforms/cursor)
