Agent 身份

Identity label 是归属信息，不是 authentication

X-Memory-OS-Agent-ID 和 XMEMO_AGENT_INSTANCE_ID 用来标识哪个 client 或 runner 写入了 memory。它们不会授权 access——bearer token 或 OAuth grant 才会授权。发送这些值后，Memory Console 可以显示每条记录的 provenance。

• 同一个 local install 或 runner 始终保持 XMEMO_AGENT_INSTANCE_ID 稳定。
• 不同的 local agent profile 使用不同的值。
• 不要把这个值放进 git；它不是 secret，但属于每次安装的状态。
• XMemo 在 server-side 对 instance id 做 hash，以保持稳定归属。

将 identity header 与 token 一起发送

在 MCP client configuration 中，identity header 与 Authorization 并列。Token 保存在 environment 中，label 是普通值。

{
  "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 创建一次该值，并在之后的运行中复用。

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 });