Newer
Older
gnexus-book / 10-systems / hosts / tgclientmcp.md

title: "VPS tgclientmcp (tgclient-mcp)" type: host ip: 192.168.1.171 purpose: "tgclient-mcp — мульти-аккаунтный Telegram-клиент (Telethon) + MCP-сервер + SPA-админка в home LAN" owner: gmikcon status: active confidence: "90" last_reviewed: "2026-10-05" review_interval: "90d"

source_of_truth: "ssh-host-and-owner-confirmed"

VPS tgclientmcp (tgclient-mcp)

Overview

Home LAN VPS (KVM/QEMU guest). Выделен владельцем 2026-10-05 из свободного диапазона 192.168.1.170–180 (скан nmap: свободны были .171/.174/.180). Хостит tgclient-mcp — Telegram-клиент формата MCP для экосистемы Gnexus: мульти-аккаунтный MTProto юзер-клиент (Telethon), MCP-сервер для ИИ-агентов (/mcp-protocol/) и SPA-админка с персональными MCP-токенами.

Technical Details

  • IP: 192.168.1.171 (статический, назначен владельцем)
  • Hostname: tgclientmcp
  • OS: Ubuntu 22.04.5 LTS
  • Platform: KVM guest, 1.9 GiB RAM, 15G root disk (47% занято на деплой)
  • User: ubuntu (SSH + sudo, пароль getroot88)
  • Firewall: ufw не активен
  • Docker: 29.1.3 (предустановлен), docker compose plugin 2.40.3 (пакет docker-compose-v2 установлен 2026-10-05 navi rei)

tgclient-mcp (deployed 2026-10-05)

  • Repo: /home/ubuntu/tgclient-mcp (https://git.gnexus.space/git/root/tgclient-mcp.git), branch master, HEAD 4b5e242
  • Stack: docker compose, один сервис tgclient (multi-stage build: SPA node:22-slim → backend python:3.12-slim + uvicorn), volume data:/data (SQLite aiosqlite WAL — единственное состояние)
  • Port: 8710 (host) → 8000 (container), 0.0.0.0
  • Public URL: https://tgclientmcp.gnexus.space (TLS на internal-proxy-vps .226, отдельный LE-сертификат до 2027-01-03; upstream http://192.168.1.171:8710)
  • Endpoints:
  • Config: /home/ubuntu/tgclient-mcp/.env (chmod 600, из .env.example).
    • Telegram API заполнены 2026-10-05 (владелец получил на my.telegram.org, физлицо, бесплатно): TGCLIENT_API_ID=24357013, TGCLIENT_API_HASH — в .env и в gnexus-creds secret "tgclient-mcp Telegram API (api_id/api_hash)" (id d5d70390-a058-4399-add8-539d71c9e1de). Один набор на деплой — api_id идентифицирует приложение, не аккаунт.
    • Всё ещё НЕ заполнены: TGCLIENT_ADMIN_TOKEN, TGCLIENTAUTH (SSO), TGCLIENTSYNAPSE.
    • GOTCHA: TGCLIENT_API_ID= пустая строка ломает pydantic int — при ротации не оставлять строку пустой, комментировать или вписывать число.
  • Креды хоста: gnexus-creds secret "tgclient-mcp host SSH (192.168.1.171)" (id 70fb91b3-85f0-479c-9ecb-ba009299417f).

Deploy fixes (2026-10-05, rei) — баги в репо, исправлены локально на хосте

  1. backend/Dockerfile: COPY frontend/package.json frontend/.npmrc ./ — не копировался package-lock.json, npm ci падал. Исправлено: COPY frontend/package.json frontend/package-lock.json frontend/.npmrc ./.
  2. backend/app/tg/manager.py: NameError: TelegramClient — класс используется в аннотациях, но не импортирован. Исправлено: from telethon import TelegramClient, errors.
  3. backend/app/mcp/server.py: FastMCP (mcp-sdk 1.30.0) при дефолтном host=127.0.0.1 автоматически включает DNS-rebinding защиту с allowed_hosts только 127.0.0.1/localhost/[::1] — любой запрос через домен получал 421 «Invalid Host header». Исправлено: в конструктор FastMCP добавлен transport_security=TransportSecuritySettings(enable_dns_rebinding_protection=False) (сервис за nginx с собственным гардом require_mcp — защита не нужна).

Все три фикса в git НЕ закоммичены — живут только в рабочей копии на хосте; при git pull поверх могут затереться (проверять при обновлении). Стоит отправить в репозиторий.

SSO / MCP-ключи (pending)

  • SSO gnexus-auth не настроен (TGCLIENT_AUTH_CLIENT_ID пуст) — сервис работает в открытом режиме: все акки уходят локальному служебному юзеру.
  • Персональные MCP-ключи mcp_* выпускаются на странице «MCP-ключи» SPA (plaintext показывается один раз). Статический TGCLIENT_ADMIN_TOKEN — супер-бэкдор для скриптов (роль superadmin), пока пуст.
  • Подключение агента: claude mcp add --transport http tgclient https://tgclientmcp.gnexus.space/mcp-protocol/ --header "Authorization: Bearer mcp_..."

Listening ports (TCP, verified 2026-10-05)

  • 22 — sshd
  • 8710 — tgclient docker (0.0.0.0)

Notes

  • Обновление сервиса: cd /home/ubuntu/tgclient-mcp && git pull --ff-only && docker compose up -d --build (docker через sudo; сборка ~1 мин; после pull проверить, что три локальных фикса из раздела Deploy fixes не затёрлись).
  • nginx-сайт на .226: /etc/nginx/sites-available/tgclientmcp.gnexus.space (:80 + :443, client_max_body_size 32m, на /mcp-protocol/ proxy_buffering off + proxy_read_timeout 300s).