# Telegram MCP-сервер и CLI для личного аккаунта (/ru/docs/tg)

Вы видите, кто вас ждет, не листая чаты. `tg` подключает ваш собственный аккаунт Telegram к ИИ-агенту, которым
вы уже пользуетесь, например Claude Code, Codex или Cursor. Он хранит копию чатов на вашем компьютере, поэтому агент
ищет по переписке за годы, даже без интернета.

Агент скажет, в каких чатах ждут ответа, что вы обещали на этой неделе и куда Алиса прислала PDF с договором аренды.
Он отвечает сообщениями, которые нашел, и готовит черновик ответа, который вы отправляете или правите. Настройка
занимает около пяти минут.

**На этой странице:**

1. [Что вы получите](#что-вы-получите)
2. [Что неочевидно с первого раза](#что-неочевидно-с-первого-раза)
3. [Как это выглядит](#как-это-выглядит)
4. [Почему tg](#почему-tg)
5. [Что умеет tg](#что-умеет-tg)
6. [Как это устроено](#как-это-устроено)
7. [Начните за пять минут](#начните-за-пять-минут)
8. [Ограничения](#ограничения)
9. [Найдите инструкцию под свою задачу](#найдите-инструкцию-под-свою-задачу)

## Что вы получите [#что-вы-получите]

- **Ни одного забытого ответа.** Один запрос показывает, кто ждет вашего ответа во всех чатах. Никто не видит, что вы
  заглядывали.
- **Любое сообщение за секунды.** На вопрос "Когда мы договорились с Алисой о месте?" агент дает дату и само
  сообщение, без интернета. Поиск находит слово в любой форме, а обсуждение целиком по смыслу.
- **Обещания под контролем.** "Что я обещал на этой неделе и чего жду от других?" дает один ответ по всем чатам.
- **Голосовые как текст.** Голосовые превращаются в текст на вашем компьютере, без Telegram Premium. Текст в файлах и
  сканах тоже ищется.
- **Спокойные группы.** Ссылки, флуд и нежелательных людей обрабатывают ваши правила. Видно вопросы без ответа, кто
  вступил и кто вышел.
- **Ответы, пока вас нет.** Автоответы по вашим правилам, и их можно ограничить людьми, которых вы выбрали.
- **Бот в том же инструменте.** Любой бот через официальный Bot API, все 185 методов, рядом с готовыми командами для
  отправки и ответов.

## Что неочевидно с первого раза [#что-неочевидно-с-первого-раза]

- **`personal` - имя, которое вы выбираете сами.** Оно обозначает один аккаунт Telegram, и с него начинается каждая
  команда. Второй аккаунт можно добавить позже, например как `work`. Ни одна команда не выбирает аккаунт за вас.
- **Чтение ничего не отмечает прочитанным.** Только `tg personal chats mark-read` показывает собеседнику, что вы
  прочитали.
- **Ничего не отправляется без команды.** Отправка, правка и удаление - отдельные команды, а профиль можно сделать
  только для чтения.
- **Копия пополняется, пока вы читаете.** Чата, который вы еще не открывали и не скачивали, в ней нет. Поэтому пустой
  результат поиска без интернета не доказывает, что сообщения не было. `tg` знает, какие отрезки каждого чата у него
  есть целиком, и говорит об этом.

## Как это выглядит [#как-это-выглядит]

```text
Вы:     Что я кому обещал за последние три дня?
Агент:  (запускает tg personal review 'date>3d': 12 чатов)
        Вы должны
        · Алиса Пример: счет до пятницы. Чат "Алиса Пример", 24.09
        Ждете от других
        · Борис Образец: макет до 25.09. В чате "Дизайн" его пока нет
Вы:     Напомни Борису про макет.
Агент:  Черновик: "Борис, привет, как там макет?" Отправить?
Вы:     Да.
```

## Почему tg [#почему-tg]

- **Никакого сервера WireCat.** `tg` общается только с Telegram, с вашего компьютера. Аккаунт у нас не нужен.
- **Входит как Telegram для компьютера.** Он работает через официальный API Telegram с вашей собственной регистрацией
  приложения и становится еще одним устройством аккаунта.
- **Поиск, которого не описывают другие.** Из пяти открытых инструментов для Telegram в [сравнении](/llms.mdx/docs/ru/tg/compare/content.md) ни
  один не описывает поиск сообщения по смыслу, поиск внутри полученных файлов или список того, что вы должны людям и
  что они должны вам. `tg` умеет все это.
- **Границы для агента задаете вы.** Только чтение, запись только в чаты из вашего списка и не больше 30 отправок в
  час по умолчанию. Перед отправкой `tg` может спросить вас в терминале.
- **Вход хранится в связке ключей системы.** Ни один другой инструмент в сравнении его там не хранит.
- **Бесплатно и с открытым кодом.** Лицензия Apache 2.0, работает на macOS, Linux и Windows.

Другой инструмент подойдет лучше, если вы в основном перекладываете файлы пачками ([tdl](https://github.com/iyear/tdl))
или хотите больше всего готовых действий в Claude Desktop без локальной копии
([telegram-mcp](https://github.com/chigwell/telegram-mcp)).

## Что умеет tg [#что-умеет-tg]

- **Разобрать новое:** непрочитанное от других людей во всех чатах, обзор того, что изменилось с прошлого раза,
  вопросы без ответа. [Повседневные команды](/llms.mdx/docs/ru/tg/usage/content.md)
- **Найти:** по человеку, чату, дате, файлу, ссылке и тегу, по смыслу и сразу на сервере Telegram.
  [Поиск](/llms.mdx/docs/ru/tg/search/content.md)
- **Ответить:** отправить, ответить, переслать, изменить, закрепить, поставить реакцию, опрос, файл и голосовое.
  Отложить сообщение на потом. [Повседневные команды](/llms.mdx/docs/ru/tg/usage/content.md)
- **Вести группу:** участники, заявки на вступление, темы, правила модерации, итог недели. [Ваши группы](/llms.mdx/docs/ru/tg/groups/content.md)
- **Сохранить историю:** один раз скачать всю историю чата, выгрузить ее в Markdown или JSONL.
  [Архив сообщений](/llms.mdx/docs/ru/tg/archive/content.md)
- **Один человек в разных мессенджерах:** свяжите аккаунты человека в Telegram и MAX и ищите сразу по сообщениям,
  почте и заметкам на этом компьютере. [Люди](/llms.mdx/docs/ru/tg/people/content.md)
- **Агенты где угодно:** навык для агентов в терминале, MCP-сервер с готовыми запросами для Claude Desktop и Cursor и
  защищенная ссылка для ChatGPT и Claude в браузере. [Агенты](/llms.mdx/docs/ru/agents/content.md)

## Как это устроено [#как-это-устроено]

- **Копия на вашем компьютере.** Сообщения, которые `tg` прочитал или скачал, лежат в локальном архиве. Поиск,
  выгрузка и чтение без подключения отвечают из него, а поиск может спросить и сервер Telegram.
  [Архив сообщений](/llms.mdx/docs/ru/tg/archive/content.md)
- **Вход по QR-коду.** Один раз вы регистрируете приложение Telegram, потом сканируете код в Telegram. `tg`
  становится еще одним устройством аккаунта.
- **Для скриптов и агентов.** Одна операция на вызов и один JSON-ответ с `--json`. [MCP](/llms.mdx/docs/ru/tg/mcp/content.md)
- **Что хранится и что уходит в сеть.** [Безопасность](/llms.mdx/docs/ru/tg/security/content.md)

## Начните за пять минут [#начните-за-пять-минут]

Вставьте это в чат с агентом:

```text prompt
Используй tg CLI. Установи его командой npm install -g @wirecat/tg-cli, помоги мне пройти tg personal setup и покажи, кто ждет моего ответа.
```

Или в терминале:

```sh
npm install -g @wirecat/tg-cli
tg personal setup     # регистрация приложения Telegram, вход по QR-коду, навык для агента
tg personal inbox     # непрочитанное от других людей во всех чатах
```

Нужен Node.js 22.19 или новее в ветке 22, либо 24 и новее, либо Bun. `setup` сам откроет
[my.telegram.org](https://my.telegram.org/apps): Telegram просит каждую программу, которая подключается к аккаунту,
зарегистрироваться, и `tg` заполнит форму. [Установка](/llms.mdx/docs/ru/tg/installation/content.md)

## Ограничения [#ограничения]

- Для поиска по смыслу нужна модель, которую вы скачиваете один раз (219 МБ, общая с `max`). Поиск по словам работает
  и без нее.
- Истории звонков, настроек приватности и стикеров в `tg` пока нет. [Планы](/llms.mdx/docs/ru/tg/roadmap/content.md)

## Найдите инструкцию под свою задачу [#найдите-инструкцию-под-свою-задачу]

| Задача | Куда перейти |
|---|---|
| Установить, войти, добавить второй аккаунт | [Установка](/llms.mdx/docs/ru/tg/installation/content.md), [Вход и профили](/llms.mdx/docs/ru/tg/sessions/content.md) |
| Читать, искать и отправлять сообщения | [Повседневные команды](/llms.mdx/docs/ru/tg/usage/content.md) |
| Составить точный поисковый запрос | [Поиск сообщений](/llms.mdx/docs/ru/tg/search/content.md) |
| Вести группу | [Ваши группы](/llms.mdx/docs/ru/tg/groups/content.md) |
| Готовый запрос для агента | [Сценарии](/llms.mdx/docs/ru/tg/recipes/content.md) |
| Решить, что можно агенту | [Права](/llms.mdx/docs/ru/tg/permissions/content.md) |
| Бот | [Боты](/llms.mdx/docs/ru/tg/bot/content.md) |
| Точная команда или параметр | [Справочник команд](/llms.mdx/docs/ru/tg/commands/content.md) |
| Что-то не работает | [Решение проблем](/llms.mdx/docs/ru/tg/troubleshooting/content.md) |
| Чем tg отличается от других инструментов для Telegram | [Сравнение](/llms.mdx/docs/ru/tg/compare/content.md) |
