---
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:**
  - SPA: https://tgclientmcp.gnexus.space/ (200 text/html)
  - health: https://tgclientmcp.gnexus.space/api/v1/health →
    `{"status":"ok","version":"0.1.0","accounts":{...},"db":"ok"}`
  - MCP: https://tgclientmcp.gnexus.space/mcp-protocol/ (streamable HTTP,
    stateless + json_response; initialize без токена → 200 с serverInfo
    tgclient; тулы требуют Bearer `mcp_*` или admin-токен)
- **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, TGCLIENT_AUTH_* (SSO),
    TGCLIENT_SYNAPSE_*.
  - 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).
