t212-mcp

Ein MCP-Server, der Ihr Trading212-Konto (Zusammenfassung, Portfolio, Bargeld, Orderverlauf, Dividenden) als Tools bereitstellt, um direkt als benutzerdefinierter Remote-Connector mit claude.ai verbunden zu werden.

Da claude.ai diesen Server über das öffentliche Internet erreicht und Ihr T212-Konto live ist, erfordert der Server eine OAuth-Anmeldung (ein von Ihnen festgelegtes Passwort), bevor er Tool-Aufrufe ausführt – siehe auth.py.

0. Holen Sie den Code auf den VPS und installieren Sie die Voraussetzungen

git clone <this-repo-url> t212-mcp && cd t212-mcp

Sie benötigen auf dem VPS: git, rsync und uv systemweit installiert (nicht nur unter Ihrem eigenen $HOME, da die App später als eigener dedizierter Systembenutzer ohne Home-Verzeichnis läuft):

curl -LsSf https://astral.sh/uv/install.sh | sh
sudo cp "$HOME/.local/bin/uv" /usr/local/bin/uv

Related MCP server: Trading212 MCP Server

1. Konfigurieren

python3 setup_wizard.py

Führt Sie interaktiv durch: Ihre T212-API-Schlüssel/Secret, eine Domain (bietet eine kostenlose <ip>.sslip.io-Domain an, falls Sie keine eigene haben) und das Anmeldepasswort – schreibt dann .env mit chmod 600. Sie können es jederzeit erneut ausführen, um .env von Grund auf neu zu generieren (es fragt vor dem Überschreiben).

Sie möchten lieber von Hand bearbeiten? cp .env.example .env und füllen Sie aus:

• T212_API_KEY / T212_API_SECRET — von Trading212 → Einstellungen → API (Schlüssel/Secret-Paar, Basic-Auth).

• T212_ENV — live oder demo.

• MCP_PUBLIC_URL — die HTTPS-URL, unter der dieser Server erreichbar sein wird, z. B. https://mcp.example.com (ohne abschließenden Schrägstrich). Muss mit Ihrer DNS- und Reverse-Proxy-Konfiguration übereinstimmen.

• MCP_DOMAIN — derselbe Host wie oben, ohne das Schema (Caddy verwendet dies, um ein TLS-Zertifikat anzufordern).

• MCP_AUTH_PASSWORD — ein Passwort, das nur Sie kennen; Sie geben es einmal im Browser ein, wenn Sie Claude verbinden.

2. DNS auf Ihren VPS ausrichten

Erstellen Sie einen A/AAAA-Eintrag für die Domain in MCP_DOMAIN, der auf die IP Ihres VPS zeigt. Die Ports 80 und 443 müssen aus dem Internet erreichbar sein.

Bevor Sie unten einen TLS-Reverse-Proxy installieren, prüfen Sie, ob auf diesem Rechner bereits etwas an 80/443 gebunden ist (ein vorhandener nginx/Caddy, der andere Websites bedient):

sudo ss -tlnp | grep -E ':80|:443'

3. Ausführen

sudo useradd --system --no-create-home --shell /usr/sbin/nologin t212mcp
sudo mkdir -p /opt/t212-mcp
sudo rsync -a --exclude .venv --exclude __pycache__ --exclude .git ./ /opt/t212-mcp/
sudo chown -R t212mcp:t212mcp /opt/t212-mcp
cd /opt/t212-mcp
# t212mcp has no home dir, so point uv's cache somewhere it can write:
sudo -u t212mcp env HOME=/opt/t212-mcp UV_CACHE_DIR=/opt/t212-mcp/.cache/uv \
    uv sync --frozen --no-dev

sudo cp deploy/t212-mcp.service /etc/systemd/system/
sudo systemctl daemon-reload
sudo systemctl enable --now t212-mcp

Stellen Sie dann TLS davor auf Port 8000, je nachdem, was ss -tlnp oben gezeigt hat:

• Nichts läuft auf 80/443 — installieren Sie Caddy (ein einzelnes statisches Binary, ~10-20 MB RAM im Leerlauf) und richten Sie es auf deploy/Caddyfile aus:

  sudo apt install -y debian-keyring debian-archive-keyring apt-transport-https
  curl -1sLf 'https://dl.cloudsmith.io/public/caddy/stable/gpg.key' | sudo gpg --dearmor -o /usr/share/keyrings/caddy-stable-archive-keyring.gpg
  curl -1sLf 'https://dl.cloudsmith.io/public/caddy/stable/debian.deb.txt' | sudo tee /etc/apt/sources.list.d/caddy-stable.list
  sudo apt update && sudo apt install -y caddy
  set -a; source .env; set +a
  sudo bash -c "sed 's/{\$MCP_DOMAIN}/'\"$MCP_DOMAIN\"'/' deploy/Caddyfile > /etc/caddy/Caddyfile"
  sudo systemctl reload caddy

• nginx läuft bereits für andere Websites — kopieren Sie deploy/nginx.conf.example nach /etc/nginx/sites-available/t212-mcp, ersetzen Sie darin mcp.example.com durch Ihre echte $MCP_DOMAIN, verlinken Sie es in sites-enabled, führen Sie nginx -t && systemctl reload nginx aus, dann sudo certbot --nginx -d $MCP_DOMAIN (berührt Ihre vorhandenen Serverblöcke nicht).

Prüfen Sie, ob es läuft:

curl https://$MCP_DOMAIN/.well-known/oauth-authorization-server

4. Mit Claude verbinden

In claude.ai: Einstellungen → Connectors → Benutzerdefinierten Connector hinzufügen, fügen Sie https://<MCP_DOMAIN>/mcp als URL ein. Claude öffnet einen Browser-Tab mit der Anmeldeseite dieses Servers — geben Sie MCP_AUTH_PASSWORD ein — und Sie werden zurückgeleitet, verbunden.

Lokale Entwicklung

uv run python server.py führt denselben streamable-HTTP- und OAuth-Server lokal auf HOST:PORT aus (Standard 0.0.0.0:8000) — MCP_PUBLIC_URL und MCP_AUTH_PASSWORD sind auch für lokale Ausführungen erforderliche Umgebungsvariablen, da der OAuth-Anbieter bedingungslos eingebunden ist. Richten Sie MCP_PUBLIC_URL für lokale Tests auf http://127.0.0.1:8000 (kein TLS, kein Claude-Connector, nur zum Testen des Tool-Codes und des OAuth-Ablaufs mit curl).