Verwendung
Nach der Installation und Konfiguration steht dir der PortDive MCP-Server als Werkzeug in deinem KI-Assistenten zur Verfügung. Hier erfährst du, wie du ihn im Alltag nutzt.
Verfügbare Tools
Der MCP-Server stellt 47 Tools in 8 Kategorien bereit:
Marktdaten
| Tool | Beschreibung |
|---|---|
list_available_tickers | Alle verfügbaren Ticker mit Exchange-/Timeframe-Verfügbarkeit und Datenaktualität |
get_ohlcv_with_indicators | OHLCV-Kerzen mit technischen Indikatoren — Multi-Timeframe, kompaktes Spaltenformat |
Multi-Timeframe-Analyse (MTA)
| Tool | Beschreibung |
|---|---|
get_mta_snapshot | Aktueller MTA-Snapshot: Komposit-Score/Grade, Signal-Aufschlüsselung, Positionsgrößen mit ATR-Stops |
list_mta_snapshots | MTA-Snapshot-Verlauf — verfolge, wie sich das MTA-Grade eines Tickers über die Zeit verändert |
Investment-Thesen
| Tool | Beschreibung |
|---|---|
list_theses | Thesen auflisten — eigene, offizielle oder nach Status filtern |
get_thesis | Vollständige These mit Baskets, Ticker-Gruppen und Klonzuordnung |
create_thesis | Neue These erstellen mit inline Basket- und Ticker-Definition |
update_thesis | These aktualisieren — nur geänderte Felder werden überschrieben |
delete_thesis | These dauerhaft löschen |
get_thesis_signals | Aggregierte Trading-Signale für eine These oder einen Basket |
get_thesis_performance | Synthetische Equal-Weight-Portfolio-Performance seit Erstellung |
get_thesis_history | Versions-Historie — jede Mutation wird automatisch archiviert |
list_thesis_templates | Starter-Templates für neue Thesen (de/en) |
Basket-Verwaltung
| Tool | Beschreibung |
|---|---|
add_basket | Neuen Basket (Ticker-Gruppe) zu einer These hinzufügen |
update_basket | Basket-Metadaten aktualisieren (Beschreibung, Entry-/Exit-Regeln) |
manage_basket_items | Ticker zu einem Basket hinzufügen oder entfernen |
Skills & Prompts
| Tool | Beschreibung |
|---|---|
list_skills | Skills durchsuchen — offiziell, Community oder eigene |
get_skill | Skill-Details abrufen: Body, Parameter, Tags, Ressourcen, Playbook-DAG |
run_skill | Skill ausführen — assembliert den Prompt mit Parametern und referenzierten Tools |
create_skill | Eigenen Skill erstellen — wiederverwendbare Prompt-Templates mit {{param}} Platzhaltern |
update_skill | Skill aktualisieren — archiviert automatisch die vorherige Version |
delete_skill | Eigenen Skill löschen |
clone_skill | Öffentlichen Skill in den eigenen Workspace klonen |
get_skill_resource | Ressource eines Skills abrufen (Referenzdokumente, Skripte) |
get_skill_history | Skill-Versionsverlauf |
attach_skill_to_thesis | Skill an eine These anhängen — erscheint als empfohlener Workflow |
list_thesis_skills | An eine These angehängte Skills auflisten |
validate_playbook_dag | Playbook-DAG-Struktur vor dem Speichern validieren |
add_skill_resource | Ressource zu einem Skill hinzufügen |
delete_skill_resource | Ressource aus einem Skill entfernen |
upload_skill_asset | Datei-Asset zu einem Skill hochladen |
delete_skill_asset | Datei-Asset eines Skills löschen |
Analyse & Gesundheit
| Tool | Beschreibung |
|---|---|
get_thesis_health | Umfassender Gesundheitscheck: Signale, Performance, Versionsverlauf, Skills, Datenaktualität |
suggest_thesis_structure | Kontext für KI-gestützte These-Strukturierung mit allen verfügbaren Tickern |
Alpha-Log
| Tool | Beschreibung |
|---|---|
add_alpha_log_entry | Analyse-Ergebnis, Entscheidung oder Snapshot protokollieren |
list_alpha_log_entries | Timeline-Einträge gefiltert nach These, Ticker oder Skill |
get_alpha_log_entry | Vollständigen Alpha-Log-Eintrag mit Markdown-Inhalt abrufen |
upload_alpha_log_attachment | Datei an einen Alpha-Log-Eintrag anhängen |
generate_alpha_log_upload_url | Presigned Upload-URL für Datei-Anhänge generieren |
delete_alpha_log_attachment | Datei-Anhang eines Alpha-Log-Eintrags löschen |
KI-Prompts
Zusätzlich zu den Tools stehen 7 geführte KI-Prompts bereit, die Claude durch strukturierte Analyse-Workflows leiten:
| Prompt | Beschreibung |
|---|---|
draft-thesis | Strukturierte These aus einer Idee aufbauen — Baskets, Ticker, Allokation |
thesis-health-check | Umfassender Gesundheitscheck: Vollständigkeit, Signale, Diversifikation |
contrarian-challenge | Devil's Advocate: Bärenfälle, versteckte Risiken, Korrelationsfallen |
signals-briefing | Aktuelle Marktsignale über eine These synthetisieren |
rebalance-analysis | Portfolio-Drift und Rebalancing-Möglichkeiten analysieren |
ticker-due-diligence | Deep-Dive auf einen einzelnen Ticker im These-Kontext |
basket-entry-exit-rules | Markdown Entry-/Exit-Regeln für einen Basket generieren |
Investment-Thesen erstellen
Thematische These: „AI Picks & Shovels"
Erstelle eine These rund um die KI-Infrastruktur — die Unternehmen, die „Schaufeln und Spitzhacken" an den KI-Goldrausch verkaufen:
Erstelle eine neue Investment-These „AI Picks & Shovels" über PortDive.
Gist: Die These investiert in Unternehmen, die die Infrastruktur
für den KI-Boom bereitstellen — Rechenkapazität, Halbleiter,
Cloud-Plattformen und Dateninfrastruktur.
Erstelle zwei Baskets:
1. „GPU & Compute" mit NVDA (NASDAQ), AMD (NASDAQ), NBIS (NASDAQ)
2. „Cloud & Daten" mit AMZN (NASDAQ), MSFT (NASDAQ), GOOG (NASDAQ)
Benchmark-These: „Mag 7"
Erstelle eine These „Magnificent 7" über PortDive.
Gist: Die sieben größten US-Tech-Unternehmen als Benchmark-Portfolio.
Ein Basket „Core" mit: AAPL, MSFT, AMZN, GOOG, META, NVDA, TSLA
— alle an der NASDAQ.
Bestehende Thesen analysieren
Überblick über deine Portfolios:
Liste alle meine Investment-Thesen über PortDive auf.
Zeige mir für jede These die aktuelle Performance und die
aggregierten Signale mit Grade und Verdict.
Tiefergehender Gesundheitscheck einer These:
Führe einen Gesundheitscheck für meine These „AI Picks & Shovels"
über PortDive durch. Prüfe Signalqualität, Datenaktualität
und Diversifikation.
Devil's Advocate gegen eine These:
Nutze den PortDive „contrarian-challenge" Prompt für meine
These „AI Picks & Shovels". Zeige mir Bärenfälle,
Korrelationsrisiken und Szenarien, in denen die These scheitert.
Offizielle Skills anwenden
Skills sind wiederverwendbare Analyse-Workflows, die du auf beliebige Ticker anwenden kannst. Die offiziellen Skills findest du in der Skill-Bibliothek.
Fundamental Valuation mit NBIS
Zeige mir die offiziellen Skills über PortDive.
Wende den Skill „Fundamental Valuation" auf den Ticker NBIS an.
Claude verwendet list_skills (scope: official), findet den Skill, und führt ihn mit run_skill aus. Der Skill assembliert einen strukturierten Analyse-Prompt, der die verfügbaren OHLCV-Daten und Indikatoren für NBIS einbezieht.
Macro Risk Overlay mit SPY
Finde den offiziellen PortDive-Skill „Macro Risk Overlay" und
wende ihn auf SPY an. Bewerte die aktuellen Makrorisiken
für den S&P 500.
Skills an Thesen anhängen
Ordne wiederkehrende Analyse-Workflows direkt deiner These zu:
Hänge den Skill „Fundamental Valuation" an meine These
„AI Picks & Shovels" an. Dann führe ihn für alle Ticker
im Basket „GPU & Compute" aus.
Angehängte Skills erscheinen als empfohlene Workflows, wenn du die These das nächste Mal analysierst.
Eigene Skills erstellen
Erstelle einen neuen PortDive-Skill „Weekly Thesis Review".
Body:
Führe einen wöchentlichen Review für die These {{thesis_name}} durch:
1. Hole die aktuellen Signale und Performance
2. Vergleiche mit der letzten Woche
3. Identifiziere Handlungsbedarf
Parameter: thesis_name (string, required)
Tags: review, weekly, thesis
Tipps
- Sei spezifisch: Nenne Ticker und Timeframe, wenn du bestimmte Daten abfragst
- Kombiniere Tools: Claude kann mehrere MCP-Tools in einer Anfrage nutzen, um ein vollständiges Bild zu erstellen
- Nutze Prompts: Die 7 geführten KI-Prompts (
draft-thesis,thesis-health-check, etc.) bieten strukturierte Workflows für komplexe Analysen - Alpha-Log: Protokolliere wichtige Erkenntnisse mit
add_alpha_log_entry— sie stehen dir in zukünftigen Analysen als Kontext zur Verfügung - Markdown überall: Textfelder wie Gist, Beschreibung und Entry-/Exit-Regeln unterstützen Markdown-Formatierung
Fehlerbehebung
Der MCP-Server wird nicht erkannt
- Prüfe, ob die Datei
claude_desktop_config.jsonkorrekt formatiert ist (valides JSON) - Stelle sicher, dass der Pfad
/usr/local/bin/portdive-mcpexistiert - Starte Claude Desktop vollständig neu (
⌘ + Q, dann erneut öffnen)
Authentifizierungsfehler
- Überprüfe, ob dein Token gültig ist (nicht widerrufen)
- Erstelle bei Bedarf einen neuen Token in den PortDive-Einstellungen
- Stelle sicher, dass dein Abonnement aktiv ist (INTELLIGENCE oder PREMIUM)
Verbindungsprobleme
- Prüfe deine Internetverbindung
- Teste den Health-Check:
portdive-mcp --healthim Terminal - Der MCP-Server verbindet sich automatisch mit
https://api.portdive.app— eine manuelle Konfiguration ist nicht nötig