Claude (web, apps e Desktop)

Adicione o DataBolsa Advisor como conector no claude.ai ou no Claude Desktop — login OAuth, sem chave.

Adicione o conector

Em Settings → Connectors → Add custom connector, cole a URL:

https://mcp-advisor.databolsa.com/mcp

O mesmo caminho vale no claude.ai e no Claude Desktop.

Autorize com sua conta

O Claude abre o login do DataBolsa (código por e-mail, o mesmo do site). Ao autorizar, você entra no escritório como membro — papel e visibilidade de clientes vêm do seu assento.

A autorização cria uma chave gerenciada "Conector MCP" na sua conta, revogável a qualquer momento em Configurações → Desenvolvedores.

Pergunte

"Liste os clientes ativos do escritório com o assessor responsável."

"A carteira da Maria Souza respeita as restrições do perfil dela?"

"Compare a evolução das carteiras da família Souza com o IBOV no ano."

Conector local (stdio)

Se preferir rodar na própria máquina — ou usar uma chave de organização em vez de login —, o pacote npm sobe o servidor do Advisor em stdio. Edite o claude_desktop_config.json:

{
  "mcpServers": {
    "databolsa-advisor": {
      "command": "npx",
      "args": ["-y", "@databolsa/advisor-mcp"],
      "env": {
        "DATABOLSA_ADVISOR_API_KEY": "db_org_SUACHAVE"
      }
    }
  }
}

Reinicie o Claude Desktop depois de salvar. O servidor local expõe somente as tools advisor* — para ter dados de mercado no mesmo agente, adicione também o conector do DataBolsa. O endpoint hospedado já traz os dois.

Problemas comuns

"Não foi possível conectar" — confira o /mcp no fim da URL e que o host é mcp-advisor, não mcp.
Conecta mas não vejo clientes — a organização pode estar em client_visibility: assigned e você não é o responsável por eles. Confirme com advisorGetMe e veja visibilidade.
Escritas falham com 402 — licença vencida. As leituras continuam.