Ir al contenido

Para desarrolladores

Documentación para construir con ValorBrain

El camino más corto para conectar un agente: MCP con bearer token, API REST con contrato OpenAPI y la capa agent-ready de este dominio. Solo entró en esta página lo que está publicado y funcionando.

Empieza por aquí

Conecta todos tus agentes con un comando

Pégalo en una terminal de la computadora donde usas Claude Code, Codex, Cursor, Gemini CLI, Kiro, OpenCode o Hermes. Encuentra los agentes, abre el navegador para que autorices la computadora y configura MCP, las reglas de memoria y los hooks en cada uno, con un token propio por agente.

terminal
# macOS / Linuxcurl -fsSL https://valorbrain.valor.digital/install.sh | sh# Windows (PowerShell)irm https://valorbrain.valor.digital/install.ps1 | iex# Ya tienes Node.jsnpx -y @valorbrain/connect@0.9
  1. Pégalo en la terminal
  2. Autoriza la computadora en el navegador
  3. Reinicia tus agentes: la memoria está activa
Crear una cuenta gratis

¿Aún sin cuenta? La creas en la misma pantalla de autorización. En Windows sin Node.js, el script ofrece instalar la versión LTS con winget. Los hooks envían el prompt de cada turno a tu workspace para buscar la memoria; sin hooks: --mcp-only (Hermes no tiene hooks: su plugin de memoria sigue enviando el prompt; allí usa --prompt off); --remove deshace todo. Qué sale de la máquina y cómo apagarlo, en inglés: https://docs.valorbrain.com.br/en/docs/concepts/what-leaves-your-machine

O configúralo a mano

Conecta tu agente por MCP

Elige tu cliente, pega el token vbm_ y llama a memory_prepare para comprobar la conexión. Sin cuenta, el agente crea la suya con un comando; el paso a paso completo, que puedes enviar directo al agente, está en /connect.

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_…>"
.well-known/mcp.json
{  "mcpServers": {    "valorbrain": {      "type": "http",      "url": "https://mcpbrain.valor.digital/mcp",      "headers": {        "Authorization": "Bearer <vbm_…>"      },      "description": "ValorBrain shared company memory for AI agents: retrieve, store, handoffs, audit. The MCP accepts only vbm_ tokens. No account: npx -y @valorbrain/cli@latest init --agent --agent-caller <agent-name> --json returns mcp_token. With an account: https://valorbrain.valor.digital/settings/mcp-tokens.",      "docs": "https://valorbrain.com.br/connect.md"    }  }}

API REST

API REST con contrato abierto

La API pública del SaaS responde en esta base y el contrato completo es OpenAPI 3.1. La referencia navegable queda dentro del app, detrás del login del workspace.

Base URL

https://valorbrain-api.valor.digital

Especificación OpenAPI
openapi.json
Referencia navegable (login del workspace)
api-docs
Catálogo de servicios de la API
api-catalog

Autenticación

Bearer token en el header Authorization. El MCP acepta solo el token vbm_; la API REST usa la clave vb_agent_ (cuenta de agente) o vb_. El auth.md documenta cada caso, incluidos OAuth y device flow para clientes headless.

Leer el auth.md

Primer paso

El sandbox es el producto

No hay entorno de prueba separado: lo pruebas en tu propio workspace, con un proyecto real y los agentes que ya usas. Un proyecto free para probarlo en tu flujo real; los escalones pagos tienen precio publicado en /pricing.

Crear workspace y conectar el primer agente

El enlace pasa por el login del producto y vuelve al onboarding de conexión.

Para agentes de IA

Este sitio también habla con las máquinas

El dominio público es agent-ready: las páginas existen en Markdown limpio en la misma URL con sufijo .md (índice completo en llms.txt), y los archivos de descubrimiento viven en la raíz.