Muse Code

前提条件

~/.config/muse/settings.json から MCP サーバーを読み込む Muse Code のインストールを使用します。Muse Code は OAuth クライアントとして XMemo に接続するため、設定ファイルにトークンは含まれません。

• エンドポイント: https://xmemo.dev/mcp。
• 認証モード: 動的クライアント登録を使用する OAuth（ブラウザ PKCE）。
• 設定ファイル: ~/.config/muse/settings.json。"schema_version": 1 を含める必要があります。
• 付与されるスコープ: memory:read、memory:write、knowledge:read、knowledge:write。
• 自動セットアップ: xmemo setup muse-code は次回の XMemo CLI リリースで提供予定です。それまでは、以下の手動設定を使用してください。

settings.json に XMemo を追加する

~/.config/muse/settings.json は Muse の外部のターミナルから編集してください。Muse のサンドボックスは、Muse セッション内で行われたこのファイルへの編集を拒否します。トップレベルの camelCase キー mcpServers の下に xmemo エントリを追加します。このファイルにはトークンや Authorization ヘッダーを記述しないでください。

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

mcpServers のみを残す

Muse の公開 Web ドキュメントには今も snake_case の mcp_servers キーが記載されていますが、これは古い情報です。settings.json に mcpServers と mcp_servers の両方が含まれていると、Muse はすべての MCP サーバーを破棄します。既存の mcp_servers ブロックの名前を mcpServers に変更してそのエントリを統合し、ファイルには mcpServers のみが残るようにしてください。

OAuth でサインインする

xmemo サーバーのログインコマンドを実行し、ブラウザでアクセスを承認します。ブラウザ UI のないマシンでは、--headless を追加します。

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

クライアントを再起動する

サインイン後に Muse を再起動して、新しい OAuth グラントで xmemo サーバーを読み込めるようにします。

XMemo ツールを確認する

どのツールも呼び出さずに、XMemo ツールの一覧を表示するよう Muse に依頼します。

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

実際の recall 呼び出しでテストする

最初の MCP 呼び出しは読み取り専用にします。これはヘルスチェック用のプレースホルダーではなく実際のリコール呼び出しであり、メモリへの書き込みは行いません。

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

期待される応答（リテラル形式）

成功した呼び出しは、以下の公開されたランク付けされたテキスト形式を返します。参照とコンテンツは、承認されたメモリ空間からの実際の値です。

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

XMemo Skill

Muse は ~/.agents/skills、~/.claude/skills、~/.codex/skills をスキャンするため、Claude Code または Codex 用にすでにインストールされている XMemo Skill は、変更なしで Muse でも動作します。

よくあるエラー

Muse Code は OAuth 経由で接続します。ほとんどのエラーは、設定キー、サインイン手順、またはサンドボックスに起因します。

• xmemo ツールが一覧に表示されない: settings.json に mcpServers と mcp_servers の両方が含まれているため、Muse がすべての MCP サーバーを破棄しました。mcpServers のみを残してください。
• invalid_grant: 認可が無効、期限切れ、または使用済みであるか、選択した接続が有効ではなくなっています。muse mcp login xmemo を再度実行してから、Muse を再起動してください。
• 403 insufficient_scope: 承認されたスコープではこの呼び出しをカバーできません。再度サインインして、memory スコープと knowledge スコープを承認してください。
• settings.json への編集が拒否される: 変更が Muse セッション内で行われました。外部のターミナルからファイルを編集してください。