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) — баги в репо, исправлены локально на хосте
- backend/Dockerfile:
COPY frontend/package.json frontend/.npmrc ./ — не копировался package-lock.json, npm ci падал. Исправлено: COPY frontend/package.json frontend/package-lock.json frontend/.npmrc ./.
- backend/app/tg/manager.py:
NameError: TelegramClient — класс используется в аннотациях, но не импортирован. Исправлено: from telethon import TelegramClient, errors.
- 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).