Pular para o conteúdo

Conecte seus agentes e sistemas ao ValorBrain

O caminho mais curto do terminal à memória: um comando que configura seus agentes, MCP com bearer token, API REST com contrato OpenAPI e a camada agent-ready deste domínio. A documentação completa fica em docs.valorbrain.com.br.

O que o comando faz

Cole num terminal do computador onde você usa Claude Code, Codex, Cursor, Gemini CLI, Kiro, OpenCode ou Hermes. O comando encontra os agentes, abre o navegador para você autorizar o computador e configura MCP, regras de memória e hooks em cada um, com um token seu para o computador, usado por todos eles.

Sem conta ainda? Você cria na mesma tela de autorização. No Windows sem Node.js, o script oferece instalar a versão LTS com o winget. Os hooks enviam o prompt de cada turno para o seu workspace, para buscar a memória; sem hooks: --mcp-only (o Hermes não tem hooks: o plugin de memória dele continua enviando o prompt; lá use --prompt off); --remove desfaz tudo. O que sai da máquina e como desligar: https://docs.valorbrain.com.br/docs/concepts/what-leaves-your-machine

Ou configure à mão

Conecte seu agente por MCP

Escolha o seu cliente, cole o token vbm_ e chame memory_prepare para conferir a conexão. Sem conta, o agente cria a dele com um comando; o passo a passo completo, que você pode mandar direto ao agente, está em /connect.

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

Sem hooks (MCP e regras, nada enviado por turno):

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

Ou o MCP à mão:

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 com contrato aberto

A API pública do SaaS atende nesta base e o contrato completo é OpenAPI 3.1. A referência navegável fica dentro do app, atrás do login do workspace.

Base URL

https://valorbrain-api.valor.digital

Especificação OpenAPI
openapi.json
Referência navegável (login do workspace)
api-docs
Catálogo de serviços da API
api-catalog

Autenticação

Bearer token no header Authorization. O MCP aceita só o token vbm_; a API REST usa a chave vb_agent_ (conta de agente) ou vb_. O auth.md documenta cada caso, incluindo OAuth e device flow para clientes headless.

Ler o auth.md

Primeiro passo

A sandbox é o produto

Não há ambiente de teste separado: você experimenta no seu workspace, com um projeto real e os agentes que já usa. Um projeto free para provar no seu fluxo; os degraus pagos têm preço publicado em /pricing.

Conectar o primeiro agente

O link passa pelo login do produto e volta para o onboarding de conexão.

Para agentes de IA

Este site também fala com máquinas

O domínio público é agent-ready: as páginas existem em Markdown limpo na mesma URL com sufixo .md (índice completo no llms.txt), e os arquivos de descoberta ficam na raiz.