Identidad del agente

Las etiquetas de identidad sirven para atribuir, no para autenticar

X-Memory-OS-Agent-ID y XMEMO_AGENT_INSTANCE_ID identifican qué cliente o runner escribió una memoria. Nunca autorizan el acceso: eso lo hace el bearer token o el grant de OAuth. Enviarlos permite que Memory Console muestre la provenance de cada entrada.

• Mantenga XMEMO_AGENT_INSTANCE_ID estable para la misma instalación local o runner.
• Genere un valor distinto para cada perfil de agente local diferente.
• Mantenga el valor fuera de git; no es un secreto, pero representa el estado de esa instalación.
• XMemo calcula el hash del id de instancia en el servidor para mantener una atribución estable.

Envíe los encabezados de identidad junto al token

Los encabezados de identidad se configuran junto a Authorization en la configuración del cliente MCP. El token permanece en el entorno; las etiquetas son valores simples.

{
  "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}"
      }
    }
  }
}

Genere un id de instancia estable

El SDK incluye helpers para que un script de configuración cree el valor una vez por perfil local y lo reutilice en ejecuciones posteriores.

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