claude-ops-telegram-server — MCP-сервер для Claude Code
Подключает личный аккаунт Telegram к ассистенту через MTProto. Помогает разбирать входящие личные сообщения, искать переписки и отвечать в чатах.
claude mcp add claude-ops-telegram-server -e TELEGRAM_API_ID=<TELEGRAM_API_ID> -e TELEGRAM_API_HASH=<TELEGRAM_API_HASH> -e TELEGRAM_PHONE=<TELEGRAM_PHONE> -e TELEGRAM_SESSION=<TELEGRAM_SESSION> -- npx -y claude-ops-telegram-serverЧто делает claude-ops-telegram-server
Сервер работает через библиотеку gram.js по протоколу MTProto от лица личного профиля, а не бота из BotFather. Боты технически не видят чужие личные диалоги. Здесь же агент получает доступ к приватным перепискам, группам и каналам. В набор входят четыре инструмента: list_dialogs, get_messages, send_message и search_messages.
Для запуска понадобятся api_id и api_hash, полученные на https://my.telegram.org/apps. Перед добавлением в IDE нужно пройти интерактивную авторизацию с кодом из SMS и паролем двухфакторной аутентификации, чтобы сформировать токен TELEGRAM_SESSION.
Строка сессии даёт полный доступ к аккаунту: её нельзя передавать третьим лицам или сохранять в публичных репозиториях. При частых запросах Telegram может временно ограничить аккаунт на 15–30 минут.
Какие задачи решает
- читать личные сообщения и ветки диалогов прямо из рабочего окружения
- находить сообщения по ключевым словам сразу во всех чатах
- проверять список диалогов и количество непрочитанных уведомлений
- отправлять ответы контактам или писать в каналы от своего имени
Примеры запросов агенту
- Посмотри последние непрочитанные личные сообщения в Telegram через list_dialogs.
- Найди во всех переписках Telegram сообщения со словом «деплой».
- Отправь пользователю ответ в чат через инструмент send_message.
Как установить claude-ops-telegram-server
Командой платформы
claude mcp add claude-ops-telegram-server -e TELEGRAM_API_ID=<TELEGRAM_API_ID> -e TELEGRAM_API_HASH=<TELEGRAM_API_HASH> -e TELEGRAM_PHONE=<TELEGRAM_PHONE> -e TELEGRAM_SESSION=<TELEGRAM_SESSION> -- npx -y claude-ops-telegram-serverВместо <…> подставьте свои значения
Командой платформы
codex mcp add telegram-server --env TELEGRAM_API_ID=<TELEGRAM_API_ID> --env TELEGRAM_API_HASH=<TELEGRAM_API_HASH> --env TELEGRAM_PHONE=<TELEGRAM_PHONE> --env TELEGRAM_SESSION=<TELEGRAM_SESSION> -- npx -y claude-ops-telegram-serverВместо <…> подставьте свои значения
Файл настроек
{
"mcpServers": {
"telegram-server": {
"command": "npx",
"args": [
"-y",
"claude-ops-telegram-server"
],
"env": {
"TELEGRAM_API_ID": "<TELEGRAM_API_ID>",
"TELEGRAM_API_HASH": "<TELEGRAM_API_HASH>",
"TELEGRAM_PHONE": "<TELEGRAM_PHONE>",
"TELEGRAM_SESSION": "<TELEGRAM_SESSION>"
}
}
}
}Вместо <…> подставьте свои значения
Файл настроек
{
"servers": {
"telegram-server": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"claude-ops-telegram-server"
],
"env": {
"TELEGRAM_API_ID": "<TELEGRAM_API_ID>",
"TELEGRAM_API_HASH": "<TELEGRAM_API_HASH>",
"TELEGRAM_PHONE": "<TELEGRAM_PHONE>",
"TELEGRAM_SESSION": "<TELEGRAM_SESSION>"
}
}
}
}Вместо <…> подставьте свои значения
Командой платформы
gemini mcp add -e TELEGRAM_API_ID=<TELEGRAM_API_ID> -e TELEGRAM_API_HASH=<TELEGRAM_API_HASH> -e TELEGRAM_PHONE=<TELEGRAM_PHONE> -e TELEGRAM_SESSION=<TELEGRAM_SESSION> telegram-server npx -y claude-ops-telegram-serverВместо <…> подставьте свои значения
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о claude-ops-telegram-server
Как установить claude-ops-telegram-server в Claude Code?
Сначала получите api_id, api_hash и сгенерируйте сессию командой авторизации. Затем подключите сервер командой `claude mcp add claude-ops-telegram-server -e TELEGRAM_API_ID=<TELEGRAM_API_ID> -e TELEGRAM_API_HASH=<TELEGRAM_API_HASH> -e TELEGRAM_PHONE=<TELEGRAM_PHONE> -e TELEGRAM_SESSION=<TELEGRAM_SESSION> -- npx -y claude-ops-telegram-server`.
Зачем использовать MTProto вместо обычного Telegram-бота?
Стандартные боты не имеют доступа к личным перепискам между пользователями. Авторизация по MTProto позволяет агенту читать входящие сообщения и отвечать в приватных диалогах владельца аккаунта.
Что делать, если сервер выдаёт ошибку о недействительной сессии?
Потребуется заново запустить скрипт авторизации через node index.js --auth, подтвердить вход по коду и обновить значение переменной TELEGRAM_SESSION.
