# Better-TG-CLI (Telegram)

MCP-сервер Better-TG-CLI (Telegram) для Claude Code читает и ищет сообщения, отправляет текст и нажимает кнопки ботов. Каждая запись требует подтверждения.

- MCP-сервер · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 11 у репозитория
- Автор: TheVilfer
- Лицензия: MIT · policy=link-only · показываем только описание, файл — у автора
- Исходник: https://github.com/TheVilfer/better-tg-cli
- Обновлён: 2026-11-15
- Проверка безопасности: автоматическая, 2026-11-17 (текст) — признаков вредоносного кода не нашли.
- HTML: https://affpapa.org/nevibecode/mcp/better-tg-cli-telegram

## Что делает

Better-TG-CLI подключает агента к собственному аккаунту Telegram через CLI и MCP-сервер `telegram mcp`. Он читает чаты, ищет сообщения, работает с ботами и нажимает их кнопки. Отправка, редактирование и удаление сообщений требуют подтверждения с точным текстом операции.

Сервер также поставляется как CLI с командой `telegram`; вывод рассчитан на работу агентов, а записи попадают в `~/.config/tg/audit.jsonl`. Это неофициальный клиент, поэтому Telegram может ограничить или заморозить аккаунт, особенно при массовых сообщениях, вступлениях и приглашениях. Для установки через npm нужен Node 20+; вместо него можно использовать standalone binary.

## Требования
- Нужно: Node.js (команды через npx)
- Переменные окружения: `TG_PROFILE` — это ключи и токены: значения спроси у человека, в репозиторий и общие файлы не записывай.

## Установка

### Claude Code (родная платформа)

**Командой платформы**
```bash
claude mcp add --env TG_PROFILE=<TG_PROFILE> --transport stdio better-tg-cli-telegram -- npx -y better-tg-cli
```
Вместо <…> подставьте свои значения

### Codex

**Командой платформы**
```bash
codex mcp add better-tg-cli-telegram --env TG_PROFILE=<TG_PROFILE> -- npx -y better-tg-cli
```
Вместо <…> подставьте свои значения

### Cursor

**Файл настроек**
Файл `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "better-tg-cli-telegram": {
            "command": "npx",
            "args": [
                "-y",
                "better-tg-cli"
            ],
            "env": {
                "TG_PROFILE": "<TG_PROFILE>"
            }
        }
    }
}
```
Вместо <…> подставьте свои значения

### GitHub Copilot

**Файл настроек**
Файл `.vscode/mcp.json`:
```json
{
    "servers": {
        "better-tg-cli-telegram": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "better-tg-cli"
            ],
            "env": {
                "TG_PROFILE": "<TG_PROFILE>"
            }
        }
    }
}
```
Вместо <…> подставьте свои значения

### Gemini CLI

**Командой платформы**
```bash
gemini mcp add -e TG_PROFILE=<TG_PROFILE> better-tg-cli-telegram npx -y better-tg-cli
```
Вместо <…> подставьте свои значения

## Когда брать
- читать переписки в Telegram через агента
- искать сообщения по чату и фильтрам
- отправлять сообщения после подтверждения текста
- нажимать кнопки Telegram-ботов

## Примеры запросов агенту
- Прочитай последние сообщения из чата с `@alice` и кратко перескажи их.
- Найди в Telegram сообщения про релиз `v2.4` за нужный период.
- Отправь этот текст в чат после показа точного содержимого и дождись моего подтверждения.

## Похожие
- [telegram](https://affpapa.org/nevibecode/skills/telegram.md) — скилл · 486 установок
- [add-telegram](https://affpapa.org/nevibecode/skills/add-telegram.md) — скилл · ★ 31137 у репозитория
- [tg-ws-proxy-telegram-socks5](https://affpapa.org/nevibecode/skills/tg-ws-proxy-telegram-socks5.md) — скилл · 889 установок
- [Chatroost — unofficial Telegram MCP server](https://affpapa.org/nevibecode/mcp/chatroost-unofficial-telegram-mcp-server.md) — MCP-сервер · ★ 72 у репозитория

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md
