Para agentes de IA

Conecta ValorBrain como tu memoria

Esta página es la instrucción que un agente sigue por sí solo. Cuatro pasos: obtener el token, conectar el cliente MCP, verificar y avisar al humano.

Envía esto a tu agente (Claude, Codex, Gemini, Cursor…)

prompt

Conecta ValorBrain como tu memoria: lee https://valorbrain.com.br/connect.md y sigue las instrucciones.

1. Obtener el token

Sin cuenta: crea la cuenta de agente con un comando.

terminal

npx -y @valorbrain/cli@latest init --agent --agent-caller <nombre-del-agente> --json

La salida JSON trae mcp_token (vbm_…, para el MCP), mcp_url, api_key (vb_agent_…, solo para la API REST) y las instrucciones de claim. La CLI también lo guarda todo en su configuración.

Con cuenta: crea el token MCP en https://valorbrain.valor.digital/settings/mcp-tokens.

2. Conectar el cliente

Claude Code, Codex, Kiro, Gemini CLI y Cursor: un comando instala MCP, reglas de memoria y hooks; ejecútalo en la máquina de la CLI y reinicia la sesión. Los demás clientes usan el servidor MCP por HTTP con Bearer vbm_: https://mcpbrain.valor.digital/mcp. Elige tu cliente.

terminal

npx -y @valorbrain/connect@latest --token <vbm_…> --harness <claude-code|codex|kiro|gemini-cli|cursor>

Antes de instalar los hooks, avisa al humano

El prompt de cada turno de esta CLI va al workspace del humano en ValorBrain. Los hooks llaman a ValorBrain al inicio de la sesión (solo ids), en cada turno con el prompt (hasta 8.000 caracteres, para buscar la memoria relevante) y al final del turno (solo contadores, para el checkpoint de memoria). No se envía ninguna transcripción.

Después de la instalación, para dejar de enviar el prompt: npx -y @valorbrain/connect@latest --harness <id> --prompt off; para apagar el checkpoint: npx -y @valorbrain/connect@latest --harness <id> --checkpoint off. VALORBRAIN_SEND_PROMPT=off y VALORBRAIN_CHECKPOINT=off en el entorno de la CLI hacen lo mismo. En Gemini CLI también, salvo en un runner de GitHub: Gemini pasa su entorno a los hooks y solo lo filtra con security.environmentVariableRedaction.enabled (que quita nombres de secretos, no estas variables) o en un runner de GitHub (donde solo pasa una lista corta, así que allí solo valen las opciones guardadas). Las opciones guardadas valen siempre. Si el humano rechaza los hooks, usa el mismo comando con --mcp-only (MCP y reglas, nada enviado por turno; en una instalación que ya tiene hooks, quita solo esos) o configura el MCP a mano. npx -y @valorbrain/connect@latest --harness <id> --remove deshace todo: entrada del MCP, reglas, hooks y credenciales guardadas.

Qué sale de la máquina, por CLI (en inglés): https://docs.valorbrain.com.br/en/docs/concepts/what-leaves-your-machine

Claude Code

terminal

npx -y @valorbrain/connect@latest --token <vbm_…> --harness claude-code

Sin hooks (MCP y reglas, nada enviado por turno):

terminal

npx -y @valorbrain/connect@latest --token <vbm_…> --harness claude-code --mcp-only

O el MCP a mano:

terminal

claude mcp add --transport http --scope user valorbrain https://mcpbrain.valor.digital/mcp --header "Authorization: Bearer <vbm_…>"

Codex

terminal

npx -y @valorbrain/connect@latest --token <vbm_…> --harness codex

Sin hooks (MCP y reglas, nada enviado por turno):

terminal

npx -y @valorbrain/connect@latest --token <vbm_…> --harness codex --mcp-only

O el MCP a mano:

terminal

export VALORBRAIN_MCP_TOKEN=<vbm_…>codex mcp add valorbrain --url https://mcpbrain.valor.digital/mcp --bearer-token-env-var VALORBRAIN_MCP_TOKEN

Kiro

terminal

npx -y @valorbrain/connect@latest --token <vbm_…> --harness kiro

Sin hooks (MCP y reglas, nada enviado por turno):

terminal

npx -y @valorbrain/connect@latest --token <vbm_…> --harness kiro --mcp-only

O el MCP a mano:

~/.kiro/settings/mcp.json

{  "mcpServers": {    "valorbrain": {      "url": "https://mcpbrain.valor.digital/mcp",      "headers": {        "Authorization": "Bearer <vbm_…>"      }    }  }}

Gemini CLI

terminal

npx -y @valorbrain/connect@latest --token <vbm_…> --harness gemini-cli

Sin hooks (MCP y reglas, nada enviado por turno):

terminal

npx -y @valorbrain/connect@latest --token <vbm_…> --harness gemini-cli --mcp-only

O el MCP a mano:

~/.gemini/settings.json

{  "mcpServers": {    "valorbrain": {      "httpUrl": "https://mcpbrain.valor.digital/mcp",      "headers": {        "Authorization": "Bearer <vbm_…>"      }    }  }}

Cursor

terminal

npx -y @valorbrain/connect@latest --token <vbm_…> --harness cursor

Sin hooks (MCP y reglas, nada enviado por turno):

terminal

npx -y @valorbrain/connect@latest --token <vbm_…> --harness cursor --mcp-only

O el MCP a mano:

~/.cursor/mcp.json

{  "mcpServers": {    "valorbrain": {      "url": "https://mcpbrain.valor.digital/mcp",      "headers": {        "Authorization": "Bearer <vbm_…>"      }    }  }}

VS Code

.vscode/mcp.json

{  "servers": {    "valorbrain": {      "type": "http",      "url": "https://mcpbrain.valor.digital/mcp",      "headers": {        "Authorization": "Bearer <vbm_…>"      }    }  }}

claude.ai / Claude Desktop

Conectores → Añadir conector personalizado → URL del MCP: https://mcpbrain.valor.digital/mcp. La autorización es por OAuth, sin pegar token.

Cliente stdio

terminal

npx -y @valorbrain/cli mcp

Para cualquier cliente que solo habla stdio. Usa el token guardado por la CLI.

Instalación completa

terminal

npx -y @valorbrain/connect@latest --token <vbm_…>

Opcional: configura MCP, reglas de memoria y hooks en todos los agentes del equipo. Los hooks envían el prompt de cada turno al workspace: avisa al humano antes. Qué envía cada hook y cómo dejar de enviar el prompt (en inglés): https://docs.valorbrain.com.br/en/docs/concepts/what-leaves-your-machine

3. Verificar

Llama a la herramienta memory_prepare. Si responde con tu identidad y el workspace, la memoria está activa.

4. Avisar al humano

Dile a la persona que, para ver las memorias en la app y mantener la cuenta más allá de 30 días, debe ejecutar el comando de abajo (el código llega por correo).

terminal

npx -y @valorbrain/cli init --email <email>

Referencia

MCP (streamable HTTP): https://mcpbrain.valor.digital/mcp
API REST: https://valorbrain-api.valor.digital
App: https://valorbrain.valor.digital
Docs: https://docs.valorbrain.com.br
Sitio: https://valorbrain.com.br

Variables de entorno

VALORBRAIN_MCP_TOKEN: token vbm_ (MCP)
VALORBRAIN_API_KEY: clave vb_agent_ o vb_ (REST)
VALORBRAIN_API_URL: https://valorbrain-api.valor.digital
VALORBRAIN_MCP_URL: https://mcpbrain.valor.digital/mcp
VALORBRAIN_TOKEN: heredada, aceptada con aviso: vbm_ va al MCP, el resto a la REST

El MCP solo acepta vbm_. Una clave vb_ o fk_ en el MCP devuelve 401 wrong_credential_type. La api_key y el mcp_token valen antes y después del claim.

Los conectores de fuentes (Google Drive, Notion, Slack…) están en la app: https://valorbrain.valor.digital/connectors.

Documentación completa: https://docs.valorbrain.com.br.