Como conectar o ionluz ao ChatGPT ou ao Claude (MCP)

Leitura de 4 min · verificado em 25/09/2026

Você vai conseguir: ter o seu assistente de IA gerando orçamento de verdade, com o seu preço, dentro da conversa.

MCP é o protocolo que assistentes de IA usam para chamar ferramentas externas. O ionluz tem um servidor MCP pronto: conectado, o assistente ganha cinco ferramentas, quote_solar (gera a cotação a partir do consumo), check_coverage (diz quais faixas têm kit seu; o resto cota pelo catálogo padrão), list_kits (lista os kits da sua conta e do catálogo), get_proposal (traz uma proposta já gravada, com a chave viva) e coverage_status (diz o que falta para a API responder e informa a cobertura). Funciona nos clientes que aceitam servidor MCP remoto com a chave no cabeçalho Authorization, como o Claude Code e os agentes próprios. Conector que só faz login por OAuth ainda não conecta; nesse caso, o caminho é a API REST, com o mesmo resultado.

1. 1 Escolha a chave

   Para testar, use a chave de teste (ilz_test_), em qualquer plano: o agente conecta e simula, sem gravar, com 50 chamadas por dia somando a API REST e as chamadas de ferramenta; conectar e listar as ferramentas não gasta. Para gravar propostas, a chave viva da Máquina. As duas ficam em API e cobertura e aparecem uma vez só: guarde.

2. 2 Cadastre o servidor no seu assistente

   Endereço do servidor: https://app.ionluz.com.br/api/mcp, autenticação pelo header Authorization: Bearer SUA_CHAVE. Em clientes que aceitam configuração em JSON, use:

   {
     "mcpServers": {
       "ionluz": {
         "url": "https://app.ionluz.com.br/api/mcp",
         "headers": { "Authorization": "Bearer SUA_CHAVE" }
       }
     }
   }

   Copiar

   No ChatGPT e no Claude, o cadastro fica nas configurações de conectores ou integrações do próprio assistente, e o caminho muda de versão para versão: procure por "MCP" ou "conector". Conecta quando o cadastro aceita a URL e a chave no cabeçalho; se ele só oferece login por OAuth, sem lugar para a chave, ainda não conecta.

3. 3 Teste com uma pergunta

   Peça ao assistente: "Faça um orçamento solar para 550 kWh/mês em Campinas, SP". Ele chama quote_solar e responde com potência, valor e payback calculados pelo seu ionluz, com a sua tabela e o seu equipamento. Para gravar, o agente chama quote_solar com persist=true e consent=true do titular, com a chave viva; a resposta traz o link da proposta.