Comece aqui
O escritório dentro do seu agente de IA em um minuto — clientes, carteiras, equipe e auditoria. Ou use a API, o SDK e a CLI.
O DataBolsa Advisor leva os mesmos dados e o mesmo agente do DataBolsa para dentro de um escritório: a organização passa a ter clientes, carteiras por cliente, equipe com papéis e uma trilha de auditoria de tudo que foi escrito.
Conecte seu agente de IA — sem chave, sem terminal
Se você usa claude.ai, ChatGPT ou Claude Code, são duas coisas:
Adicione o conector
Nas configurações de conectores do seu agente, cole a URL:
https://mcp-advisor.databolsa.com/mcpEntre com a conta do escritório
O agente abre o login do portal do escritório (código por e-mail). É uma conta própria do Advisor, separada da sua conta pessoal do DataBolsa — mesmo que você use o mesmo e-mail nas duas.
Você precisa ter um assento ativo: se ainda não tem, peça um convite a quem administra o escritório.
Guia passo a passo do seu agente:
"Quais clientes têm mais de 30% em um único FII?" · "Monte uma proposta de realocação para a Maria respeitando as restrições do perfil dela." · "O que mudou no crédito privado da carteira do Souza este mês?"
É um conector unificado: as tools do escritório (advisor*) e as de dados de
mercado no mesmo lugar, para o agente ir da carteira de um cliente ao fundamento
do papel sem trocar de ferramenta. As tools pessoais do produto B2C ficam de
fora — dado de quem opera não se mistura com dado do escritório.
Prefere código?
Tudo que o conector faz também existe como API REST, SDK TypeScript e CLI — aí sim com uma chave de organização.
Gere a chave no portal
Em advisor.databolsa.com → Config, crie uma
chave db_org_.... Ela aparece inteira uma única vez; guarde na hora.
export DATABOLSA_ADVISOR_API_KEY=db_org_SUACHAVEConfirme quem você é
npx -y @databolsa/advisor-cli advisorGetMeA resposta traz as organizações em que a chave pode agir. O identificador
(slug ou id) da organização é o primeiro argumento de todas as demais
operações.
A chave é do escritório, não sua: escopo full opera como admin, read é só
leitura. Para agir como você mesmo, com o papel e a visibilidade do seu assento,
use o conector com login.
As quatro portas
| Porta | Para quê |
|---|---|
| Portal | o dia a dia da equipe: clientes, carteiras, convites, chat do escritório |
| Conector MCP | o escritório dentro do seu agente de IA |
| CLI | um comando por operação, para scripts e rotinas |
| SDK | integração tipada em TypeScript |
Todas falam com a mesma API do Advisor, com contrato OpenAPI
próprio em
api.databolsa.com/openapi-advisor.json.
Quatro regras que valem em todas as portas
- Escopo é a organização. Um recurso de outro escritório — ou fora da sua visibilidade de clientes — responde 404, nunca 403. Não conclua que algo existe a partir do erro.
- Licença trava escrita, não leitura. Licença vencida responde 402 com
code: license_requirednas escritas; as leituras continuam funcionando. - Toda escrita é auditada. Quem fez, o quê e por qual porta (portal, API, MCP) entra na trilha de auditoria na mesma transação.
- Posição é derivada. As posições de uma carteira saem sempre do ledger de transações somado à cotação de mercado — nunca são gravadas à mão. Para corrigir uma posição, corrija o ledger.
O que o Advisor não é
O cliente do escritório não é um usuário do DataBolsa: é um registro do escritório, com os dados pessoais sob responsabilidade dele. Não existe login de cliente final, e nada do que está no Advisor aparece no produto B2C.
Os dados são informativos e educacionais. O Advisor não executa ordens nem movimenta dinheiro, e a recomendação a um cliente final continua sendo responsabilidade do profissional habilitado que usa a ferramenta.