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.
npx -y @valorbrain/connect@latest --token <vbm_…> --harness claude-codeSem hooks (MCP e regras, nada enviado por turno):
npx -y @valorbrain/connect@latest --token <vbm_…> --harness claude-code --mcp-onlyOu o MCP à mão:
claude mcp add --transport http --scope user valorbrain https://mcpbrain.valor.digital/mcp --header "Authorization: Bearer <vbm_…>"npx -y @valorbrain/connect@latest --token <vbm_…> --harness codexSem hooks (MCP e regras, nada enviado por turno):
npx -y @valorbrain/connect@latest --token <vbm_…> --harness codex --mcp-onlyOu o MCP à mão:
export VALORBRAIN_MCP_TOKEN=<vbm_…>codex mcp add valorbrain --url https://mcpbrain.valor.digital/mcp --bearer-token-env-var VALORBRAIN_MCP_TOKENnpx -y @valorbrain/connect@latest --token <vbm_…> --harness kiroSem hooks (MCP e regras, nada enviado por turno):
npx -y @valorbrain/connect@latest --token <vbm_…> --harness kiro --mcp-onlyOu o MCP à mão:
{ "mcpServers": { "valorbrain": { "url": "https://mcpbrain.valor.digital/mcp", "headers": { "Authorization": "Bearer <vbm_…>" } } }}npx -y @valorbrain/connect@latest --token <vbm_…> --harness gemini-cliSem hooks (MCP e regras, nada enviado por turno):
npx -y @valorbrain/connect@latest --token <vbm_…> --harness gemini-cli --mcp-onlyOu o MCP à mão:
{ "mcpServers": { "valorbrain": { "httpUrl": "https://mcpbrain.valor.digital/mcp", "headers": { "Authorization": "Bearer <vbm_…>" } } }}npx -y @valorbrain/connect@latest --token <vbm_…> --harness cursorSem hooks (MCP e regras, nada enviado por turno):
npx -y @valorbrain/connect@latest --token <vbm_…> --harness cursor --mcp-onlyOu o MCP à mão:
{ "mcpServers": { "valorbrain": { "url": "https://mcpbrain.valor.digital/mcp", "headers": { "Authorization": "Bearer <vbm_…>" } } }}{ "servers": { "valorbrain": { "type": "http", "url": "https://mcpbrain.valor.digital/mcp", "headers": { "Authorization": "Bearer <vbm_…>" } } }}Conectores → Adicionar conector personalizado → URL do MCP: https://mcpbrain.valor.digital/mcp. A autorização é por OAuth, sem colar token.
Customize → MCPs → Add custom MCP, no seu escopo Personal ou uma vez no da organização: transporte HTTP, URL https://mcpbrain.valor.digital/mcp, autenticação OAuth (no escopo da organização, Access em Personal). Depois cada pessoa clica em Connect e entra com a própria conta, sem colar token. Passo a passo: https://docs.valorbrain.com.br/docs/integrations/devin
npx -y @valorbrain/cli mcpPara qualquer cliente que só fala stdio. Usa o token salvo pela CLI.
npx -y @valorbrain/connect@latest --token <vbm_…>Opcional: configura MCP, regras de memória e hooks em todos os agentes do computador. Os hooks enviam o prompt de cada turno para o workspace: avise o humano antes. O que cada hook envia e como desligar o envio do prompt: https://docs.valorbrain.com.br/docs/concepts/what-leaves-your-machine
{ "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.mdPrimeiro 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.
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.
- llms.txt
Índice curado do site para LLMs.
- llms-full.txt
Todo o conteúdo dos espelhos .md em um documento só.
- .well-known/agent-card.json
Cartão do servidor MCP (A2A): endpoint, transporte e autenticação.
- .well-known/security.txt
Contato de segurança e política de divulgação.