에이전트 신원

신원 라벨은 귀속 정보이지 인증 수단이 아닙니다

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 구성에서 Authorization 옆에 놓입니다. token은 환경 변수에 두고 라벨은 일반 값으로 둡니다.

{
  "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에는 설정 스크립트가 로컬 profile마다 한 번 값을 만들고 이후 실행에서 재사용할 수 있도록 도와주는 helper가 포함되어 있습니다.

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