Conectar um agent

O ValorBrain fala MCP por HTTP. Use OAuth quando o cliente suportar ou cole um token MCP dedicado na configuração.

Conexão

Endpoint: https://mcpbrain.valor.digital/mcp
Transporte: Streamable HTTP
Auth preferida: OAuth 2.1
Auth com token direto: Authorization: Bearer vbm_…

Autorizar o agent

O token MCP carrega o workspace e os escopos da pessoa e do agent. Ele aparece uma vez. Crie um token por agent para manter a autoria e poder revogar um deles sem parar os demais.

Fluxo guiado Criar token MCP Criar uma conta

Configuração por cliente

Use OAuth quando o card mostrar um comando OAuth. Nas configurações com token, troque <your-token> pelo token MCP dedicado. Qualquer cliente que suporte MCP por HTTP pode se conectar.

Claude Code (CLI)

terminal (one-time)

Rode uma vez. O Claude Code abre o OAuth do ValorBrain no primeiro uso.

claude mcp add --transport http valorbrain \
  https://mcpbrain.valor.digital/mcp

Claude Desktop

~/Library/Application Support/Claude/claude_desktop_config.json (macOS) · %APPDATA%\Claude\claude_desktop_config.json (Windows)

Cole no arquivo de config e reinicie o Claude Desktop.

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

Cursor

Settings → MCP → Add new MCP Server

No Cursor: Settings → MCP → Adicionar, escolha "HTTP", cole URL + header.

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

Hermes Agent

~/.hermes/config.yaml or profiles/<persona>/config.yaml

Cole em mcp_servers. Um token por humano ou por persona Hermes. A identidade vem do token.

# Hermes: ValorBrain MCP (tools)
mcp_servers:
  valorbrain:
    url: https://mcpbrain.valor.digital/mcp
    headers:
      Authorization: Bearer <your-token>
    timeout: 180

# Optional lifecycle (MemoryProvider): memory.provider: valorbrain
# Mint a separate token per persona with intended_agent_platform=slug

ZCode / valorcode (OpenCode)

opencode.json (project root) or ~/.config/opencode/opencode.json

Adicione uma entrada "mcp" no opencode.json do projeto. A chave é o nome do servidor.

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "valorbrain": {
      "type": "remote",
      "url": "https://mcpbrain.valor.digital/mcp",
      "enabled": true,
      "headers": {
        "Authorization": "Bearer <your-token>"
      }
    }
  }
}

Kiro CLI

.kiro/settings/mcp.json (project) or ~/.kiro/settings/mcp.json (all projects)

Cole no arquivo de config MCP do Kiro e reinicie.

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

Descoberta para agentes

Um agent encontra endpoint, OAuth, matriz de credenciais e fluxos reutilizáveis sem extrair esta página.

curl -fsS https://valorbrain.valor.digital/.well-known/mcp/server-card.json
curl -fsS https://valorbrain.valor.digital/.well-known/oauth-authorization-server
curl -fsS https://valorbrain.valor.digital/auth.md
curl -fsS https://valorbrain.valor.digital/.well-known/agent-skills/index.json

Verifique antes de usar a memória

Chame tools/list e depois whoami para confirmar workspace e usuário. Pare se alguma identidade estiver errada. Leia com memory_retrieve e salve resultados duráveis com memory_store.

Clientes sem MCP podem usar a API REST do engine em https://valorbrain-api.valor.digital. Ver referência REST.