Agentenidentität

Identitätsbezeichnungen dienen der Zuordnung, nicht der Authentifizierung

X-Memory-OS-Agent-ID und XMEMO_AGENT_INSTANCE_ID identifizieren den Client oder Runner, der eine Erinnerung geschrieben hat. Sie autorisieren niemals den Zugriff — dies ist Aufgabe des Bearer-Tokens oder der OAuth-Autorisierung. Ihre Übermittlung ermöglicht es der Memory Console, die Herkunft jedes Eintrags anzuzeigen.

• Behalten Sie eine stabile XMEMO_AGENT_INSTANCE_ID für dieselbe lokale Installation oder denselben Runner bei.
• Generieren Sie einen anderen Wert für ein separates lokales Agentenprofil.
• Halten Sie den Wert außerhalb von git; es handelt sich nicht um ein Geheimnis, sondern um einen installationsspezifischen Zustand.
• XMemo hasht die Instanz-ID serverseitig, um eine stabile Zuordnung zu gewährleisten.

Identitäts-Header zusammen mit dem Token übergeben

Identitäts-Header werden neben Authorization in der MCP-Client-Konfiguration platziert. Das Token verbleibt in der Umgebung; die Bezeichnungen sind Klartextwerte.

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

Eine stabile Instanz-ID generieren

Das SDK stellt Hilfsprogramme bereit, sodass ein Initialisierungsskript den Wert einmalig pro lokalem Profil erstellen und bei späteren Ausführungen wiederverwenden kann.

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