Visão geral
Um conector só leva o escritório inteiro — clientes, carteiras e dados de mercado — para dentro do seu agente de IA.
O escritório tem um endpoint MCP próprio:
https://mcp-advisor.databolsa.com/mcpÉ um conector unificado: as tools do Advisor (advisor* — clientes,
carteiras, equipe, auditoria) e as tools de dados de mercado do DataBolsa
(cotações, indicadores, FIIs, fundos, crédito, macro, documentos) no mesmo
lugar. Na prática o agente consegue partir da carteira de um cliente e ir até o
fundamento do papel sem trocar de ferramenta.
"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?"
O que ele não vê
As tools pessoais do conector B2C ficam de fora: carteira do usuário, teses e identidade. O conector do escritório só lê e escreve o que é da organização — dado pessoal de quem opera não se mistura com dado do escritório.
Duas credenciais, dois enquadramentos
| Credencial | Como conecta | O que enxerga |
|---|---|---|
| OAuth (login) | claude.ai, ChatGPT, Claude Code | você como membro: papel e visibilidade do seu assento |
Chave db_org_... | header Authorization: Bearer | o escritório: escopo full opera como admin, read é só leitura |
Prefira OAuth em ferramenta de uso pessoal — a credencial é revogável por conexão e ninguém copia chave. Guarde a chave de organização para servidor, automação e CI.
O conector do escritório sempre exige credencial: sem ela o servidor
responde 401 com o desafio WWW-Authenticate, e o cliente MCP inicia o OAuth
sozinho a partir daí.
Escolha o seu
Claude (web, apps e Desktop)
Conector com login OAuth, sem chave.
ChatGPT
Conector MCP remoto com OAuth.
Claude Code
Terminal, OAuth ou chave de organização.
Cursor, VS Code e outros
Qualquer cliente MCP — remoto ou local.
Antes de soltar o agente
- Toda escrita é auditada e sai com o seu nome. Um agente que cria cliente ou lança transação deixa rastro igual ao portal.
- Peça confirmação antes de escrever. Ler é barato; criar, alterar e excluir mexem no dado real do escritório.
- 404 não significa "não existe". Recurso fora do seu escopo responde 404 — não deduza a carteira de clientes do escritório a partir de erros.
- Licença vencida responde 402 nas escritas e segue lendo normalmente.