Identité de l'agent

Les libellés d'identité relèvent de l'attribution, pas de l'authentification

X-Memory-OS-Agent-ID et XMEMO_AGENT_INSTANCE_ID identifient le client ou l'exécuteur qui a écrit une mémoire. Ils n'autorisent jamais l'accès — c'est le rôle du jeton porteur ou de l'autorisation OAuth. Leur transmission permet à la Memory Console d'afficher la provenance de chaque entrée.

• Conservez un XMEMO_AGENT_INSTANCE_ID stable pour une même installation locale ou un même exécuteur.
• Générez une valeur différente pour un profil d'agent local distinct.
• Conservez la valeur hors de git ; il ne s'agit pas d'un secret, mais d'un état propre à chaque installation.
• XMemo hache l'identifiant d'instance côté serveur pour assurer une attribution stable.

Transmettre les en-têtes d'identité aux côtés du jeton

Les en-têtes d'identité se placent à côté de Authorization dans la configuration du client MCP. Le jeton reste dans l'environnement ; les libellés sont des valeurs en texte brut.

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

Générer un identifiant d'instance stable

Le SDK fournit des utilitaires afin qu'un script d'initialisation puisse créer la valeur une seule fois par profil local et la réutiliser lors des exécutions ultérieures.

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