Grok

Passos completos: connect.md · Começo rápido.

O harness do Grok vive em valorbrain-harness/grok: um markdown de contrato e um mcp.example.toml de exemplo. Nada do nosso tenant está nesse repositório.

Token

npx -y @valorbrain/cli@latest init --agent --agent-caller grok --json

Use o mcp_token (vbm_…); o MCP aceita só vbm_. Com conta, crie o token em Settings → MCP tokens.

MCP hospedado via stdio

# ~/.grok/config.toml
[mcp_servers.valorbrain]
command = "npx"
args = ["-y", "@valorbrain/cli", "mcp"]

O npx -y @valorbrain/cli mcp usa o token salvo pelo init; para passar outro, acrescente "--token", "<vbm_…>" aos args ou defina VALORBRAIN_MCP_TOKEN. O exemplo antigo com @valorbrain/connect como command está errado: o @valorbrain/connect é o instalador, não o servidor.

Contrato e instalação

Instalação completa pelo instalador (servidor MCP, regras e hooks):

npx -y @valorbrain/connect@latest --token <vbm_…> --harness grok

Ou instale só o contrato a partir de um clone do repositório de harness:

./install.sh grok

O install.sh desse repositório é por harness (grok, zcode, …). Ele escreve o bloco de contrato em ~/.grok/AGENTS.md e avisa se o config.toml ainda não tem a entrada mcp_servers.valorbrain. Ele não chama uma CLI valorbrain setup, porque esse comando de CLI não está publicado.

Verifique

Chame memory_prepare. Para manter a conta além de 30 dias, o humano roda npx -y @valorbrain/cli init --email <email>.