MCP-сервер Telegram для Claude Code, Cursor, Codex и Claude Desktop

В Better-TG-CLI есть MCP-сервер telegram mcp: через него ИИ-клиент читает и ищет в вашем собственном аккаунте Telegram, а после вашего подтверждения каждой отправки пишет в него. Сервер работает на вашем компьютере по stdio и общается с Telegram напрямую, через наши серверы ничего не идёт.

1. Установите CLI

brew install thevilfer/tap/better-tg-cli   # macOS or Linux
scoop bucket add thevilfer https://github.com/TheVilfer/scoop-bucket
scoop install better-tg-cli                 # Windows
npm install -g better-tg-cli                # any OS, Node 20+

npm-пакет — это один файл без зависимостей при запуске; Homebrew и Scoop ставят отдельный бинарник, которому не нужен Node.

2. Войдите один раз

telegram onboard      # free login key or your own API keys, then a QR code

Вы сканируете QR-код в Telegram на телефоне. Код входа, пароль 2FA и сессия до агента не доходят. Сессия хранится в «Связке ключей» macOS, Secret Service в Linux, DPAPI в Windows или в 1Password.

3. Добавьте его в клиент

claude mcp add telegram -- telegram mcp                     # Claude Code
codex plugin marketplace add TheVilfer/better-tg-cli         # Codex (skill and server)
codex plugin add better-tg-cli@better-tg-cli
gemini extensions install https://github.com/TheVilfer/better-tg-cli   # Gemini CLI

Для Claude Desktop скачайте better-tg-cli.mcpb из последнего релиза и откройте его: Node, npm и Homebrew не нужны.

Для Cursor (.cursor/mcp.json), Claude Desktop (claude_desktop_config.json) и других MCP-клиентов используйте JSON с полным путём из which telegram: графические приложения могут не видеть PATH вашей оболочки.

Настройка в JSON

{
  "mcpServers": {
    "telegram": { "command": "/opt/homebrew/bin/telegram", "args": ["mcp"] }
  }
}

# без глобальной установки:
{
  "mcpServers": {
    "telegram": { "command": "npx", "args": ["-y", "better-tg-cli@latest", "mcp"] }
  }
}

Сервер есть в официальном MCP Registry под именем io.github.TheVilfer/better-tg-cli.

Что даёт сервер

telegram_read: команды только для чтения (входящие, чтение, поиск, треды, темы форумов, комментарии в каналах, контакты), поэтому клиенты могут одобрять его автоматически.
telegram_write: отправка, правка, реакции, пересылка, кнопки ботов. Помечен как разрушающий.
telegram_help: справочник с поиском по всем командам и флагам.

Как подтверждается запись

После входа профиль в режиме ask. Перед каждой записью вы видите точное действие, и оно выполняется только после вашего «да». Клиенты с поддержкой MCP elicitation спрашивают вас в собственном окне, так что модель к подтверждению не прикасается; остальные передают одноразовый код, привязанный к этому точному тексту.

telegram write-access off переводит профиль в режим только чтения. Запись без вопросов (telegram write-access on --for 1h) включается только вашим подтверждением в терминале или системном окне. Режимы защищают от ошибок агента; агент, который выполняет команды на вашем компьютере от вашего имени, всё равно может прочитать сессию, поэтому давайте таким агентам только те чаты, которым доверяете. Подробности в SECURITY.md.

Облачные агенты

Облачные агенты вроде Grok Bot не могут запустить программу на вашем компьютере. Запустите telegram mcp --http с bearer-токеном и откройте к нему доступ через туннель; сессия и защита записи остаются на вашей машине. Шаги описаны в README.