接続接続Claude (claude.ai)

MCP Client

Claude (claude.ai)

claude.ai の Claude をカスタムコネクタとして、OAuth と memory:read および memory:write スコープでホスト型 Streamable HTTP MCP エンドポイントに接続します。

前提条件

カスタムコネクタに対応した Claude と、有効な XMemo アカウントを使用します。接続情報：

  • インターフェース: Web 版 Claude (claude.ai)。カスタムコネクタで接続します。
  • 接続 URL: https://xmemo.dev/mcp。
  • トランスポート: Streamable HTTP (streamable-http)。
  • 認証モード: PKCE と Dynamic Client Registration (動的クライアント登録) を使う OAuth 2.0 認可コードフロー。
  • スコープ: memory:read および memory:write。
  • アカウント: https://xmemo.dev の有効な XMemo アカウント。

XMemo をカスタムコネクタとして追加する

Claude でホスト型 MCP サーバーを追加します。サーバー設定は接続 URL だけです：

  • 1. Claude で Customize > Connectors を開き、Add custom connector を選択します。直接リンク: https://claude.ai/customize/connectors?modal=add-custom-connector。
  • 2. 名前: XMemo。
  • 3. リモート MCP サーバー URL: https://xmemo.dev/mcp。
  • 4. コネクタを追加し、Connect をクリックして OAuth を開始します。

OAuth でアクセスを承認する

Claude は Dynamic Client Registration で自身を OAuth クライアントとして登録し、ブラウザで XMemo の認可ページを開きます。サインインし、同意画面で memory:read と memory:write を承認してください。Claude はこの OAuth グラントから認証情報を受け取ります。

ベアラートークンを追加しない

カスタムコネクタに API key は不要です。XMemo の API key、XMEMO_KEY、ベアラートークンをコネクタに入力しないでください。認証情報とそのスコープは OAuth グラントが提供します。

会話で XMemo を有効にする

Claude に戻り、会話で XMemo を有効にします。その後 Claude は、タイトルと安全性アノテーション付きの XMemo ツールを検出します。

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

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

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

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

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

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

Claude で使えるツール

claude-public プロファイルでは、Claude に 27 個のツールが表示されます。以下では安全性アノテーションごとに分類しています。読み取りツールはデータを変更せず、書き込みツールはレコードを追加、完了、または復元し、破壊的ツールは既存のレコードを上書き、変更、削除する可能性があります。専用のリファレンスページがあるツールにはリンクを付けています。それ以外のツールはこのページでのみ説明しています。

読み取りツール

読み取り専用かつ冪等で、保存済みデータを変更しません：

  • get_mcp_identity (Check XMemo connection): 認証済みのコネクタ ID と付与されたメモリスコープを返します。
  • [search_memory](/docs/tools/search) (Search XMemo memories): 表示可能なスコープ付きメモリまたはチームメモリのレコードを検索します。
  • [recall](/docs/tools/recall) (Recall XMemo memory): 最も関連性の高い表示可能なメモリを取得します。
  • [recall_context](/docs/tools/recall-context) (Build XMemo context): 表示可能なメモリから範囲を限定したコンテキストパックを構築します。
  • memory_overview (Show XMemo memory overview): 表示可能なメモリと最近のアクティビティを要約します。
  • memory_stats (Show XMemo memory statistics): 表示可能なメモリの集計統計を返します。
  • memory_activity (Show XMemo memory activity): 生の監査ログを公開せずに、自分のメモリ変更の安全なタイムラインを表示します。
  • analyze_memory_text (Analyze XMemo memory text): 表示可能なメモリ全体で単語または完全一致フレーズの出現数を数えます。
  • explain_memory (Explain XMemo memory): 表示可能なメモリが存在する理由、またはクエリに一致した理由を説明します。
  • list_memory_todos (List XMemo memory TODOs): メモリに基づく TODO とアクションアイテムを一覧表示します。Claude はこのツールで TODO を読み取ります。
  • list_ledger_transactions (List XMemo Ledger transactions): 表示可能な Ledger レコードを一覧表示します。
  • get_monthly_ledger_summary (Summarize XMemo Ledger by month): 表示可能な Ledger レコードを月ごとに要約します。
  • read_memory (Read Memory): recall または検索が返した参照を使い、特定のメモリ 1 件、または承認済み Document の範囲を限定したページを読み取ります。
  • get_project_context (Get project context): 自分が所有またはアクセスできるプロジェクト 1 件の承認済みコンテキストを読み取ります。

書き込みツール

これらのツールはレコードを追加、完了、または復元し、破壊的としてマークされていません：

  • add_expense (Record an XMemo Ledger transaction): 構造化された Ledger レコードを 1 件作成します。
  • complete_memory_todo (Complete XMemo memory TODO): 既存のメモリベースの TODO またはアクションアイテムを完了済みにします。
  • create_memory_todo (Create XMemo memory TODO): メモリベースの TODO またはアクションアイテムを作成します。
  • [remember](/docs/tools/remember) (Remember in XMemo): スコープ付きメモリを作成または重複排除します。
  • restore_memory (Restore XMemo memory): forget のデフォルトのソフト削除モードで削除されたレコードを復元します。
  • record_event (Record a milestone): マイルストーンまたは引き継ぎイベントを 1 件追加します。既存のレコードを編集または削除することはありません。
  • create_pending_decision (Save a pending decision): 未解決の決定 1 件を、そのコンテキストと選択肢とともに後で確認できるよう保存します。
  • resolve_decision (Resolve a pending decision): 特定の保留中の決定について選ばれた結果を記録し、履歴を残したまま決定をクローズします。

破壊的ツール

これらのツールは既存のレコードを上書き、変更、削除する可能性があるため、破壊的としてマークされています：

  • [forget](/docs/tools/forget) (Forget XMemo memory, TODO, or Ledger transaction): 選択したメモリ、TODO、または Ledger レコードを 1 件削除します。下の「削除と復元」を参照してください。
  • update_memory (Update XMemo memory): 正確な参照で選択したメモリ 1 件のフィールドを上書きします。
  • update_state (Save working state): 名前付きの作業状態チェックポイントを 1 件保存または置き換え、後の会話で再開できるようにします。
  • [todo](/docs/tools/todos) (Manage XMemo TODOs): 自分の TODO を作成、更新、または完了します。下の「Claude での TODO」を参照してください。
  • project (Manage XMemo project): プロジェクトを作成するか、承認済みプロジェクトのメモリ、決定、ドキュメントと会話のリンク、または設定を変更します。

削除と復元

明示的に完全削除を求めない限り、forget による削除は復元できます：

  • デフォルト: forget は復元可能なソフト削除を行います。
  • 取り消し: restore_memory はソフト削除されたレコードを復元します。
  • 完全削除: mode='hard' を指定した forget は永続的で、元に戻せません。ユーザーの明示的な確認が必要で、ハード削除されたレコードは復元できません。

Claude での TODO

Claude では、todo ツールは TODO の作成、更新、完了だけを行います。Claude は list_memory_todos で TODO を読み取ります。todo のリファレンスページはディスパッチャー全体を説明していますが、Claude ではこの 3 つの操作にのみ使用してください。

Claude Desktop

Claude Desktop でも、同じカスタムコネクタと OAuth フローから始めてください。API key を使うローカル構成は代替手段として残ります：

  • 推奨: XMemo を https://xmemo.dev/mcp のカスタムコネクタとして追加し、OAuth を完了します。API key は不要です。
  • 代替: claude_desktop_config.json で、ファーストパーティの xmemo-mcp stdio プロキシまたは mcp-remote を XMemo の API key とともに構成します。stdio プロキシの構成は [MCP 概要](/docs/mcp/overview) を参照してください。

Claude Code

Claude Code は別のセットアップを使用します。スタンドアロン Skill と直接 MCP 構成については [Claude Code](/docs/mcp/claude-code) を参照してください。

よくあるエラー

OAuth の失敗は、実際のトークンエンドポイント応答に対応します：

  • invalid_grant — 認可コードが無効、期限切れ、または使用済みです: Claude で XMemo を再接続し、もう一度認可してください。
  • invalid_target — OAuth リソースがこの MCP サーバーと一致しません: コネクタを削除し、https://xmemo.dev/mcp で追加し直してください。
  • 403 insufficient_scope — グラントに memory:read または memory:write が含まれていません: 両方のスコープを承認して再接続してください。

更新と削除

Claude コネクタのメンテナンス手順：

  • 再接続: Claude に XMemo の認可または再接続のメッセージが表示された場合は、コネクタを再接続し、もう一度 OAuth を完了してください。
  • 削除: Claude のコネクタ設定から XMemo カスタムコネクタを削除します。

出典: クライアント機能マトリクス