Claude Code
Füge WhyVault als Remote-MCP-Server zu Claude Code hinzu – ein Befehl, und Claude Code merkt sich deine Entscheidungen über alle Projekte hinweg.
Stand der Anleitung: 26. September 2026. Getestet mit Claude Code 2.1.
Voraussetzungen
- Claude Code: eine aktuelle Version mit Unterstützung für entfernte MCP-Server über HTTP. Getestet mit 2.1;
claude updatebringt dich auf den neuesten Stand,claude --versionzeigt, was du hast. - Claude-Konto: womit du Claude Code eben nutzt – ein Claude-Plan oder ein API-Konto. Für WhyVault ist das egal.
- WhyVault: jedes Konto, auch Free.
- Anmeldung wählen: ein Zugangsschlüssel (geht überall, auch auf Servern und in Containern) oder OAuth im Browser (kein Schlüssel, um den du dich kümmern musst).
Einrichten
WhyVault hinzufügen
Mit Zugangsschlüssel – am schnellsten. Leg in der App unter Agenten verbinden einen Schlüssel an; die App zeigt dir danach genau diesen Befehl zum Kopieren:
claude mcp add --transport http --scope user whyvault https://mcp.whyvault.io --header "Authorization: Bearer wv_…"Oder mit Anmeldung im Browser, ohne Schlüssel:
claude mcp add --transport http --scope user whyvault https://mcp.whyvault.ioAnmelden (nur ohne Schlüssel)
Starte danach Claude Code, tippe /mcp, wähle whyvault und melde dich im Browser an – oder führe claude mcp login whyvault aus.
Nach der Zustimmung zeigt der Browser, dass du zurück ins Terminal kannst. claude mcp list sollte whyvault jetzt als verbunden anzeigen.
Ausprobieren
Frag in einem beliebigen Projekt:
Lies mein WhyVault und sag mir, welche Entscheidungen es zu diesem Projekt gibt.Claude Code ruft zuerst vault_overview auf und sucht dann gezielt. Jede Änderung steht in deinem WhyVault-Verlauf unter dem Namen der Verbindung.
Mit --scope user ist WhyVault in allen Projekten verfügbar; lässt du die Option weg, nur im aktuellen Ordner.
Scopes: wo die Verbindung gilt
| Scope | Wo sie steht | Gut für |
|---|---|---|
user | deine Claude-Code-Einstellungen | ein Gedächtnis für alle Projekte – der Normalfall |
local (Standard) | deine Einstellungen, nur für den Ordner | zum Ausprobieren in einem Projekt |
project | .mcp.json im Repository | die Einrichtung mit dem Team teilen |
Bei project gehört nie ein Zugangsschlüssel ins Repository. Nimm OAuth ohne --header – dann meldet sich jeder mit seinem eigenen Konto an – oder verweise in .mcp.json auf eine Umgebungsvariable, etwa "Authorization": "Bearer ${WHYVAULT_KEY}".
WhyVault und CLAUDE.md
CLAUDE.md beschreibt dieses Repository: Befehle, Konventionen, Architektur. WhyVault hält, was über ein Repository hinausgeht: warum etwas entschieden wurde, was du probiert und verworfen hast, was für alle deine Projekte gilt. Beides ergänzt sich. Mit ein paar Zeilen in ~/.claude/CLAUDE.md nutzt Claude Code das Gedächtnis, ohne dass du fragen musst:
## Gedächtnis
- WhyVault (MCP-Server „whyvault“) ist mein Langzeitgedächtnis über alle Projekte.
- Vor größeren Änderungen in WhyVault nach früheren Entscheidungen zum Thema suchen.
- Entscheiden wir etwas mit Folgen, im Raum des Projekts in WhyVault festhalten.Fehlerbehebung
Es öffnet sich kein Browserfenster
Auf einem Server, in einem Container oder per SSH gibt es oft keinen Browser. Nimm dann einen Zugangsschlüssel: Entferne den Eintrag mit claude mcp remove whyvault und leg ihn mit --header neu an.
claude mcp list meldet, dass eine Anmeldung fehlt
Du hast WhyVault ohne Schlüssel eingetragen und dich noch nicht angemeldet – oder die Anmeldung ist abgelaufen. Starte Claude Code, tippe /mcp, wähle whyvault und melde dich neu an.
Die Anmeldeseite kommt nicht zurück ins Terminal
Während der Anmeldung wartet Claude Code auf den Browser auf deinem eigenen Rechner. Lass Claude Code offen, bis der Browser meldet, dass du fertig bist. Läuft der Browser auf einem anderen Rechner als Claude Code, nimm einen Zugangsschlüssel.
In einem Projekt fehlt WhyVault
Du hast es ohne --scope user eingetragen, also gilt es nur in dem Ordner, in dem du den Befehl ausgeführt hast. Prüf das mit claude mcp list im Projekt und trag es mit --scope user neu ein.
Fehler 401 mit Zugangsschlüssel
Der Schlüssel wurde widerrufen, ist vertippt oder unvollständig. Schlüssel werden nur einmal angezeigt – leg unter Agenten verbinden einen neuen an und kopier den Befehl erneut. Der Header muss Authorization: Bearer wv_… lauten.
Die Schreib-Werkzeuge fehlen
Schlüssel oder Verbindung stehen auf nur lesen. Ändere das unter Agenten verbinden → Rechte und starte eine neue Sitzung in Claude Code – die Werkzeugliste lädt es beim Start.
„Zu viele Änderungen in kurzer Zeit“
WhyVault bremst eine Verbindung, die ungewöhnlich viel pro Minute schreibt. Bitte Claude Code, Notizen zusammenzufassen, statt viele kleine Änderungen zu schreiben.
Häufige Fragen
Ein Vault für alle Projekte?
Ja. Jedes Projekt bekommt einen eigenen Raum in 3_Rooms/, und Wissen, das überall gilt, liegt in 1_Knowledge/. Siehe die Struktur.
Kann Claude Code nur lesen?
Ja. Setz beim Anlegen des Schlüssels Nur lesen, oder ändere die Rechte später.
Macht das Claude Code langsamer?
Nein. Claude Code ruft die Werkzeuge nur auf, wenn es Kontext braucht, und WhyVault antwortet mit kurzen, gezielten Ergebnissen statt ganzer Ordner.
Und wenn ich Claude auch im Browser nutze?
Verbinde Claude als Custom Connector. Beide lesen und schreiben dieselben Notizen.
Weiter
Cursor
Trag WhyVault als Remote-MCP-Server in Cursor ein, damit es sich Entscheidungen und Kontext über Projekte hinweg merkt. In zwei Minuten eingerichtet.
Andere MCP-Clients
Verbinde jeden Client, der Remote-MCP-Server unterstützt: Endpoint, Streamable-HTTP-Transport, Anmeldung per OAuth 2.1 – alles, was ein Client braucht.