fast-mcp-telegram — MCP-сервер для Claude Code: Telegram из агента
Шлюз между ИИ-агентом и Telegram: 8 инструментов вместо десятков микрометодов, вход по QR-коду и HTTP-доступ к MTProto.
claude mcp add --transport http fast-mcp-telegram https://tg-mcp.l1979.ru/v1/mcpЧто делает fast-mcp-telegram
Сервер стоит между агентом и Telegram API: агент обращается по MCP или HTTP, дальше запрос уходит в MTProto. Вместо 80+ микрометодов наружу выставлены 8 инструментов — поиск по чатам и сообщениям, чтение по ID, отправка и правка, вложения, ответы в темах форумов. Один сервер обслуживает нескольких пользователей: каждому свой Bearer-токен и своя сессия Telegram.
Авторизация проходит через веб-страницу /setup: сканируете QR-код в мобильном Telegram (Настройки → Устройства → Сканировать QR) и получаете токен. Альтернатива — номер телефона с кодом и 2FA. Дальше можно скачать mcp.json и подключить сервер к клиенту, а можно дёргать API напрямую через curl, например messages.SendMessage.
Для локального запуска нужны API_ID и API_HASH из Telegram, а также SESSION_DIR для файлов сессий. Есть режим с префиксом имён инструментов — PREFIX_MCP_TOOLS_WITH_ACCOUNT — он нужен, когда один агент держит несколько подключений к одному серверу с разными токенами, иначе имена инструментов столкнутся. Для ограничения прав на общем хосте включают ACL_ENABLED с чат-линиями, read_only и списком заблокированных собеседников.
Какие задачи решает
- найти нужное сообщение в архиве чатов по нескольким запросам
- отправить файл или фото в чат прямо из агента
- прочитать ответы под постом в канале или в теме форума
- развести доступ нескольких пользователей к одному серверу по токенам
- дёрнуть произвольный метод Telegram API через curl
Примеры запросов агенту
- Отправь привет в мои сохранённые сообщения в Telegram
- Найди в переписке все упоминания договора и покажи контекст
- Прочитай ответы под последним постом в канале
Как установить fast-mcp-telegram
1Командой платформы: удалённый сервер
claude mcp add --transport http fast-mcp-telegram https://tg-mcp.l1979.ru/v1/mcp2Командой платформы
claude mcp add --env API_ID=<API_ID> --env API_HASH=<API_HASH> --env SERVER_MODE=<SERVER_MODE> --env SESSION_DIR=<SESSION_DIR> --transport stdio fast-mcp-telegram -- uvx fast-mcp-telegramВместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from fast-mcp-telegram <команда>
1Командой платформы: удалённый сервер
codex mcp add fast-mcp-telegram --url https://tg-mcp.l1979.ru/v1/mcp2Командой платформы
codex mcp add fast-mcp-telegram --env API_ID=<API_ID> --env API_HASH=<API_HASH> --env SERVER_MODE=<SERVER_MODE> --env SESSION_DIR=<SESSION_DIR> -- uvx fast-mcp-telegramВместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from fast-mcp-telegram <команда>
Файл настроек
{
"mcpServers": {
"fast-mcp-telegram": {
"url": "https://tg-mcp.l1979.ru/v1/mcp"
}
}
}{
"mcpServers": {
"fast-mcp-telegram": {
"command": "uvx",
"args": [
"fast-mcp-telegram"
],
"env": {
"API_ID": "<API_ID>",
"API_HASH": "<API_HASH>",
"SERVER_MODE": "<SERVER_MODE>",
"SESSION_DIR": "<SESSION_DIR>"
}
}
}
}Вместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from fast-mcp-telegram <команда>
Файл настроек
{
"servers": {
"fast-mcp-telegram": {
"type": "http",
"url": "https://tg-mcp.l1979.ru/v1/mcp"
}
}
}{
"servers": {
"fast-mcp-telegram": {
"type": "stdio",
"command": "uvx",
"args": [
"fast-mcp-telegram"
],
"env": {
"API_ID": "<API_ID>",
"API_HASH": "<API_HASH>",
"SERVER_MODE": "<SERVER_MODE>",
"SESSION_DIR": "<SESSION_DIR>"
}
}
}
}Вместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from fast-mcp-telegram <команда>
1Командой платформы: удалённый сервер
gemini mcp add -t http fast-mcp-telegram https://tg-mcp.l1979.ru/v1/mcp2Командой платформы
gemini mcp add -e API_ID=<API_ID> -e API_HASH=<API_HASH> -e SERVER_MODE=<SERVER_MODE> -e SESSION_DIR=<SESSION_DIR> fast-mcp-telegram uvx fast-mcp-telegramВместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from fast-mcp-telegram <команда>
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о fast-mcp-telegram
Как установить fast-mcp-telegram в Claude Code?
Для удалённого варианта: claude mcp add --transport http fast-mcp-telegram https://tg-mcp.l1979.ru/v1/mcp. Для локального: `claude mcp add --env API_ID=<API_ID> --env API_HASH=<API_HASH> --env SERVER_MODE=<SERVER_MODE> --env SESSION_DIR=<SESSION_DIR> --transport stdio fast-mcp-telegram -- uvx fast-mcp-telegram`.
Что делает fast-mcp-telegram?
Соединяет ИИ-агента с Telegram через MTProto и отдаёт 8 инструментов для поиска, чтения, отправки сообщений и работы с файлами. Один сервер может обслуживать нескольких пользователей с изолированными сессиями.
Что нужно для локального запуска?
API_ID и API_HASH из Telegram, а также каталог SESSION_DIR для файлов сессий. Сервер запускается через uvx fast-mcp-telegram.
