MCP Hotmart: como consultar dados e realizar ações na minha conta com IA?

O MCP Hotmart permite conectar sua conta Hotmart a ferramentas de inteligência artificial compatíveis, como Claude Desktop e ChatGPT Desktop.

Com o MCP Hotmart configurado, você pode consultar informações da sua conta diretamente pelo assistente, incluindo vendas, assinaturas, produtos, alunos e comissões. A integração também permite realizar algumas ações, como criar cupons ou fazer alterações em assinaturas, sempre de acordo com as permissões do seu perfil.

Neste artigo, você vai entender como o MCP Hotmart funciona, o que pode fazer com ele e como realizar a configuração no assistente que utiliza.

O que é o MCP Hotmart?

MCP é a sigla para Model Context Protocol (Protocolo de Contexto de Modelo). Esse protocolo permite que assistentes de inteligência artificial se conectem a fontes externas de dados, como sistemas, aplicativos e plataformas.

No caso da Hotmart, o MCP Hotmart faz essa conexão entre o assistente de IA e a sua conta. Com a integração configurada, você pode fazer perguntas e pedidos usando uma linguagem simples, sem precisar utilizar comandos técnicos. Por exemplo, você pode perguntar quanto vendeu em determinado período ou solicitar informações sobre uma assinatura.

Quando você envia uma solicitação, o assistente consulta as informações diretamente na Hotmart e usa esses dados para responder. As consultas são feitas em tempo real e dependem de uma chave de acesso pessoal criada e autorizada por você.

Para o funcionamento da integração, a Hotmart não envia nem armazena os dados da sua conta em uma base externa.

O MCP Hotmart é compatível com:

• Claude Desktop (macOS e Windows)
• ChatGPT Desktop (macOS e Windows)
• Outros clientes MCP, como IDEs e agentes próprios, por meio de configuração manual.

O que posso fazer com o MCP Hotmart?

O MCP Hotmart aceita dois tipos principais de comandos: consultas, usadas para buscar e analisar informações, e ações, que modificam dados ou executam operações na conta.

❯ Consultar dados e métricas

Você pode pedir informações relacionadas às atividades da sua conta, incluindo vendas, assinaturas, produtos, alunos, cupons e comissões.

Por exemplo, é possível fazer pedidos como:

• “Quanto eu vendi hoje?”
• “Compare minhas vendas desse mês com o mês passado.”
• “Qual produto tem a maior taxa de conversão?”
• “Quantos alunos entraram na turma essa semana?”
• “Mostre o histórico do assinante [e-mail].”
• “Crie um resumo semanal das minhas vendas.”

Também é possível solicitar análises que combinem diferentes informações, como comparação entre períodos, produto com mais vendas, ticket médio ou taxa de reembolso. Nesse caso, o assistente pode organizar os dados encontrados e apresentar uma resposta com base no pedido feito.

Para obter resultados mais próximos do que você procura, inclua no comando informações como período, produto e métrica. Por exemplo, em vez de perguntar apenas “como estão minhas vendas?”, você pode especificar o produto e o intervalo de datas que deseja analisar.

❯ Executar ações na minha conta

Além das consultas, o MCP Hotmart pode executar algumas operações, como:

• Criar e excluir cupons de desconto
• Cancelar e reativar assinaturas
• Alterar o dia de vencimento de uma assinatura
• Estornar vendas e emitir reembolsos

Atenção: ações que alteram dados da sua conta precisam ser confirmadas antes da execução. O assistente apresenta o que será feito e aguarda sua autorização. Por isso, revise as informações exibidas antes de confirmar.

Como configurar o MCP Hotmart?

A configuração depende do assistente ou cliente MCP que você utiliza. Você também pode acessar a página do MCP Hotmart para consultar as opções disponíveis e seguir o passo a passo de instalação conforme a ferramenta que utiliza.

Abaixo, confira as instruções para cada opção:

❯ Como configurar no Claude Desktop?

Antes da instalação, tenha o Claude Desktop instalado no computador. No Windows, também é necessário ter o Node.js instalado para que o conector funcione.

Passo 1: Baixe o arquivo do conector

1. Acesse a página do MCP Hotmart.
2. Selecione Claude Desktop.
3. Escolha seu sistema operacional: macOS ou Windows.
4. Clique em Baixar o conector para obter o arquivo hotmart.mcpb.
5. No macOS, abra o arquivo baixado. O Claude Desktop será iniciado para instalar o conector.
6. No Windows, abra o Claude Desktop e acesse Configurações > Extensões > Configurações Avançadas. Clique em Instalar Extensão e selecione o arquivo hotmart.mcpb.

Passo 2: Crie sua chave de acesso na Hotmart

1. Acesse sua conta da Hotmart pelo link https://app.hotmart.com/.
2. No menu lateral, selecione Ferramentas > Ver todas.
3. Busque por Credenciais Hotmart e clique em Criar credencial.
4. Selecione MCP Hotmart.
5. Escolha Claude como assistente.
6. Dê um nome à credencial para identificá-la, por exemplo: “MCP Claude”.
7. Confirme a criação e copie a chave gerada.

Guarde essa chave, pois ela será usada para autorizar a conexão.

Passo 3: Adicione a chave ao Claude Desktop

1. No Claude Desktop, abra Configurações e acesse a aba Conectores.
2. Procure por Hotmart.
3. Cole sua chave no campo de autenticação.
4. Clique em Salvar.

Depois dessa configuração, o conector ficará disponível nas conversas compatíveis com o Claude Desktop.

❯ Como configurar no ChatGPT Desktop?

Antes da instalação, tenha o ChatGPT Desktop instalado no computador. O processo é o mesmo para macOS e Windows.

Passo 1: Crie sua chave de acesso na Hotmart

1. Acesse sua conta da Hotmart pelo link https://app.hotmart.com/.
2. No menu lateral, selecione Ferramentas > Ver todas.
3. Busque por Credenciais Hotmart e clique em Criar credencial.
4. Selecione MCP Hotmart.
5. Escolha ChatGPT como assistente.
6. Dê um nome à credencial para identificá-la, por exemplo: “MCP ChatGPT”.
7. Confirme a criação e copie a chave gerada.

Guarde essa chave, pois ela será usada para autorizar a conexão.

Passo 2: Configure o servidor MCP no ChatGPT

1. No ChatGPT Desktop, abra Configurações.
2. No menu Integrações, selecione Plug-ins.
3. Clique em Adicionar e depois em Adicionar servidor MCP.
4. Preencha os campos abaixo:
   • Nome: MCP Hotmart ou outro nome de sua preferência
   • Tipo: HTTP com streaming
   • URL: https://developers.hotmart.com/mcp/v1
   • Cabeçalho — Chave: Authorization
   • Cabeçalho — Valor: Basic SEU_TOKEN (substitua SEU_TOKEN pela chave criada na Hotmart e mantenha o prefixo Basic)
5. Clique em Salvar.

Após a configuração o conector fica disponível no modo Work do ChatGPT.

❯ Como configurar em uma IDE, agente próprio ou outro cliente MCP?

Para outros clientes MCP, a configuração é manual e pode exigir familiaridade com arquivos de configuração.

Passo 1: Crie sua chave de acesso na Hotmart

1. Acesse sua conta da Hotmart pelo link https://app.hotmart.com/.
2. No menu lateral, selecione Ferramentas > Ver todas.
3. Busque por Credenciais Hotmart e clique em Criar credencial.
4. Selecione MCP Hotmart.
5. Escolha Outros como assistente.
6. Dê um nome à credencial para identificá-la, por exemplo: “MCP na minha IDE”.
7. Confirme a criação e copie a chave gerada.

Guarde essa chave, pois ela será usada para autorizar a conexão.

Passo 2: Declare o servidor no seu cliente MCP

1. Abra o arquivo de configuração de servidores MCP da sua IDE ou do seu assistente.
2. Adicione a configuração do servidor ao objeto correspondente. Em muitos clientes, ele é identificado como mcpServers.
3. Insira a chave criada na Hotmart no local indicado, mantendo o prefixo Basic.
4. Salve o arquivo.
5. Reinicie o cliente para carregar a nova configuração.

Como funcionam a segurança e as permissões do MCP Hotmart?

O acesso ao MCP Hotmart é feito por uma credencial criada na sua conta. Essa chave é pessoal e deve ser tratada como uma senha, por isso não deve ser compartilhada.

As permissões do MCP seguem as permissões já existentes no seu perfil da Hotmart. Isso significa que a integração não amplia os acessos da sua conta: se o seu perfil não tiver permissão para consultar uma informação ou realizar uma ação, o MCP também não conseguirá executá-la.

Se você trabalha com colaboradores, cada pessoa deve criar e utilizar a própria credencial. Compartilhar uma chave significa permitir que outra pessoa utilize os acessos associados àquele perfil.

Além disso, alguns controles ajudam a manter o uso da integração seguro:

• Chave revogável: você pode revogar uma credencial a qualquer momento pela Plataforma da Hotmart, por exemplo, ao trocar de computador ou quando ela não for mais utilizada. Para isso, acesse Credenciais Hotmart, localize a chave que deseja revogar e exclua a credencial. A revogação é imediata e interrompe o acesso do assistente à sua conta.
• Confirmação de ações: sempre que uma operação alterar dados da conta, como criar um cupom, cancelar uma assinatura ou emitir um reembolso, o assistente apresenta o que será feito e solicita sua confirmação antes de executar.
• Credenciais separadas: se você utiliza o MCP em mais de um dispositivo ou ferramenta, prefira criar uma credencial para cada uso. Isso facilita identificar e revogar apenas o acesso necessário.

Quais cuidados devo ter ao usar o MCP Hotmart?

Para aproveitar o MCP Hotmart com mais segurança e obter respostas mais precisas, considere as recomendações abaixo:

• Faça pedidos específicos. Sempre que possível, informe o período, o produto e o tipo de informação que deseja consultar. Em vez de perguntar apenas “como estão minhas vendas?”, por exemplo, você pode perguntar “quantas vendas fiz do produto X entre 1º e 31 de agosto?”. Quanto mais detalhes você fornecer, mais claro será para o assistente quais dados devem ser considerados.
• Confira informações importantes na Hotmart. O assistente consulta os dados disponíveis na Hotmart, mas pode interpretar filtros, períodos ou critérios de maneira diferente da esperada. Se a informação for usada para uma decisão financeira, contábil ou relacionada a repasses, consulte também os dados diretamente na sua conta da Hotmart.
• Revise as informações antes de confirmar uma ação. Quando você solicitar uma operação que altera dados da conta, confira o resumo apresentado pelo assistente antes de autorizar a execução. Isso é especialmente importante em ações como reembolsos, cancelamentos de assinaturas e criação de cupons.
• Mantenha o assistente atualizado. Utilize versões atualizadas do Claude Desktop, ChatGPT Desktop ou do cliente MCP escolhido. As atualizações podem incluir correções e melhorias que afetam o funcionamento da integração.

Perguntas frequentes

❯ Preciso saber programar para usar o MCP Hotmart?

Não. Para usar o MCP Hotmart no Claude Desktop ou no ChatGPT Desktop, não é necessário saber programar. Já a configuração em IDEs, agentes próprios ou outros clientes MCP pode exigir familiaridade com arquivos de configuração.

❯ Meus colaboradores podem usar o MCP Hotmart?

Sim. Cada colaborador deve criar a própria credencial na Hotmart. O MCP utiliza as permissões vinculadas ao perfil de cada pessoa, por isso o colaborador só poderá consultar informações ou realizar ações para as quais já tenha acesso na conta.

As credenciais são pessoais e não devem ser compartilhadas. Se um colaborador utilizar a credencial de outro perfil, terá acesso às permissões associadas àquela chave.

Se um colaborador não precisar mais utilizar o MCP, o próprio colaborador pode excluir a credencial dele na Hotmart. Caso o Produtor precise cortar o acesso de um colaborador de forma imediata, ele deve desvincular o acesso de colaborador dessa pessoa na conta. Essa ação é suficiente para que a credencial dele deixe de conceder permissões de consulta e execução no MCP.

❯ Meus colaboradores precisam seguir o mesmo passo a passo para usar o MCP Hotmart?

Sim. O processo de configuração é exatamente o mesmo. Cada colaborador deve seguir os passos de instalação e criação da credencial dentro da própria conta de acesso na Hotmart. A diferença está apenas no nível de autorização: o MCP respeita as permissões vinculadas ao perfil de cada pessoa. Ou seja, um colaborador só poderá consultar informações ou realizar ações para as quais já tenha acesso na conta em que atua.

❯ Como desconecto o MCP Hotmart da minha conta?

O processo varia de acordo com o assistente utilizado:

• No Claude Desktop, remova a extensão do MCP Hotmart nas configurações.
• No ChatGPT Desktop, remova o servidor MCP em Configurações > Integrações > Plug-ins.

Para interromper também a autorização de acesso à sua conta, acesse Ferramentas > Ver todas > Credenciais Hotmart na Hotmart, localize a credencial utilizada pelo MCP e exclua-a. A revogação é imediata e interrompe o acesso do assistente à sua conta.

❯ O MCP Hotmart é gratuito?

Sim, o MCP Hotmart não tem custo para Produtores com conta na Hotmart. O único requisito é ter o Claude Desktop ou o ChatGPT Desktop instalado no seu computador.

❯ Preciso ter uma conta paga no assistente de IA (ChatGPT, Claude..) para usar o MCP Hotmart?

Depende do assistente:

• Claude Desktop: funciona com contas gratuitas.
• ChatGPT Desktop: requer um plano pago que dê acesso ao modo Work, onde a configuração do servidor MCP é feita.

Se você usa outros clientes MCP (como IDEs ou agentes próprios), as condições de uso seguem as políticas de cada ferramenta.

❯ A Hotmart armazena dados da minha conversa com o assistente IA?

As conversas ficam armazenadas apenas no próprio assistente (Claude ou ChatGPT), conforme as políticas de cada plataforma. Você pode manter ou excluir o histórico livremente nas configurações da IA. A Hotmart não tem acesso ao conteúdo das conversas, apenas às chamadas feitas à sua API, registradas nos logs padrão da Plataforma.

❯ É seguro conectar minha conta Hotmart a um assistente de IA?

O acesso é feito por uma credencial pessoal criada na sua conta Hotmart e pode ser revogado a qualquer momento. Além disso, o MCP respeita as permissões do seu perfil.

Quando você solicita uma ação que altera informações da conta, como criar um cupom, cancelar uma assinatura ou emitir um reembolso, o assistente apresenta o que será feito e solicita sua confirmação antes de executar a operação.

❯ Posso usar o MCP Hotmart em outros assistentes de IA?

O MCP Hotmart possui configuração documentada para Claude Desktop e ChatGPT Desktop. Também é possível utilizá-lo em IDEs, agentes próprios e outros clientes compatíveis com MCP por meio da configuração manual.

❯ Tenho mais de uma conta Hotmart. Posso usar o MCP em todas elas?

Sim, mas o MCP se conecta a uma conta Hotmart por vez. Para usar outra conta, é necessário substituir, nas configurações do assistente, a credencial vinculada à conta atual pela credencial da outra conta.

❯ Posso consultar informações sobre Afiliados e Coprodutores pelo MCP Hotmart?

O MCP permite consultar algumas informações relacionadas a comissões e participantes das vendas, como dados de comissões e participantes de uma transação. Nem todas as funcionalidades relacionadas à Coprodução e à Afiliação estão disponíveis pelo MCP.

❯ Como meus dados são tratados ao usar o MCP Hotmart?

As consultas feitas pelo MCP acontecem em tempo real, a partir dos dados disponíveis na Hotmart. Para o funcionamento da integração, esses dados não são replicados nem armazenados em uma base externa pela Hotmart.

Segundo as regras da integração, os dados da Hotmart enviados ao assistente para responder a uma solicitação também não são utilizados para treinar modelos de terceiros.