MCP

O ValorBrain expõe um servidor Model Context Protocol.

• Transporte: Streamable HTTP
• Endpoint: https://mcpbrain.valor.digital/mcp
• Auth: OAuth 2.1 (registro dinâmico de cliente) ou Authorization: Bearer vbm_…
• Protocolo: 2025-11-25 (veja o server card)

HTTP (Claude Code, Cursor, Windsurf)

Clientes que falam Streamable HTTP:

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

Claude Code:

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

Depois autentique (OAuth) ou adicione o header bearer na configuração do cliente.

Clientes com OAuth 2.1 DCR descobrem o auth a partir de:

https://mcpbrain.valor.digital/.well-known/oauth-authorization-server

stdio (via CLI)

Clientes que só falam stdio:

{
  "mcpServers": {
    "valorbrain": {
      "command": "npx",
      "args": ["-y", "@valorbrain/connect", "--token", "vbm_<your-token>"]
    }
  }
}

@valorbrain/connect é um alias publicado de valorbrain mcp. Não é um protocolo separado.

Primeiras chamadas

1. tools/list — confie no schema vivo, não num screenshot.
2. whoami — confirme tenant e usuário. Pare se algum dos dois estiver errado.
3. memory_retrieve ou memory_prepare — depois memory_used.

O toolset padrão agent é o conjunto de trabalho. Não é o catálogo completo. Veja Ferramentas MCP.

O que não fazer

• Não aponte a REST para o mcpbrain. /search lá não é busca.
• Não envie uma chave vb_agent_ como bearer MCP. Tokens MCP começam com vbm_.
• Não chame a ferramenta deprecada store. A escrita canônica é memory_store.