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 tu agente por MCP

Añade el servidor ValorBrain a la configuración MCP de tu cliente y llama a whoami en la primera conexión para confirmar el workspace. El token vbm_ lo crea una persona en la configuración del workspace y lleva el tenant y los permisos de quien lo creó.

.well-known/mcp.jsonhttps://valorbrain.com.br/.well-known/mcp.json
{  "mcpServers": {    "valorbrain": {      "url": "https://mcpbrain.valor.digital/mcp",      "transport": "streamable-http",      "headers": {        "Authorization": "Bearer vbm_<seu-token>"      },      "description": "ValorBrain shared company memory: retrieve, store, handoffs, audit. Token created by a human in workspace settings (https://valorbrain.valor.digital/settings/mcp-tokens); it carries the tenant and the permissions of its owner.",      "docs": "https://valorbrain.valor.digital/auth.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.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 mismo token vbm_ vale para MCP, rutas de memoria REST e ingest del SaaS. 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.