Identidade do agente

Rótulos de identidade são atribuição, não autenticação

X-Memory-OS-Agent-ID e XMEMO_AGENT_INSTANCE_ID identificam qual cliente ou executor gravou uma memória. Eles nunca autorizam acesso — o token bearer ou a concessão OAuth fazem isso. Enviá-los permite que o Memory Console mostre a proveniência de cada entrada.

• Mantenha XMEMO_AGENT_INSTANCE_ID estável para a mesma instalação local ou executor.
• Gere um valor diferente para outro perfil de agente local.
• Mantenha o valor fora do git; ele não é secreto, mas representa o estado de uma instalação.
• O XMemo aplica hash ao ID da instância no servidor para atribuição estável.

Envie os cabeçalhos de identidade junto com o token

Os cabeçalhos de identidade ficam ao lado de Authorization na configuração do cliente MCP. O token permanece no ambiente; os rótulos são 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}"
      }
    }
  }
}

Gere um ID de instância estável

O SDK fornece auxiliares para que um script de configuração crie o valor uma vez por perfil local e o reutilize nas execuções seguintes.

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