🤖 KI-Integration — Claude & ChatGPT anbinden

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

In diesem Kapitel

1 Voraussetzungen 2 Claude (claude.ai) verbinden 3 ChatGPT (Custom GPT) verbinden 4 Claude Code CLI verbinden 5 Verfügbare Tools (Referenz)

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.

👁️

Standard: nur Lesezugriff

read-Scope. Schreiben (Notiz, Tags, Watchlist) nur mit zusätzlicher write-Freigabe — nie 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) und, falls die App ihn anfragt, getrennt davon den write-Scope (Journal-Notizen, Tags, Watchlist). Bestehende Verbindungen kannst du jederzeit auf der Konto-Seite KI-Integrationen einsehen und widerrufen. Unter jeder App steht ein Zugriffsprotokoll: die letzten Abfragen mit Zeitpunkt und Ergebnis (nicht deren Inhalt), automatisch gelöscht nach 90 Tagen.

2. Claude (claude.ai) verbinden

🤖

Claude · claude.ai

MCP-Connector

claude.ai öffnen → Settings → Integrations → Add more
Im Feld „MCP Server URL" eintragen: https://straderz.com/api/mcp.php
Auf Connect klicken → der Browser öffnet die sTraderZ.com-Login/Consent-Seite
Den read-Scope bestätigen (Lesezugriff auf die 13 Lese-Tools); den write-Scope nur, wenn die KI auch Notizen, Tags und Watchlist-Einträge anlegen darf
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.

ChatGPT öffnen → Explore GPTs → Create → Tab Configure → Add actions
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)
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 (optional zusätzlich write)
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)

✅ 13 Lese-Tools (read) · 3 Schreib-Tools (write, optional)

Die Lese-Tools brauchen den read-Scope. Die drei Schreib-Tools am Ende der Tabelle brauchen zusätzlich den write-Scope und können nur Notizen anlegen, Tags ergänzen oder entfernen und die Watchlist pflegen. Keine Trade-Ausführung, keine Änderung an Konten oder Brokern. Jeder Aufruf erscheint in deinem Zugriffsprotokoll.

Tool	Scope	Beschreibung
`list_accounts`	read	Alle verknüpften Broker-Konten
`get_portfolio_overview`	read	Gesamtportfolio, Positionen, Gewinne
`list_positions`	read	Offene Positionen je Konto
`list_trades`	read	Letzte N Trades (mit Filter)
`get_trade_detail`	read	Vollständige Details eines Trade-Zyklus
`get_performance`	read	Performance-Metriken (Zeitraum wählbar)
`get_tax_report`	read	Steuerreport-Zusammenfassung (VZ wählbar)
`get_cashflow`	read	Ein-/Auszahlungen, Netto-Einzahlung, Cash-Bewegungen
`list_dividends`	read	Dividenden-Historie inkl. Quellensteuer
`get_allocation`	read	Aufteilung nach Asset-Klasse / Sektor / Währung
`list_trade_labels`	read	Eigene Tags & Strategien (IDs für Auswertungen)
`get_label_performance`	read	Kennzahlen je Tag/Strategie (PnL, Trefferquote, Profit-Faktor)
`search_handbook`	read	Durchsucht das Handbuch und die Cheatsheets (kontounabhängig)
`add_journal_note`	write	Notiz an einen Trade anhängen (als „KI“ gekennzeichnet) oder privaten Journal-Eintrag anlegen, optional mit einem Zyklus verknüpft
`set_trade_tags`	write	Tags eines Trade-Zyklus ergänzen oder entfernen (andere Tags bleiben)
`manage_watchlist`	write	Symbol auf eine Watchlist setzen oder entfernen (automatische Watchlisten sind schreibgeschützt)