telegram-notify-mcp — MCP-сервер для Claude Code: обзор
Отправляет текстовые оповещения и файлы в Telegram прямо от ИИ-агента. Пригодится, когда нужно запустить долгую сборку и отойти от компьютера.
claude mcp add telegram-notify-mcp -e TELEGRAM_BOT_TOKEN=<TELEGRAM_BOT_TOKEN> -- npx -y @parthj/telegram-notify-mcpЧто делает telegram-notify-mcp
Сервер предоставляет агенту три инструмента: send_message, send_photo и send_document. Через них ассистент пересылает скриншоты интерфейса и отчёты о сборке. Лишней логики здесь нет.
Инструмент работает поверх Telegram Bot API. При первом вызове сервер ищет ваш логин через метод getUpdates и кэширует числовой ID чата на всё время сессии. Без предварительного сообщения /start боту отправка сообщений завершится ошибкой: Telegram запрещает ботам писать пользователям первыми.
Для запуска потребуются токен бота от @BotFather и логин в переменной TELEGRAM_USERNAME. Пути к файлам можно передавать локальными адресами на диске или прямыми ссылками.
Какие задачи решает
- получать уведомления о завершении долгих задач агента в личный чат
- пересылать скриншоты графиков из терминала прямо на телефон
- отправлять сформированные логи и файлы сборки без ручной выгрузки
Примеры запросов агенту
- Запусти тесты и отправь мне отчёт в Telegram, когда закончишь.
- Сделай скриншот главной страницы и пришли картинку в Telegram.
- Отправь файл
build.logдокументом в мой Telegram.
Как установить telegram-notify-mcp
Командой платформы
claude mcp add telegram-notify-mcp -e TELEGRAM_BOT_TOKEN=<TELEGRAM_BOT_TOKEN> -- npx -y @parthj/telegram-notify-mcpВместо <…> подставьте свои значения
Командой платформы
codex mcp add telegram-notify-mcp --env TELEGRAM_BOT_TOKEN=<TELEGRAM_BOT_TOKEN> -- npx -y @parthj/telegram-notify-mcpВместо <…> подставьте свои значения
Файл настроек
{
"mcpServers": {
"telegram-notify-mcp": {
"command": "npx",
"args": [
"-y",
"@parthj/telegram-notify-mcp"
],
"env": {
"TELEGRAM_BOT_TOKEN": "<TELEGRAM_BOT_TOKEN>"
}
}
}
}Вместо <…> подставьте свои значения
Файл настроек
{
"servers": {
"telegram-notify-mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@parthj/telegram-notify-mcp"
],
"env": {
"TELEGRAM_BOT_TOKEN": "<TELEGRAM_BOT_TOKEN>"
}
}
}
}Вместо <…> подставьте свои значения
Командой платформы
gemini mcp add -e TELEGRAM_BOT_TOKEN=<TELEGRAM_BOT_TOKEN> telegram-notify-mcp npx -y @parthj/telegram-notify-mcpВместо <…> подставьте свои значения
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о telegram-notify-mcp
Как установить telegram-notify-mcp в Claude Code?
Выполните команду claude mcp add telegram-notify-mcp -e TELEGRAM_BOT_TOKEN=<TELEGRAM_BOT_TOKEN> -- npx -y @parthj/telegram-notify-mcp. Перед запуском укажите токен, полученный у @BotFather.
Что делает telegram-notify-mcp?
Сервер даёт агенту возможность присылать текстовые сообщения, картинки и файлы в диалог Telegram. Это позволяет следить за автономной работой модели в фоновом режиме.
Почему бот не присылает сообщения после настройки?
Боту обязательно нужно написать команду /start в Telegram со своего аккаунта. Без этого сервер не сможет определить ID чата через метод getUpdates, а Telegram заблокирует отправку.
