MCP 概要

XMemo を AI 環境に接続する

XMemo は、Claude、ChatGPT、Codex、GitHub Copilot、OpenClaw、Hermes、DeepSeek Harness、Microsoft Agent Framework、およびオープンな AI エージェントランタイムに永続的なプロジェクトメモリを提供します。クライアントは、ホストされた Streamable HTTP エンドポイントに直接接続するか、@xmemo/client に同梱されたファーストパーティの xmemo-mcp stdio プロキシを介して接続します。

• claude.ai の Claude と Claude Desktop (Axis A: Config supported; Evidence required for current client proof · Axis B: Manual MCP Configuration; Directory listing pending): カスタムコネクタとして https://xmemo.dev/mcp に OAuth で接続します。コネクタに API key は不要です (/docs/mcp/claude)。
• Claude (Axis A: Config supported; Evidence required for current client proof · Axis B: Manual MCP Configuration): Claude Code および Cowork 向けのメモリワークフロー、ライフサイクルチェックポイント、クロスエージェント連続性 (/docs/mcp/claude-code)。
• ChatGPT (Axis A: Hosted beta pilot; Evidence required for any refreshed external claim · Axis B: Manual MCP Configuration; Marketplace pending): メモリワークフローとインタラクティブワークスペース (TODO Board, Ledger, Project Workspace) (/docs/mcp/chatgpt)。
• Codex (Axis A: Config supported; Evidence required · Axis B: Manual MCP Configuration): Skill 主導のプロジェクトメモリと MCP 認可 (/docs/mcp/codex)。
• OpenClaw (Axis A: Released; Pilot tested · Axis B: Official Marketplace, Native Integration): Recall 優先のスキルガイダンスと ClawHub 上のネイティブ OpenClaw メモリプラグイン (/docs/connect/openclaw)。
• Hermes (Axis A: Released; Pilot tested · Axis B: Native Integration): セッションチェックポイントと自動キャプチャを備えた PyPI 上のネイティブ Hermes メモリプラグイン (hermes-xmemo) (/docs/connect/hermes)。
• DeepSeek Harness (Axis A: Released; Pilot tested · Axis B: Native Integration): CLI 実行ループメモリ用の npm 上のネイティブ dsh エージェントハーネスプラグイン (dsh-xmemo) (/docs/connect/deepseek-harness)。
• Microsoft Agent Framework（提供状況：計画中、パッケージ公開待ち · 統合方式：ネイティブ統合）：Python のコンテキスト取得とオプトイン式キャプチャを提供する独立したコミュニティ統合です。Microsoft の公式製品または配布物ではありません（/docs/connect/microsoft-agent-framework）。
• GitHub Copilot & VS Code (Axis A: Config supported; Evidence required for current client proof · Axis B: Manual MCP Configuration): IDE および CLI エージェント向けの MCP 統合 (/docs/mcp/copilot)。
• Gemini CLI (Axis A: Config supported; Evidence required for current client proof · Axis B: Manual MCP Configuration): settings.json に Bearer 認証情報を配置しない OAuth 優先の設定。

2つの直交する配信軸：提供状況と配布モード

クライアント統合は2つの独立した軸に沿って分類されます。Axis A は実証済みの準備状況と提供ステータス（Released、Pilot / Entitled、または Planned）を表し、Axis B は統合および配布モード（Official Marketplace、Community Directory、Native Integration、または Manual MCP Configuration）を定義します。配信チャネルによって提供状況が決まることはなく、ロードマップ上の機能は本番ランタイムと厳格に区別されます。

• Axis A (Availability / Evidence Status): Released（本番環境で完全に稼働中）、Pilot / Entitled（ホスト型ベータパイロットまたは商業的権利が必要）、Planned（明示的な将来展望の開示が必要なロードマップ項目）。
• Axis B (Integration / Distribution Mode): Official Marketplace（ClawHub 公式スキルなどベンダー審査済みリスト）、Community Directory（サードパーティ製インデックスリスト）、Native Integration（組み込みランタイムサポート）、Manual MCP Configuration（ユーザー構成の JSON スニペット）。

4つの統合接続パス

クライアントのアーキテクチャと運用モデルに一致する接続パスを選択してください：

• パス 1 (エージェントに依頼する — スタンドアロン Skill): 互換性のあるエージェント (Claude Code, Codex) 向け。https://xmemo.dev/skill/install 経由でクライアントの skills ディレクトリに検証済みの Skill をインストールします。
• パス 2 (OAuth 経由のホスト型 MCP): デスクトップおよびホスト型クライアント (ChatGPT, claude.ai と Claude Desktop の Claude カスタムコネクタ, Cursor, VS Code Copilot) 向け。手動でトークンを処理することなく https://xmemo.dev/mcp に接続します。
• パス 3 (XMEMO_KEY を使用した直接 MCP): ヘッドレスランナーおよび CI 環境向け。Streamable HTTP 経由でローカル環境変数を通じて Bearer トークンを安全に渡します。
• パス 4 (ファーストパーティ stdio プロキシ — xmemo-mcp): stdio 専用デスクトップクライアント、カスタムコネクタを使わない Claude Desktop の構成、または直接の Streamable HTTP サポートがないツール向け。公式 @xmemo/client CLI パッケージは、ホストされたサービス (https://xmemo.dev) にブリッジする自己完結型のローカル stdio プロキシとして xmemo-mcp (npx -y -p @xmemo/client xmemo-mcp または xmemo mcp serve 経由で実行可能) を提供します。

OAuth clientの設定

ホストされた URL が設定のすべてです。許可によってスコープが提供されます。

{
  "servers": {
    "XMemo": {
      "type": "http",
      "url": "https://xmemo.dev/mcp"
    }
  }
}

Direct tokenの設定

OAuth を完了できないヘッドレスランナーは、代わりに環境からトークンを読み取ります。

{
  "mcpServers": {
    "XMemo": {
      "type": "http",
      "transport": "streamable-http",
      "url": "https://xmemo.dev/mcp",
      "headers": {
        "Authorization": "Bearer ${XMEMO_KEY}",
        "X-Memory-OS-Agent-ID": "${XMEMO_AGENT_ID}",
        "X-Memory-OS-Agent-Instance-ID": "${XMEMO_AGENT_INSTANCE_ID}"
      }
    }
  }
}

ファーストパーティ stdio プロキシ設定 (xmemo-mcp)

Claude Desktop では、まずカスタムコネクタと OAuth (/docs/mcp/claude) を使ってください。この API key 構成は代替手段です。stdio 専用クライアントの場合、公式 @xmemo/client CLI パッケージは https://xmemo.dev にブリッジする自己完結型ローカル stdio プロキシとして xmemo-mcp を提供します。実際の API key を貼り付けてください。Claude Desktop は ${env:...} 変数を展開しません：

{
  "mcpServers": {
    "XMemo": {
      "command": "npx",
      "args": [
        "-y",
        "-p",
        "@xmemo/client",
        "xmemo-mcp"
      ],
      "env": {
        "XMEMO_KEY": "<your-xmemo-api-key>",
        "XMEMO_URL": "https://xmemo.dev"
      }
    }
  }
}

プロファイル修飾ツールサーフェス

利用可能なツールは、config/mcp-documentation-contract.json のクライアント機能に従ってプロファイル修飾されます：

• Cursor プロファイル (cursor-plugin): 競合解決、スナップショット、および Cloud Skills 用のツールを提供します。
• ChatGPT プロファイル (chatgpt-public): インタラクティブワークスペース (TODO Board, Ledger, Project Workspace) 用のツールを提供します。
• Claude パブリックプロファイル (claude-public): プロジェクトメモリ、台帳サマリー、およびアクティブリコールのためのツールを提供します。
• Claude プラグインプロファイル (claude-plugin): スナップショット、決定記録、およびプロジェクト継続性のためのツールを提供します。
• 汎用パブリックプロファイル (generic-public): 標準 MCP クライアント向けのツールを提供します。

統合候補と未検証の配布

XMemo は、検証された証拠を通じて新しいクライアント統合やエディタ拡張機能を追跡します。以下の候補パスは未検証であるかメンテナーのレビュー待ちであり、マーケットプレイスでの入手可能性や公式の推奨を主張するものではありません：

• VS Code ネイティブ拡張機能 (xmemo-vscode): ソースリポジトリ (yonro/xmemo-vscode @ bf08e7c237, v0.1.1) と CI ワークフローは存在しますが、Visual Studio Marketplace への公開は未確認であり、Open VSX は 404 を返しました。ユーザーは未検証の拡張機能パッケージではなく、検証済みのホスト型 MCP または Copilot Chat 設定 (/docs/mcp/copilot) を介して VS Code を接続する必要があります。
• Cindy Ghost Plugin (xmemo-cindy-plugin): Ghost プラグイン候補 (yonro/xmemo-cindy-plugin @ 0cbbac5a53, v1.0.0) はメンテナーのレビュー待ちであり、公開された GitHub Releases や検証済みの配布チャネルは確認されていません。
• Shared Skills Package (@xmemo/skills): リポジトリのソースは存在しますが、公開 npm 検索で 404 が返されました。代わりに検証済みのスタンドアロン Skill (@xmemo/skill) を使用してください。

Runnerに自分で設定させる

自律型ランナーは、人間に ID 値の入力を求める代わりに、独自のプリセットを取得できます。

curl -s https://xmemo.dev/api/v1/mcp/config/autonomous-agent