telegram-archive-mcp — MCP-сервер для Claude Code: обзор и запуск
Подключает ИИ-ассистента к вашей инсталляции Telegram-Archive для поиска сообщений, чтения истории переписки и просмотра прикреплённых картинок.
claude mcp add --env TELEGRAM_ARCHIVE_URL=<TELEGRAM_ARCHIVE_URL> --env TELEGRAM_ARCHIVE_USER=<TELEGRAM_ARCHIVE_USER> --env TELEGRAM_ARCHIVE_PASS=<TELEGRAM_ARCHIVE_PASS> --transport stdio telegram-archive-mcp -- npx -y telegram-archive-mcpЧто делает telegram-archive-mcp
Сервер связывается с инстансом Telegram-Archive через HTTP API по пути /api/login, используя логин и пароль учётной записи. Клиенту становятся доступны данные только для чтения: статистика архива, структура папок и списки диалогов по адресам telegram-archive://stats и telegram-archive://chats.
Поиск текста поддерживает пагинацию курсором, выборку тем в форумных супергруппах и фильтрацию сообщений за календарные сутки с учётом часового пояса через get_messages_by_date. Инструмент get_media передаёт модели найденные фотографии, автоматически ужимая снимки шире 1568 пикселей.
Без предварительно поднятого веб-сервиса Telegram-Archive запустить интеграцию не получится: сервер требует обязательный адрес в переменной TELEGRAM_ARCHIVE_URL.
Какие задачи решает
- найти реплики в архивированных чатах по ключевым фразам
- выгрузить переписку за конкретную дату с поправкой на часовой пояс
- передать модели фотографии из сообщений с автоматическим масштабированием
- разобрать закреплённые посты и темы форумов в сохранённых архивах
Примеры запросов агенту
- Изучи ресурс telegram-archive://chats и найди архивные группы по разработке
- Собери сообщения за вчерашний день через get_messages_by_date для часового пояса Europe/Berlin
- Загрузи фото из сообщения с помощью get_media и опиши схему на изображении
Как установить telegram-archive-mcp
Командой платформы
claude mcp add --env TELEGRAM_ARCHIVE_URL=<TELEGRAM_ARCHIVE_URL> --env TELEGRAM_ARCHIVE_USER=<TELEGRAM_ARCHIVE_USER> --env TELEGRAM_ARCHIVE_PASS=<TELEGRAM_ARCHIVE_PASS> --transport stdio telegram-archive-mcp -- npx -y telegram-archive-mcpВместо <…> подставьте свои значения
Командой платформы
codex mcp add telegram-archive-mcp --env TELEGRAM_ARCHIVE_URL=<TELEGRAM_ARCHIVE_URL> --env TELEGRAM_ARCHIVE_USER=<TELEGRAM_ARCHIVE_USER> --env TELEGRAM_ARCHIVE_PASS=<TELEGRAM_ARCHIVE_PASS> -- npx -y telegram-archive-mcpВместо <…> подставьте свои значения
Файл настроек
{
"mcpServers": {
"telegram-archive-mcp": {
"command": "npx",
"args": [
"-y",
"telegram-archive-mcp"
],
"env": {
"TELEGRAM_ARCHIVE_URL": "<TELEGRAM_ARCHIVE_URL>",
"TELEGRAM_ARCHIVE_USER": "<TELEGRAM_ARCHIVE_USER>",
"TELEGRAM_ARCHIVE_PASS": "<TELEGRAM_ARCHIVE_PASS>"
}
}
}
}Вместо <…> подставьте свои значения
Файл настроек
{
"servers": {
"telegram-archive-mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"telegram-archive-mcp"
],
"env": {
"TELEGRAM_ARCHIVE_URL": "<TELEGRAM_ARCHIVE_URL>",
"TELEGRAM_ARCHIVE_USER": "<TELEGRAM_ARCHIVE_USER>",
"TELEGRAM_ARCHIVE_PASS": "<TELEGRAM_ARCHIVE_PASS>"
}
}
}
}Вместо <…> подставьте свои значения
Командой платформы
gemini mcp add -e TELEGRAM_ARCHIVE_URL=<TELEGRAM_ARCHIVE_URL> -e TELEGRAM_ARCHIVE_USER=<TELEGRAM_ARCHIVE_USER> -e TELEGRAM_ARCHIVE_PASS=<TELEGRAM_ARCHIVE_PASS> telegram-archive-mcp npx -y telegram-archive-mcpВместо <…> подставьте свои значения
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о telegram-archive-mcp
Как установить telegram-archive-mcp в Claude Code?
Выполните команду `claude mcp add --env TELEGRAM_ARCHIVE_URL=<TELEGRAM_ARCHIVE_URL> --env TELEGRAM_ARCHIVE_USER=<TELEGRAM_ARCHIVE_USER> --env TELEGRAM_ARCHIVE_PASS=<TELEGRAM_ARCHIVE_PASS> --transport stdio telegram-archive-mcp -- npx -y telegram-archive-mcp`.
Что делает telegram-archive-mcp?
Предоставляет агенту инструменты для чтения архивов Telegram: поиск диалогов, постраничную навигацию по истории, просмотр медиафайлов и чтение тем на форумах.
Что нужно подготовить перед запуском этого MCP-сервера?
Необходим работающий экземпляр Telegram-Archive, к которому есть сетевой доступ, а также логин и пароль учётной записи просмотрщика.
