← Voltar ao início

MCP ePowerBay BETA

Este endereço é um servidor MCP (Model Context Protocol): ele permite que o seu agente de IA — Claude, ChatGPT e outros — consulte os dados do setor elétrico brasileiro da plataforma ePowerBay em seu nome, respeitando a sua assinatura. Não é uma página para navegar: quem fala com o MCP é o agente.

Como conectar

• claude.ai / Claude Desktop: Configurações → Conectores → Adicionar → Adicionar conector personalizado → cole a URL acima → faça login e clique Autorizar.
• Claude Code: claude mcp add --transport http epowerbay https://app2.epowerbay.com/mcp e depois /mcp → Autenticar.
• ChatGPT: Configurações → Apps → Configurações avançadas → ative o Modo desenvolvedor; depois Configurações → Conectores → Criar → preencha nome, descrição e cole a URL acima; o fluxo de autorização abre no navegador.
• Outros clientes MCP: adicione um servidor remoto (Streamable HTTP) com a URL acima e siga o fluxo de autorização do próprio cliente.

Sem conta? Entre ou cadastre-se aqui. O acesso do agente é sempre de leitura e nunca enxerga mais do que o seu usuário.

O que o agente consegue fazer

Dados tabulares — consultas aos datasets do setor elétrico:

Tool	Para quê
listar_datasets	Ver os conjuntos de dados disponíveis (geração, transmissão, distribuição, comercialização...)
descrever_dataset	Conhecer as colunas, operadores de filtro, consultas/modificadores prontos e como a plataforma consulta o dataset
consultar_dataset	Buscar dados com filtros, ordenação, agregações, paginação e atalhos do backend (consultas nomeadas e modificadores)

Camadas do mapa — visualização geoespacial (usinas, subestações, linhas de transmissão, restrições ambientais, BDGD...), sem extração de dados em massa:

Tool	Para quê
listar_camadas	Encontrar as camadas geoespaciais disponíveis
descrever_camada	Conhecer as colunas/atributos de uma camada
gerar_imagem_area_camadas	Gerar a imagem do mapa de uma região com as camadas escolhidas
consultar_info_ponto_camada	Consultar os atributos das feições em um ponto (lat/lon)

Janela do mapa — o agente controla o mapa no seu navegador. Para isso, mantenha uma aba da plataforma aberta (logado): o agente solicita acesso e um aviso aparece na aba — clique nele para abrir o mapa e liberar os comandos:

Tool	Para quê
solicitar_acesso_mapa	Mostrar o aviso na sua aba pedindo acesso ao mapa — clique para abrir
ajustar_visualizacao_mapa	Centralizar e/ou ajustar o zoom do mapa
alternar_visibilidade_camada_mapa	Ligar e desligar camadas no mapa aberto
filtrar_camada_mapa	Aplicar filtros a uma camada (aparecem no painel de filtros)
alterar_opacidade_camada_mapa	Mudar a opacidade de uma camada (0 a 1)
mudar_fundo_mapa	Trocar o mapa de fundo (satélite, ruas, claro...)
importar_ao_mapa	Importar um KML/KMZ público por URL como camada
exportar_do_mapa	Download de camadas — reservado para planos superiores (desativado)

Exemplos de uso (o agente faz isso sozinho)

Pergunta: "Quantas usinas de geração distribuída existem no Ceará?"

consultar_dataset(
    dataset="dis_aneel_usina_gd",
    filtros=[{"coluna": "cidade__uf_sigla", "operador": "igual", "valor": "CE"}],
    tamanho_pagina=1
)  → paginacao.total_linhas

Pedido: "Abre no mapa as linhas EPE filtradas pelo agente CTEEP."

solicitar_acesso_mapa()  → você clica no aviso que aparece na sua aba
filtrar_camada_mapa(
    layer="map_tra_epe_linha_existente",
    filtros=[{"coluna": "concession", "operador": "contem", "valor": "CTEEP"}]
)  → a camada abre no mapa com o filtro aplicado

Limites

Chamadas — toda vez que o agente usa uma ferramenta (qualquer uma das tools acima) conta como uma chamada: 20/hora no plano gratuito, 600/hora para assinantes.

Consultas a dataset (consultar_dataset) — cada página de resultado traz no máximo 30 linhas no plano gratuito e 200 para assinantes, e a busca no banco é interrompida se passar de 15 segundos.

Atenção: limites válidos durante a fase beta — estes limites poderão ser alterados sem aviso prévio.

Você pode revogar o acesso de um agente a qualquer momento na sua conta.