Como podemos ajudar?
Documentação, troubleshooting e respostas rápidas.
Começando
Primeiros passos: criar conta, conectar agent, importar conteúdo.
Como criar minha conta?
Vá em /auth/register. Use email + senha (ou Google OAuth). Receba email de ativação. Após confirmar, /dashboard fica acessível.
Quanto custa pra começar?
Nada. O plano Grátis é grátis para sempre, sem cartão: 1 pessoa, 1.000 documentos, buscas na memória ilimitadas e 50 respostas com fonte por mês. Se quiser ver o produto inteiro, o plano Empresa fica liberado por 14 dias, também sem cartão.
Ver maisQuais agents posso conectar?
Claude Code, Cursor, Kiro CLI, Hermes Agent, OpenClaw e qualquer cliente MCP-compatible. Setup público em /docs; após login, guides por agent em /guides.
Ver maisComo conecto meu primeiro agent?
Após signup, vá pra /onboarding/connect-agent. Wizard guiado em 3 passos: pick agent, copy token + config, verify connection. Leva ~2-3 min.
Agents + MCP
Como agents conversam com a ValorBrain via MCP.
O que é MCP?
Model Context Protocol. protocolo aberto para LLMs conversarem com fontes externas de dados/tools. ValorBrain expõe um servidor MCP em https://mcpbrain.valor.digital com OAuth 2.1 dynamic client registration.
Token MCP vs API Key: qual a diferença?
Use o token MCP (vbm_...) — é o que serve para quase tudo. Ele conecta seu agent no endpoint /mcp e também funciona nas rotas REST do engine, com os mesmos escopos (read, write, admin). A API Key do painel (formato fk_... .sk_...) existe para um caso só: mandar documento por HTTP em POST /api/v1/ingest, via header Authorization. Se você está em dúvida, quer o token MCP.
Posso usar mais de um agent ao mesmo tempo?
Sim. ValorBrain suporta cross-agent coherence: decisão capturada em Claude Code aparece pro Cursor na próxima sessão. Activity feed em /dashboard mostra tudo.
O que é o tool profile no MCP?
profile devolve contexto estável (fatos) + foco recente da organização/usuário, com origem quando disponível. Ideal no início de sessão (ou use working_context). Contexto operacional da memória compartilhada, não second-brain pessoal.
Como sei se meu agent está conectado?
Widget Verify Connection no /dashboard mostra estado em tempo real: token verificado (verde), token sem uso (amber CTA), ou no token (blue CTA). Polling endpoint /api/v1/connections/verify.
Conhecimento
Perguntar, buscar e gerenciar memória.
Como faço a primeira pergunta com citação?
Com documentos indexados, abra Perguntar (/knowledge/ask) ou use o item Perguntar na nav. Escreva em linguagem natural; a resposta lista fontes, origem e score. Esse é o “aha” do produto.
Ver maisComo busco/listo documentos na base?
Em /knowledge (aba Buscar) use a barra de busca. Keyword + semântico por padrão. Filtros: collection, content type, datas. Para perguntas, prefira Perguntar.
Ver maisO que são collections?
Agrupamento lógico de docs. Default: cada agent ingere numa collection própria (claude-code, cursor, etc). Pode criar custom: /connectors → Add Source.
Como controlo o que vai pra memória?
Hooks de cada agent. Em Claude Code: ~/.claude/hooks/ filtra antes de enviar. No Hermes: prompt instructions. Para denylist server-side, use scopes da API key.
Planos e cobrança
Como cobramos, o que é ilimitado, teste e garantia.
Como funciona a cobrança?
Você paga por pessoas e por respostas de IA. Documentos, buscas e memória são ilimitados nos planos pagos: não há cota de documento nem medidor de busca. A escada completa, com o preço de cada plano, está em /pricing.
Ver maisComo funciona o teste de 14 dias?
O plano Empresa fica liberado por 14 dias, sem cartão de crédito: todos os limites e todos os conectores. Ao fim do teste a conta volta para o Grátis e seus dados continuam lá — nada é apagado.
Ver maisO que conta como resposta de IA?
É a pergunta em linguagem natural respondida com o documento citado (Perguntar, em /knowledge/ask). Só a resposta gerada conta: buscar e listar documentos na memória não consome nada, porque não tem custo de LLM. Cada plano inclui um número de respostas por mês; acima disso, cobramos por resposta ao preço listado em /pricing.
Ver maisO que exatamente é ilimitado?
Documentos e buscas, nos planos pagos — literalmente, sem cota. Existe um teto de uso justo em armazenamento (GB por plano), que na prática equivale a mais de cem mil documentos; ele existe para o caso patológico, não para o cliente normal, e se você chegar perto nós ligamos antes de qualquer coisa. O Grátis é o único plano com teto de documentos.
Ver maisComo adiciono mais pessoas ao meu plano?
Em /settings/users → Convidar. Cada plano já inclui um número de pessoas; acima disso, a pessoa adicional tem preço fixo por mês (menor no Empresa que no Time), listado em /pricing. Compartilhar documento com o time não custa nada.
Ver maisVocês têm garantia? E desconto anual?
Garantia de 30 dias: não gostou, devolvemos o valor pago. No plano anual você paga 12 meses pelo preço de 10.
Ver maisComo cancelo?
Em /settings/subscription → Cancelar plano. O acesso continua até o fim do período já pago; depois a conta cai para o Grátis e seus documentos ficam onde estão.
Ver maisSegurança + Privacidade
Como ValorBrain protege seus dados.
Onde meus dados ficam armazenados?
Postgres multi-tenant com isolamento por tenant (RLS). Default do produto: cloud. Self-host / on-prem sob contrato enterprise se o deal exigir. Detalhes em /security.
Ver maisVocês oferecem self-host?
Não como default. O ValorBrain vende memória organizacional multi-user na nuvem. On-prem / air-gapped só sob demanda enterprise (implementação sob contrato).
Ver maisA busca respeita permissões?
Sim. O Ask e a listagem filtram coleções visíveis ao seu papel. Fontes fora do seu acesso não entram na resposta; a UI pode indicar quantas foram omitidas. Origem (confirmado / integração / agent) aparece nas citações quando disponível.
Ver maisComo revogo acesso de um agent?
/settings/api-keys → revoke key específica, ou /settings/mcp-tokens → delete MCP token. Imediato (cache TTL <60s).
Posso exportar todos meus dados?
Sim. /settings/profile → Export data. JSON dump completo via /api/v1/export. Direito LGPD garantido.
O que acontece quando deleto minha conta?
Purge permanente em 30 dias (período de graça pra recuperação). Inclui backups + audit logs. Sem retenção residual.
Time + Permissões
Convites, roles, multi-user.
Como convido alguém da minha empresa?
/settings/users → Invite user. Insere email + role. User recebe email de ativação. Roles: admin, member, viewer.
Ver maisQuantas pessoas por plano?
Grátis: 1 pessoa. Time: 10. Empresa: 50. Enterprise: ilimitado. No Time e no Empresa você pode passar do incluído pagando por pessoa adicional — preço em /pricing.
Ver maisCada user tem context próprio?
Identity tier: tenant-wide identity (workspace, stack, preferences) + per-user role_description appended on session. Configurável em /settings/identity.
Troubleshooting
Problemas comuns e como resolver.
Não recebi o email de ativação
Verifique spam/promotional. Adicione [email protected] aos contatos. Em /auth/login → Reenviar ativação. Se persistir, [email protected].
Meu agent retorna "Unauthorized" ao chamar MCP
Token expirou ou foi revogado. Crie novo em /settings/mcp-tokens. Atualize o config do agent (~/.claude.json para Claude Code).
Search retorna 0 resultados
Verifique se docs foram indexados (/connectors mostra collections + counts). Teste mode "keyword" se "auto" falha. Re-trigger embed worker se needsEmbedding > 0.
Algum serviço caiu?
Veja status real em /status. Reportar issue: [email protected] com timestamp + erro. SLA: SEV-1 1h, others 4h.
Ver maisNão encontrou o que precisa?
Email direto pra equipe. Resposta <24h em business days, <1h em SEV-1.
Falar com a gente
