7.7

🤖 KI-Integration — Claude & ChatGPT anbinden

Schritt für Schritt: Claude, ChatGPT und Claude Code CLI mit deinem sTraderZ.com-Konto verbinden

1. Voraussetzungen

Die KI-Integration ist ab dem Basic-Tarif verfügbar (nicht im Free-Tarif). Du verbindest deinen KI-Client per OAuth mit deinem sTraderZ.com-Konto — der Client erhält dann nur Lesezugriff auf deine Trading-Daten.

MCP-Endpunkt
https://straderz.com/api/mcp.php

⚠️ Die URL muss exakt so lauten — mit .php, ohne Schrägstrich am Ende.

💎

Ab Basic-Tarif

Im Free-Tarif nicht verfügbar.

👁️

Nur Lesezugriff

read-Scope — keine Trade-Ausführung.

🔓

Jederzeit widerrufbar

Konto-Seite „KI-Integrationen".

Beim ersten Verbinden öffnet sich ein Autorisierungs-Dialog. Dort bestätigst du den read-Scope (Lesezugriff). Bestehende Verbindungen kannst du jederzeit auf der Konto-Seite KI-Integrationen einsehen und widerrufen.

2. Claude (claude.ai) verbinden

🤖
Claude · claude.ai
MCP-Connector
  1. claude.ai öffnen → SettingsIntegrationsAdd more
  2. Im Feld „MCP Server URL" eintragen: https://straderz.com/api/mcp.php
  3. Auf Connect klicken → der Browser öffnet die sTraderZ.com-Login/Consent-Seite
  4. Den read-Scope bestätigen (Lesezugriff auf die 10 Tools)
  5. Zurück in claude.ai erscheint der Server als aktiv → im Chat testen: „Zeig mir meine letzten 5 Trades"
Wichtig: Die URL muss exakt https://straderz.com/api/mcp.php lauten (mit .php, ohne Schrägstrich am Ende).

3. ChatGPT (Custom GPT) verbinden

💬
ChatGPT · Custom GPT
OpenAPI Actions

ChatGPT Custom GPTs nutzen OpenAPI/Actions (nicht MCP/JSON-RPC). Dafür gibt es einen separaten REST-Adapter — der MCP-Endpunkt für Claude bleibt davon unberührt.

  1. ChatGPT öffnen → Explore GPTsCreate → Tab ConfigureAdd actions
  2. Im Feld „Schema" die URL eintragen: https://straderz.com/api/mcp-openapi-schema.php → ChatGPT importiert das Schema automatisch (alle 10 Tools erscheinen als Actions)
  3. Authentication → OAuth → folgende Werte eintragen:
    • Client ID + Secretaus der sTraderZ-Admin-Seite kopieren
    • Authorization URLhttps://straderz.com/oauth/authorize.php
    • Token URLhttps://straderz.com/oauth/token.php
    • Scoperead
  4. Speichern → im GPT-Chat testen: „Zeig mir meine letzten 5 Trades"
Hinweis: ChatGPT-Actions erfordern einen verifizierten Account auf platform.openai.com.

4. Claude Code CLI verbinden

💻
Claude Code CLI
Lokaler MCP-Server

Konfiguration in ~/.claude/settings.json (oder projektlokal .claude/settings.json):

settings.json
{
  "mcpServers": {
    "straderz": {
      "type": "http",
      "url": "https://straderz.com/api/mcp.php",
      "headers": {
        "Authorization": "Bearer <dein-access-token>"
      }
    }
  }
}
Token-Beschaffung: Im Browser https://straderz.com/oauth/authorize.php?client_id=...&scope=read öffnen und den OAuth-Flow durchführen. Das resultierende Access-Token in die settings.json eintragen. Da Claude Code HTTP-MCP-Server mit statischen Bearer-Tokens unterstützt, ist kein separates CLI-Auth-Kommando nötig. Das Token läuft 90 Tage (Erneuerung über die Konto-Seite).

Verifikation im Terminal:

bash
claude mcp list
# → straderz: https://straderz.com/api/mcp.php (connected)

Beispiel-Aufruf:

bash
claude "Wie hoch ist mein realisierter Gewinn in 2025?"

5. Verfügbare Tools (Referenz)

✅ 10 Lese-Tools · nur read-Scope

Alle Tools sind ausschließlich lesend (read-Scope). Keine Trade-Ausführung, keine Broker-Mutationen.

ToolScopeBeschreibung
list_accountsreadAlle verknüpften Broker-Konten
get_portfolio_overviewreadGesamtportfolio, Positionen, Gewinne
list_positionsreadOffene Positionen je Konto
list_tradesreadLetzte N Trades (mit Filter)
get_trade_detailreadVollständige Details eines Trade-Zyklus
get_performancereadPerformance-Metriken (Zeitraum wählbar)
get_tax_reportreadSteuerreport-Zusammenfassung (VZ wählbar)
get_cashflowreadEin-/Auszahlungen, Netto-Einzahlung, Cash-Bewegungen
list_dividendsreadDividenden-Historie inkl. Quellensteuer
get_allocationreadAufteilung nach Asset-Klasse / Sektor / Währung
list_trade_labelsreadEigene Tags & Strategien (IDs für Auswertungen)
get_label_performancereadKennzahlen je Tag/Strategie (PnL, Trefferquote, Profit-Faktor)