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

Publicado em 05/09/2026 · leitura de 6 min

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 duas 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 duas ferramentas

• quote_solar: recebe o consumo mensal em kWh (obrigatório) e, opcionalmente, 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: diz quais faixas de potência a sua conta cobre com kit e preço, para o agente saber o que pode cotar antes de prometer.

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 chave no transporte MCP.
• O mesmo teto de cotações da API REST, porque é o mesmo motor e o mesmo preço.

Como usar no atendimento

O padrão que funciona: o agente coleta consumo, cidade e tipo de ligação na conversa, chama check_coverage, cota em modo simulação e apresenta o número com o rótulo de estimativa. 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
• Cobertura checada antes de cotar
• 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

O servidor MCP faz parte do plano Total + API. Veja a configuração no manual ou o gerador de proposta.