Documentação

Comece em 5 minutos

ValorBrain expõe seu cérebro corporativo via MCP, REST e webhooks. Conecte qualquer agent, ingira de qualquer fonte.

Início rápido

01

Cadastro + token

Crie sua conta e complete o onboarding. Settings → MCP Tokens → Generate.

02

Conecte seu agent

Claude Desktop, Cursor, Windsurf, Hermes: qualquer client compatível com MCP.

Ver exemplos
03

Ingira conhecimento

Filesystem watcher, webhook REST, MCP store e 5 conectores OAuth nativos (Notion, Slack, Drive, GitHub, Linear).

Ver conectores
04

Consulte de qualquer agent

Tool MCP query, REST API ou hooks com injeção automática de contexto.

Referência API

Configuração MCP

ValorBrain expõe um servidor MCP HTTP com OAuth 2.1.

Claude Desktop

{
  "mcpServers": {
    "valorbrain": {
      "url": "https://mcpbrain.valor.digital/mcp",
      "transport": "http",
      "headers": {
        "Authorization": "Bearer vbm_<your-token>"
      }
    }
  }
}

Path: ~/.claude/claude_desktop_config.json

Cursor / Windsurf

Clients com OAuth 2.1 dynamic client registration descobrem auth automaticamente via https://mcpbrain.valor.digital/.well-known/oauth-authorization-server

Ingestion

4 caminhos pra alimentar o cérebro:

01

Do seu agent (MCP)

# registra o endpoint; o primeiro uso abre o OAuth
curl -fsSL https://valorbrain.valor.digital/install.sh | bash

# ou, direto no Claude Code:
claude mcp add --transport http valorbrain \
  https://mcpbrain.valor.digital/mcp

O OAuth não coloca token no shell. Para clientes sem OAuth, crie um token dedicado em Configurações → Tokens MCP e cole somente na configuração protegida do cliente.

02

REST ingest (API)

curl -X POST https://valorbrain.valor.digital/api/v1/ingest \
  -H "Authorization: Bearer fk_<prefix>.sk_<secret>" \
  -H "Content-Type: application/json" \
  -d '{
    "collection": "decisions",
    "path": "ADR-007.md",
    "title": "Multi-tenant migration",
    "content": "## Decision..."
  }'
03

MCP store tool

Diretamente do agent via tool store. Claude Code, Cursor e outros MCP clients podem ingerir sem sair do fluxo.

04

OAuth connectors (BYOK)

Notion, Google Drive, Slack, GitHub e Linear — disponíveis em Conectores (após login). Você traz suas credenciais OAuth; o sync roda em background e ingere no engine do tenant. Requer plano Starter ou superior.

Integrações com agents

Funciona com qualquer agent via REST. Aqui estão os frameworks mais comuns.

Hermes Agent

Plugin nativo com 10 tools (read + write). Auto-injetado no system prompt. Hermes lê e escreve memória automaticamente em cada sessão.

OpenClaw

Plugin nativo kind: memory com 10 agent tools. Hooks de lifecycle e context surfacing injetado no prompt automaticamente.

Claude Code / Cursor

Via MCP server HTTP. Claude Desktop, Cursor e Windsurf suportam MCP nativo com OAuth 2.1.

REST direto

Use HTTP direto com Bearer token. Funciona com qualquer linguagem, qualquer framework.

REST quick reference

Engine (cloud): https://valorbrain-api.valor.digital
Somente em instalação self-hosted: http://localhost:7438 no host que executa o engine.
Auth engine: Authorization: Bearer vb_<token> · Header: X-Tenant-ID: <uuid>
Ingest via SaaS: valorbrain.valor.digital/api/v1/ingest com fk_*.sk_*. MCP usa vbm_*.

# Search — POST /search (hybrid BM25 + vector + RRF)
curl -X POST https://valorbrain-api.valor.digital/search \
  -H "Authorization: Bearer vb_..." \
  -H "X-Tenant-ID: <your-tenant-uuid>" \
  -H "Content-Type: application/json" \
  -d '{"query":"architecture decision","limit":5}'

# Retrieve — POST /retrieve (multi-strategy)
curl -X POST https://valorbrain-api.valor.digital/retrieve \
  -H "Authorization: Bearer vb_..." \
  -H "X-Tenant-ID: <your-tenant-uuid>" \
  -H "Content-Type: application/json" \
  -d '{"query":"ADR-007 multi-tenant","limit":10}'

# Ingest (engine direto — POST /documents)
curl -X POST https://valorbrain-api.valor.digital/documents \
  -H "Authorization: Bearer vb_..." \
  -H "X-Tenant-ID: <your-tenant-uuid>" \
  -H "Content-Type: application/json" \
  -d '{"collection":"decisions","path":"ADR-001.md",
       "content":"## We chose PostgreSQL..."}'

# Get document by ID
curl https://valorbrain-api.valor.digital/documents/abc123 \
  -H "Authorization: Bearer vb_..." \
  -H "X-Tenant-ID: <your-tenant-uuid>"

# Pin, forget
curl -X POST https://valorbrain-api.valor.digital/documents/abc123/pin \
  -H "Authorization: Bearer vb_..." -H "X-Tenant-ID: <your-tenant-uuid>"
curl -X POST https://valorbrain-api.valor.digital/documents/abc123/forget \
  -H "Authorization: Bearer vb_..." -H "X-Tenant-ID: <your-tenant-uuid>"

# Collections
curl https://valorbrain-api.valor.digital/collections \
  -H "Authorization: Bearer vb_..." -H "X-Tenant-ID: <your-tenant-uuid>"

API reference

Read
MethodPathDescription
POST/searchHybrid search (BM25 + vector + RRF)
POST/retrieveMulti-strategy retrieve
GET/documents/:idFull document by ID
GET/documentsList documents (paginated)
GET/collectionsAll collections with doc counts
GET/sessionsRecent session summaries
GET/timeline/:idTemporal context around doc
GET/graph/similar/:idSemantically similar docs
GET/graph/causal/:idCausal links from doc
GET/statsIndex statistics
Write
MethodPathDescription
POST/documentsIngest document
POST/documents/:id/pinPin to foundation set
POST/documents/:id/forgetSoft-delete
POST/documents/:id/feedbackRate (POSITIVE / NEGATIVE)
POST/documents/:id/snoozeTemporarily deprioritize
PATCH/documents/:id/visibilityChange visibility
DELETE/documents/purgePurge forgotten docs

Self-hosted / On-prem

O engine roda em qualquer Linux com PostgreSQL 15+ e 4GB+ de RAM. Não publicamos um instalador aberto: on-prem sai acompanhado, com a build do engine, as migrações e o dimensionamento dos serviços de GPU.

O que fica do seu lado

  • PostgreSQL 15+ com pgvector, e o engine em uma porta HTTP interna.
  • Opcional em GPU: embedding (LFM2.5-Embedding-350M), reranker (BGE-Reranker-v2-m3) e um modelo local para expansão de consulta — sem eles o sistema funciona, com menos precisão de busca.
  • Nenhuma chamada sai da sua rede: é o que separa on-prem do hospedado.

Para on-prem, integração custom ou SLA dedicado, fale com a gente.

Pronto pra começar?

5 minutos pra setup. Plano grátis para sempre. Sem cartão de crédito.

Começar grátisFalar com a gente