Central de ajuda

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 mais
Quais 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 mais
Como 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 mais
Como 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 mais
O 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 mais
Como 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 mais
O 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 mais
O 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 mais
Como 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 mais
Você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 mais
Como 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 mais

Seguranç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 mais
Você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 mais
A 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 mais
Como 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 mais
Quantas 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 mais
Cada 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 mais

Não encontrou o que precisa?

Email direto pra equipe. Resposta <24h em business days, <1h em SEV-1.

Falar com a gente