Hotmart MCP Server

Servidor MCP (Model Context Protocol) para integração com APIs da Hotmart. Este servidor permite que agentes de IA gerenciem produtos, vendas e outras operações da Hotmart através de uma interface padronizada.

📋 Sobre

O Hotmart MCP Server é uma implementação do Model Context Protocol que conecta o Claude (e outros LLMs) diretamente às APIs da Hotmart. Desenvolvido com arquitetura modular e suporte a múltiplos transportes (STDIO local e SSE web), oferece uma integração robusta e flexível para automação de operações de produtores digitais.

📋 Pré-requisitos

• Python 3.11 ou superior
• Conta Hotmart com credenciais de API
• uv (recomendado) ou pip para gerenciamento de dependências
• Claude Desktop (para uso local) ou navegador web (para uso SSE)

🚀 Instalação

1. Clonar o Repositório

git clone https://github.com/cajuflow/hotmart-mcp.git
cd hotmart-mcp

2. Instalar Dependências

uv sync

3. Configurar Variáveis de Ambiente

# Copiar arquivo de exemplo
cp .env.example .env

# Editar com suas credenciais
nano .env

Conteúdo do .env:

# Credenciais Hotmart (obrigatório)
HOTMART_CLIENT_ID=seu_client_id_aqui
HOTMART_CLIENT_SECRET=seu_client_secret_aqui
HOTMART_BASIC_TOKEN=seu_basic_token_aqui

# Ambiente da Hotmart (sandbox ou production)
HOTMART_ENVIRONMENT=sandbox

# Configuração MCP (sse ou stdio)
TRANSPORT_TYPE=stdio

# Host e Porta para SSE Transport
MCP_HOST=0.0.0.0
MCP_PORT=8000

⚙️ Configuração Avançada

Host e Porta do Servidor

Para uso com Docker ou SSE transport, configure:

# Docker/Container (aceita conexões externas)
MCP_HOST=0.0.0.0
MCP_PORT=8000

# Local apenas (default)
MCP_HOST=127.0.0.1
MCP_PORT=8000

Uso comum por ambiente:

• Local/STDIO: MCP_HOST=127.0.0.1 (padrão)
• Docker/Container: MCP_HOST=0.0.0.0 (obrigatório)
• Cloud/Produção: MCP_HOST=0.0.0.0 (recomendado)

4. Integração com Claude Desktop

Adicione ao seu claude_desktop_config.json:

stdio:

{
  "mcpServers": {
    "hotmart": {
      "command": "python",
      "args": ["C:/hotmart-mcp/hotmart_mcp.py"],
      "env": {
        "HOTMART_CLIENT_ID":"",
        "HOTMART_CLIENT_SECRET":"",
        "HOTMART_BASIC_TOKEN":"",
        "HOTMART_ENVIRONMENT": "production"
      }
    }
  }
}

5. Executar o Servidor

# Modo STDIO (padrão - Claude Desktop)
uv run python hotmart_mcp.py

# Modo SSE (aplicações web)
TRANSPORT_TYPE=sse uv run python hotmart_mcp.py

6. Docker (Opcional)

# Build da imagem
docker build -t hotmart-mcp .

# Executar container (usa .env automático)
docker run -p 8000:8000 --env-file .env hotmart-mcp

# Testar conectividade
python test_sse_poc.py

Importante: Para Docker, certifique-se que MCP_HOST=0.0.0.0 no .env!

Log esperado (Docker funcionando):

-> Running in SSE mode on 0.0.0.0:8000
INFO:     Uvicorn running on http://0.0.0.0:8000

🛠️ Ferramentas Disponíveis

• get_hotmart_products: Lista produtos da sua conta Hotmart com filtros avançados.
• get_hotmart_sales_history: Obtém histórico de vendas com filtros detalhados.

Testes

uv run python test_runner.py all

🆘 Suporte

• 📧 Email: [email protected]
• 🐛 Issues: GitHub Issues

Desenvolvido com ❤️ pela Cajuflow

Empoderando criadores digitais com soluções inteligentes de automação.