# telegram-notify-mcp

Отправляет текстовые оповещения и файлы в Telegram прямо от ИИ-агента. Пригодится, когда нужно запустить долгую сборку и отойти от компьютера.

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

## Что делает

Сервер предоставляет агенту три инструмента: `send_message`, `send_photo` и `send_document`. Через них ассистент пересылает скриншоты интерфейса и отчёты о сборке. Лишней логики здесь нет.

Инструмент работает поверх Telegram Bot API. При первом вызове сервер ищет ваш логин через метод `getUpdates` и кэширует числовой ID чата на всё время сессии. Без предварительного сообщения `/start` боту отправка сообщений завершится ошибкой: Telegram запрещает ботам писать пользователям первыми.

Для запуска потребуются токен бота от `@BotFather` и логин в переменной `TELEGRAM_USERNAME`. Пути к файлам можно передавать локальными адресами на диске или прямыми ссылками.

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

## Установка

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

**Командой платформы**
```bash
claude mcp add telegram-notify-mcp -e TELEGRAM_BOT_TOKEN=<TELEGRAM_BOT_TOKEN> -- npx -y @parthj/telegram-notify-mcp
```
Вместо <…> подставьте свои значения

### Codex

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

### Cursor

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

### GitHub Copilot

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

### Gemini CLI

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

## Когда брать
- получать уведомления о завершении долгих задач агента в личный чат
- пересылать скриншоты графиков из терминала прямо на телефон
- отправлять сформированные логи и файлы сборки без ручной выгрузки

## Примеры запросов агенту
- Запусти тесты и отправь мне отчёт в Telegram, когда закончишь.
- Сделай скриншот главной страницы и пришли картинку в Telegram.
- Отправь файл `build.log` документом в мой Telegram.

## Похожие
- [claude-ops-telegram-server](https://affpapa.org/nevibecode/mcp/claude-ops-telegram-server.md) — MCP-сервер · ★ 547
- [Notify MCP Server](https://affpapa.org/nevibecode/mcp/notify-mcp-server.md) — MCP-сервер · ★ 29
- [TONNode — TON blockchain access](https://affpapa.org/nevibecode/mcp/tonnode-ton-blockchain-access.md) — MCP-сервер · ★ 27
- [telegram-mcp](https://affpapa.org/nevibecode/mcp/telegram-mcp.md) — MCP-сервер · ★ 7

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