Cotação de energia solar por agente de IA: como o MCP do ionluz funciona

Publicado em 05/09/2026 · atualizado em 25/09/2026 · leitura de 3 min · API e agentes de IA

Um agente de IA que atende no WhatsApp ou no site do integrador precisa cotar solar com o preço certo. O ionluz expõe o motor de orçamento como servidor MCP: o agente conecta, ganha cinco ferramentas e passa a responder "quanto custa um sistema para 500 kWh" com o seu preço e o seu catálogo. Este guia explica o que ele faz e como ligar.

O que é MCP, em uma frase

MCP (Model Context Protocol) é um padrão aberto para um agente de IA descobrir e chamar ferramentas de um serviço externo. O serviço publica as ferramentas com nome, descrição e parâmetros; o agente lê a lista e decide quando usar cada uma. O servidor do ionluz é remoto, por HTTP, e o agente conversa com ele usando a sua chave de API.

As cinco ferramentas

• quote_solar: recebe o consumo mensal em kWh (obrigatório) e, opcionalmente, cidade, UF, tipo de ligação, potência desejada, tarifa, tipo de telhado e os dados do lead. Por padrão só simula. Com persist=true grava a proposta e devolve o link da proposta interativa e do PDF.
• check_coverage: mostra em que faixas de potência e fases a conta usa kit próprio. Nas outras, a cotação sai pelo catálogo padrão, e as marcadas como "não atendo" recusam.
• list_kits: lista os kits disponíveis para a conta, com potência, número de módulos e fases, sem preço de custo.
• get_proposal: traz uma proposta já gravada pelo id, com os links do PDF e da página do cliente. Só com a chave viva.
• coverage_status: diz o que falta para a API responder e o que vale saber da cobertura. Use quando quote_solar voltar com faixa-nao-atendida, fora-da-area ou sem-preco-configurado.

Consentimento antes de gravar

Gravar uma proposta cria um lead com dados pessoais. Por isso persist=true exige consent=true: o agente precisa ter perguntado ao titular e recebido a confirmação de que os dados podem ser registrados. Sem consentimento a ferramenta apenas simula. Uma chave de idempotência opcional garante que, se o agente repetir a chamada, a mesma proposta volta em vez de duplicar o lead.

Como conectar

Em um cliente compatível com MCP remoto por HTTP, aponte para https://app.ionluz.com.br/api/mcp com o cabeçalho de autorização usando a sua chave. O manual em /docs/api traz o bloco de configuração pronto. A listagem de ferramentas e a execução seguem o protocolo padrão, então qualquer cliente compatível conecta sem código próprio.

Limites

• Freio por IP de 300 requisições por minuto, antes da autenticação.
• 120 mensagens por minuto por conta no transporte MCP.
• O mesmo teto de cotações da API REST, porque é o mesmo motor e o mesmo preço.
• Com a chave de teste, a cota de 50 por dia soma as requisições REST e as chamadas de ferramenta; conectar e listar as ferramentas não gasta.

Como usar no atendimento

O padrão que funciona: o agente coleta consumo, cidade e tipo de ligação, cota em modo simulação e apresenta o número com o rótulo de estimativa. Se vier fora-da-area, ele pede o contato do cliente em vez de insistir no preço. Se o cliente quiser a proposta, o agente pede o consentimento, grava com persist=true e envia o link. O integrador recebe o lead no painel, já com o consumo e a proposta gerada.

Checklist

• Chave de API criada no painel e guardada só no cliente MCP
• Recusas tratadas: fora da área vira pedido de contato
• Simulação por padrão; gravação só com consentimento explícito
• Chave de idempotência em toda gravação
• Estimativa rotulada na resposta ao cliente

Com a chave viva (plano Total + API), o agente grava propostas; com a chave de teste, de qualquer plano, ele cota em simulação. Veja a configuração no manual ou o gerador de proposta.