エージェントのアイデンティティ

アイデンティティのラベルは帰属情報であり、認証ではありません

X-Memory-OS-Agent-IDとXMEMO_AGENT_INSTANCE_IDは、どのclientまたはrunnerがメモリを書き込んだかを識別します。これらがアクセスを認可することはありません。認可を行うのはbearer tokenまたはOAuth grantです。送信すると、Memory Consoleで各エントリのprovenanceを表示できます。

• 同じローカルインストールまたはrunnerでは、XMEMO_AGENT_INSTANCE_IDを安定して保ちます。
• 異なるローカルagent profileには、別の値を生成します。
• 値をgitに入れないでください。秘密ではありませんが、インストールごとの状態です。
• XMemoは安定した帰属のため、instance idをサーバー側でハッシュします。

tokenと一緒にアイデンティティヘッダーを送信する

アイデンティティヘッダーは、MCP client configurationでAuthorizationの隣に置きます。tokenはenvironmentに保持し、ラベルは通常の値として指定します。

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

安定したinstance idを生成する

SDKにはhelperが用意されているため、setup scriptでlocal profileごとに値を1度作成し、後続の実行で再利用できます。

import {
  XMEMO_AGENT_ID_ENV_VAR,
  XMEMO_AGENT_INSTANCE_ID_ENV_VAR,
  buildMcpIdentityHeaders,
  createAgentInstanceId,
} from '@xmemo/client';

const agentId = 'gemini-cli';
const agentInstanceId = existingStoredValue ?? createAgentInstanceId('gemini-cli');
const headers = buildMcpIdentityHeaders({ agentId, agentInstanceId });