Pular para o conteúdo

Para desenvolvedores

Documentação para construir com o ValorBrain

O caminho mais curto para conectar um agente: MCP com bearer token, API REST com contrato OpenAPI e a camada agent-ready deste domínio. Só entrou nesta página o que está no ar.

Comece por aqui

Conecte seu agente por MCP

Adicione o servidor ValorBrain à configuração MCP do seu cliente e chame whoami na primeira conexão para conferir o workspace. O token vbm_ é criado por uma pessoa nas configurações do workspace e carrega o tenant e as permissões de quem o criou.

.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 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.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 mesmo token vbm_ vale para MCP, rotas de memória REST e ingest do SaaS. 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.

Criar workspace e 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.