利用を開始ガイド移行

Guide

移行

legacyまたはdirect-client setupから移行し、scope、identity、削除の境界を維持します。

direct-token clientからOAuthへ移行する

clientがOAuthに対応している場合、切り替えによってlocal configurationに保存されたbearer tokenを削除できます。Memory、scope、attributionは変わらず、credential pathだけが移動します。

  • XMEMO_KEYを削除する前に、clientがOAuth対応と表示されることを確認します。
  • 再接続してmemory:readとmemory:writeを承認します。
  • 何かを書き込む前に、無害なrecallを実行します。
  • 古いconfiguration fileと環境からtokenを削除します。

移行前: direct token configuration

{
  "mcpServers": {
    "XMemo": {
      "type": "http",
      "url": "https://xmemo.dev/mcp",
      "headers": { "Authorization": "Bearer ${env:XMEMO_KEY}" }
    }
  }
}

移行後: OAuth configuration

Hosted server URLだけが残り、grantがscopeを提供します。

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

移行を確認する

先にreadを行うことで、壊れたcredentialを保存済みmemoryを変更せずに検出できます。

await client.recallContext('current task and recent decisions', {
  preferWorking: true,
});

出典: Hosted quickstart