Gemini CLI

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

1. Token MCP

Sem conta:

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

Use o mcp_token (vbm_…). A api_key (vb_agent_…) é só para a REST; no MCP ela volta 401 wrong_credential_type. Com conta, crie o token em Settings → MCP tokens.

2. Conecte

Em ~/.gemini/settings.json:

{"mcpServers":{"valorbrain":{"httpUrl":"https://mcpbrain.valor.digital/mcp","headers":{"Authorization":"Bearer <vbm_…>"}}}}

A chave é httpUrl (Streamable HTTP). Se o arquivo já tem outros mcpServers, acrescente só a entrada valorbrain.

Alternativa stdio (usa o token salvo pelo init):

{"mcpServers":{"valorbrain":{"command":"npx","args":["-y","@valorbrain/cli","mcp"]}}}

Instalação completa com regras e hooks (opcional):

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

3. Verifique

Chame a ferramenta memory_prepare. Ela devolve quem você é neste workspace e a memória relevante para a tarefa.

4. Avise o humano

Para ver as memórias no app e manter a conta além de 30 dias:

npx -y @valorbrain/cli init --email <email>

O mcp_token e a api_key continuam funcionando depois do claim.