Advisor

O Advisor é a extensão organizacional do DataBolsa para escritórios de assessoria, consultorias e wealth managers. Ele acrescenta clientes, perfis, carteiras por cliente, papéis de equipe e uma trilha de auditoria ao mesmo workspace em que o profissional pesquisa o mercado e produz análises.

Não existe um painel ou chat separado. O trabalho acontece no Notebook, na rota /x/databolsa.advisor; o antigo host advisor.databolsa.com apenas redireciona para essa página.

Clientes e carteiras

A página da extensão começa pela lista de clientes. O cabeçalho já apresenta o patrimônio sob gestão e os recortes por status e responsável, sem um dashboard paralelo. Abrir um cliente mostra perfil, objetivos, restrições, atividade e carteiras reais ou de proposta.

Posições são derivadas do ledger de transações. Uma carteira de proposta pode ficar fora do AUM para estudar cenários sem alterar o consolidado real.

Organização e permissões

O Advisor só pode ser instalado em workspaces de organização. Equipe, papéis, convites e chaves pessoais são administrados na área Conta do Notebook.

O acesso é recortado pelo papel e pela relação com o cliente. Recursos fora do escopo respondem 404, sem revelar se existem. Toda escrita é auditada na mesma transação da mudança; licença vencida preserva leitura e bloqueia escrita com 402 license_required.

Chaves antigas de organização (db_org_...) não são aceitas. Integrações usam a chave pessoal db_live_... do membro e o workspace da organização.

No agente

O conector MCP é o mesmo do DataBolsa. As capacidades do Advisor aparecem quando a extensão está instalada, os scopes foram autorizados e o contexto do turno permite a operação. Escritas sobre clientes ou carteiras exigem alvo explícito e confirmação.

Conecte Claude, Codex, ChatGPT ou outro agente →

API e clientes

O data plane e o contrato permanecem separados para preservar as regras do domínio:

• Referência da API
• OpenAPI
• @databolsa/advisor-sdk
• @databolsa/advisor-cli
• @databolsa/advisor-mcp para uso local

SDK

import { DataBolsaAdvisor } from "@databolsa/advisor-sdk";

const advisor = new DataBolsaAdvisor({
  apiKey: process.env.DATABOLSA_ADVISOR_API_KEY,
  workspace: process.env.DATABOLSA_ADVISOR_WORKSPACE,
});
const { data: clientes } = await advisor.listClients("org_abc123", {
  status: "active",
});

CLI

export DATABOLSA_ADVISOR_API_KEY=db_live_SUACHAVE
export DATABOLSA_ADVISOR_WORKSPACE=org_abc123
npx -y @databolsa/advisor-cli --list
npx -y @databolsa/advisor-cli advisorListClients org_abc123 --json

O identificador da organização continua sendo argumento das operações; o header de workspace impede que a mesma credencial aja acidentalmente em outro contexto.

O Advisor não executa ordens nem substitui o julgamento ou a responsabilidade do profissional habilitado.