Muse Code

Voraussetzung

Verwenden Sie eine Muse Code-Installation, die MCP-Server aus ~/.config/muse/settings.json liest. Muse Code verbindet sich als OAuth-Client mit XMemo, daher enthält die Konfigurationsdatei kein Token.

• Endpunkt: https://xmemo.dev/mcp.
• Authentifizierungsmodus: OAuth (Browser-PKCE) mit dynamischer Client-Registrierung.
• Konfigurationsdatei: ~/.config/muse/settings.json. Sie muss "schema_version": 1 enthalten.
• Gewährte Scopes: memory:read, memory:write, knowledge:read und knowledge:write.
• Automatisierte Einrichtung: xmemo setup muse-code folgt in Kürze mit dem nächsten Release der XMemo CLI. Verwenden Sie bis dahin die manuelle Konfiguration unten.

XMemo zu settings.json hinzufügen

Bearbeiten Sie ~/.config/muse/settings.json in einem Terminal außerhalb von Muse; die Sandbox von Muse lehnt Änderungen an dieser Datei ab, die innerhalb einer Muse-Sitzung vorgenommen werden. Fügen Sie unter dem camelCase-Schlüssel mcpServers auf oberster Ebene einen xmemo-Eintrag hinzu. Token oder Authorization-Header gehören nicht in diese Datei.

{"schema_version": 1, "mcpServers": {"xmemo": {"type": "streamable-http", "url": "https://xmemo.dev/mcp", "mode": "optional"}}}

Nur mcpServers beibehalten

Die öffentliche Web-Dokumentation von Muse zeigt noch einen snake_case-Schlüssel mcp_servers; diese Angabe ist veraltet. Wenn settings.json sowohl mcpServers als auch mcp_servers enthält, verwirft Muse alle MCP-Server. Benennen Sie einen vorhandenen mcp_servers-Block in mcpServers um und führen Sie seine Einträge dort zusammen, sodass die Datei nur mcpServers enthält.

Mit OAuth anmelden

Führen Sie den Anmeldebefehl für den xmemo-Server aus und genehmigen Sie den Zugriff im Browser. Fügen Sie auf einem Rechner ohne Browser-Oberfläche --headless hinzu.

muse mcp login xmemo
# Without a browser UI:
muse mcp login xmemo --headless

Client neu starten

Starten Sie Muse nach der Anmeldung neu, damit der xmemo-Server mit der neuen OAuth-Berechtigung geladen wird.

XMemo-Tools überprüfen

Bitten Sie Muse, die XMemo-Tools aufzulisten, ohne eines davon aufzurufen.

muse exec "List the names of the tools you have from the xmemo MCP server. Do not call any tools."

Mit einem echten recall-Aufruf testen

Führen Sie den ersten MCP-Aufruf rein lesend aus. Dies ist ein tatsächlicher recall-Aufruf, kein Platzhalter für eine Statusprüfung, und er schreibt keine Daten in den Speicher.

recall({ query: "connection check", limit: 1 })

Erwartete Antwort (wörtliche Struktur)

Ein erfolgreicher Aufruf gibt die unten dargestellte öffentliche strukturierte Textform zurück; Referenz und Inhalt sind echte Werte aus dem autorisierten Speicherbereich.

### XMemo Memory Results:
1. Reference: <opaque-memory-id> | Location: <location>
   > <memory content>

XMemo Skill

Muse durchsucht ~/.agents/skills, ~/.claude/skills und ~/.codex/skills, sodass ein bereits für Claude Code oder Codex installierter XMemo Skill ohne Änderungen in Muse funktioniert.

Häufige Fehler

Muse Code verbindet sich über OAuth; die meisten Fehler entstehen durch den Konfigurationsschlüssel, den Anmeldeschritt oder die Sandbox.

• Es werden keine xmemo-Tools aufgelistet: settings.json enthält sowohl mcpServers als auch mcp_servers, daher hat Muse alle MCP-Server verworfen. Behalten Sie nur mcpServers bei.
• invalid_grant: Die Autorisierung ist ungültig, abgelaufen oder wurde bereits verwendet, oder die ausgewählte Verbindung ist nicht mehr gültig. Führen Sie muse mcp login xmemo erneut aus und starten Sie Muse anschließend neu.
• 403 insufficient_scope: Die genehmigten Scopes decken den Aufruf nicht ab. Melden Sie sich erneut an und genehmigen Sie die memory- und knowledge-Scopes.
• Änderungen an settings.json werden abgelehnt: Die Änderung wurde innerhalb einer Muse-Sitzung vorgenommen. Bearbeiten Sie die Datei in einem externen Terminal.