Passar para o conteúdo principal

Como conecto minha conta da Hapi ao Claude, ChatGPT ou Cursor?

Guia para conectar sua conta da Hapi (somente leitura) ao seu assistente de IA durante a beta fechada de IA conectada.

Você pode conectar sua conta da Hapi ao seu assistente de inteligência artificial (IA) para fazer perguntas sobre seu portfólio, suas movimentações ou o mercado em linguagem natural — por exemplo, “como está meu portfólio este mês?”. A conexão é somente leitura: a IA não pode comprar, vender nem movimentar dinheiro.

📌 Importante: esta funcionalidade está em beta fechada. Somente os clientes habilitados pela Hapi podem usá-la. Se sua conta não estiver habilitada, o assistente mostrará uma mensagem de acesso não habilitado e você não poderá se conectar.

Por ser uma beta, a funcionalidade pode mudar, apresentar erros ou deixar de estar disponível.

Como acesso a beta?

Não há cadastro automático. A Hapi irá habilitando grupos de clientes de forma gradual, de acordo com seus critérios de elegibilidade; não há garantia de que sua conta será habilitada nem em que data. Quando sua conta for habilitada, avisaremos você.

Quais assistentes posso conectar?

Somente três: Claude (da Anthropic), ChatGPT (da OpenAI) e Cursor (da Anysphere). A Hapi não aceita conexões de outros aplicativos, mesmo que usem o mesmo nome.

Passo a passo (Claude e ChatGPT)

  1. No seu assistente, adicione um novo conector:

    • Claude: Configurações → Conectores → Adicionar conector personalizado.

    • ChatGPT: ative o modo desenvolvedor e crie um novo conector.

    • Cursor: diferente do Claude e do ChatGPT, o Cursor não se conecta sozinho: é preciso colar uma configuração. Veja a seção «Conectar com o Cursor» abaixo.

  2. Cole esta URL do servidor: https://mcp.hapi.trade/mcp. Se for solicitado um client ID, deixe em branco.

  3. O assistente levará você a uma página da Hapi. Faça login na sua conta, caso ainda não tenha feito.

  4. Revise a tela de autorização: você verá o nome do assistente com o selo “A Hapi verificou que este é o app oficial de…”, que confirma que o aplicativo é o assistente oficial que diz ser (não significa que a Hapi revise nem endosse as respostas dele), o endereço web para o qual a autorização retorna (por exemplo, claude.ai ou chatgpt.com), o que a IA poderá ver e o que não poderá fazer.

  5. Marque a caixa para aceitar os Termos de IA Conectada da Hapi e toque em Autorizar. O botão Autorizar só é ativado depois de marcar a caixa.

  6. Confirme sua identidade com sua senha e o código que enviamos por e-mail.

  7. Volte ao seu assistente e faça uma pergunta.

Toda vez que você conectar uma IA, enviamos um e-mail e uma notificação para que você saiba que a conexão foi feita.

Conectar com o Cursor

  1. Abra o Cursor, vá em Settings → MCP (ou Cursor Settings → Tools & MCP) e escolha Add new MCP server. O arquivo mcp.json será aberto.

  2. Cole esta configuração. Se você já tem outros servidores, adicione apenas o bloco "hapi" dentro de "mcpServers":

    {
    "mcpServers": {
    "hapi": {
    "url": "https://mcp.hapi.trade/mcp",
    "auth": {
    "CLIENT_ID": "hapi-cursor",
    "scopes": ["openid", "offline_access", "read:portfolio", "read:transactions", "read:market", "read:watchlist"]
    }
    }
    }
    }
  3. Salve o arquivo. Na lista de servidores MCP aparecerá hapi: clique em Connect (ou Needs login).

  4. Seu navegador abrirá na Hapi: faça login, revise o que o Cursor poderá ver (somente leitura), aceite os Termos de IA Conectada da Hapi, confirme sua identidade com sua senha e o código que enviamos por e-mail e toque em Autorizar.

  5. O navegador levará você de volta ao Cursor e hapi ficará conectado. Agora você já pode perguntar sobre seu portfólio, suas transações ou preços.

Onde fica o arquivo: ~/.cursor/mcp.json vale para todos os seus projetos; .cursor/mcp.json dentro de um projeto vale somente para aquele projeto.

É acesso somente leitura: o Cursor não pode operar, movimentar dinheiro nem alterar dados. A URL e o CLIENT_ID não são segredos: são os mesmos para todos os usuários.

Duração e desconexão: a conexão expira em 30 dias. Para desconectar antes, vá em Configurações > IAs conectadas no app da Hapi (igual aos demais assistentes).

Se algo der errado com o Cursor

  • «Não conseguimos continuar» ou erro de redirect_uri: atualize o Cursor para a versão mais recente e conecte novamente.

  • Porta 8787: o Cursor usa a porta 8787 do seu computador para receber a autorização. Se outro programa estiver usando, feche-o e tente novamente.

  • O navegador não abre: no Cursor, desconecte e reconecte o hapi em Settings → MCP.

⚠️ Autorize somente conexões que você mesmo iniciou. Se você receber um link para autorizar uma IA que não solicitou, não o conclua, mesmo que venha de alguém que você conhece. Sempre confira se o domínio que aparece na tela é o do assistente que você está usando.

Tem custo?

Seu assistente de IA pode ter seus próprios planos e preços, que dependem de cada provedor.

Tem dúvidas? Entre em contato com nossa equipe de suporte. Estamos aqui para ajudar.

👉 A equipe de suporte não fornece assessoria de investimento, fiscal ou jurídica.

As ações e ETFs são oferecidos pela Hapi Securities LLC, membro da FINRA e da SIPC (CRD #311868); custódia e compensação por meio da Apex Clearing Corporation. A Hapi Securities LLC faz parte da Hapi Corp. e suas afiliadas. A Hapi é self-directed e não oferece recomendações de investimento. Os assistentes de IA são serviços de terceiros (Anthropic, OpenAI e Anysphere) que não são afiliados à Hapi; a Hapi não revisa nem aprova suas respostas, que não são recomendações de investimento da Hapi. Investir envolve riscos, incluindo a possível perda do capital.

Respondeu à sua pergunta?