~/products/telegram-mcp/install.md

Установка

Четыре шага и около пяти минут. Нужны Node.js (проверено на 22) и аккаунт Telegram.

git clone https://github.com/vixkosla/telegram-mcp.git
cd telegram-mcp
npm ci

1. Ключи приложения

На my.telegram.org → API development tools создайте приложение и запишите ключи в~/.config/telegram-mcp/config.json:

{"apiId": 123456, "apiHash": "32-символьный hex"}

Права на файл — 0600. Вместо файла можно задатьTELEGRAM_API_ID и TELEGRAM_API_HASH, другой путь — через TELEGRAM_MCP_CONFIG.

2. Вход

node server.mjs login

Телефон, код из официального Telegram, при необходимости облачный пароль. Сессия сохранится в session.txt рядом с сервером. В списке устройств Telegram появится новая сессия под именем вашего приложения с my.telegram.org.

Войти можно и из агента: login_send_code, затемlogin_sign_in. Код действует 10 минут.

3. Подключение к клиенту

Claude Code

claude mcp add telegram -- node /path/to/telegram-mcp/server.mjs

Codex

# ~/.codex/config.toml
[mcp_servers.telegram]
command = "node"
args = ["/path/to/telegram-mcp/server.mjs"]
startup_timeout_sec = 20

Cursor, Claude Desktop и другие

{
  "mcpServers": {
    "telegram": {
      "command": "node",
      "args": ["/path/to/telegram-mcp/server.mjs"]
    }
  }
}

4. Проверка

Попросите агента вызвать status. В ответе — имя аккаунта и последние четыре цифры номера.

Если Telegram недоступен

Когда MTProto с этой машины не доходит до серверов Telegram, добавьте прокси в тот же config.json:

{"apiId": 123456, "apiHash": "…", "proxy": "socks5://127.0.0.1:1080"}

Поддерживаются socks5:// и socks4://, с логином и паролем в адресе.