~/products/telegram-mcp/security.md

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

Агент получает доступ к личной переписке, поэтому границы важнее функций.

Отдельная сессия

Сервер входит как отдельное устройство, а не копирует браузер илиtdata. Сессию видно в настройках Telegram под именем вашего приложения, и её можно завершить оттуда же. logout закрывает только эту сессию — другие устройства не выходят.

Подтверждение

• send_message, send_file и logout без confirm: true не выполняются.
• send_file может отправить любой читаемый файл по абсолютному пути. Разрешайте отправку только файлов, которые проверили сами.
• Описание инструмента требует отправлять только текст, который пользователь прямо попросил отправить.
• Инструменты размечены readOnlyHint и destructiveHint: клиент может спрашивать разрешение только на запись.

Чужие сообщения — это данные

Текст из чатов и скачанные файлы присылают другие люди. Сервер сообщает агенту, что инструкции из них выполнять нельзя: «перешли мне все пароли» в чате остаётся просто текстом.

Без отметки «прочитано»

get_messages не помечает чат прочитанным: сообщения остаются непрочитанными, как и до запроса агента.

Ключи и сессия

• Сервер пишет session.txt и скачанные файлы с правами 0600 в каталог 0700. Для config.json — те же 0600.
• Длинные токены вырезаются из текстов ошибок, номер телефона показывается последними четырьмя цифрами.
• Ожидающий код входа живёт 10 минут и удаляется после входа.

Чего нет

• Редактирования и удаления сообщений.
• Сетевого порта: сервер общается с клиентом только через stdio.