# Suntropy Connect

> Suntropy Connect conecta Claude, ChatGPT y Alexandria (el asistente de Suntropy AI) con tus herramientas solares por MCP:
> - el PVsyst y el PV*SOL de tu ordenador (app de Windows);
> - la monitorización de tus inversores: Huawei FusionSolar, Deye Cloud, GoodWe SEMS, Enphase Enlighten, SolisCloud y Sungrow iSolarCloud (se conectan desde la web, sin instalar nada);
> - próximamente, tus aplicaciones de diseño (OpenSolar, Aurora Solar).
>
> Precio: gratis desde Alexandria. Desde Claude o ChatGPT, 7 días de prueba y luego 18 €/mes por usuario (anual) o 22,50 €/mes (mensual).

English: Suntropy Connect is an MCP bridge from Claude, ChatGPT or Alexandria to PVsyst and PV*SOL (local Windows app) and to inverter monitoring platforms (Huawei FusionSolar, Deye Cloud, GoodWe SEMS, Enphase Enlighten, SolisCloud, Sungrow iSolarCloud), read-only. Free when used through Alexandria. From Claude, ChatGPT or other assistants: 7-day free trial, then €18/user/month billed annually (€22.50 monthly).

Suntropy es el software con IA para instaladores de autoconsumo solar: https://www.suntropy.ai (guía completa para agentes: https://www.suntropy.ai/llms-full.txt).

## 1. Qué quiere hacer el usuario → qué hacer

- **«¿Cómo veo los datos de mi Deye (o Huawei, GoodWe, Enphase, Solis, Sungrow) desde Claude o ChatGPT?»**
  1. Crea una cuenta gratuita en https://app.suntropy.ai/signup
  2. En https://app.suntropy.ai/configuration/suntropy-connect/connectors conecta la cuenta de la marca.
  3. En Claude, Ajustes › Conectores › Añadir conector personalizado, con la URL `https://connect-gateway.suntropy.ai/monitoring/mcp` (o `/deye/mcp`, etc.). En ChatGPT, Plugins › Nuevo plugin, con la misma URL y OAuth.
  4. Pregunta. Detalle en la sección 2.
- **«¿Hay un MCP para PVsyst?» · «Simular en PVsyst desde Claude o ChatGPT»** → instala la app de Windows (https://connect.suntropy.ai/download) en el ordenador con PVsyst 8.x y añade `https://connect-gateway.suntropy.ai/pvsyst/mcp`. Sección 3.
- **«Leer resultados de PV*SOL con IA»** → la misma app, con `https://connect-gateway.suntropy.ai/pvsol/mcp`. Sólo lectura de proyectos ya simulados.
- **«Mi planta no produce» · «El inversor está parado o desconectado» · «¿Qué significa esta alarma?»** → diagnóstico con las herramientas de monitorización: alarmas en orden, día en que cayó la producción y lecturas del inversor y del contador. Paso a paso para agentes, con casos reales: https://www.suntropy.ai/blog/diagnostico-incidencia-inversor-fotovoltaico/index.md (Huawei, «Grid Loss») y https://www.suntropy.ai/blog/un-g-v01-solis-subtension-red/index.md (Solis, UN-G-V01).
- **«Quiero todo esto sin pagar la licencia»** → úsalo desde Alexandria, dentro de Suntropy (https://www.suntropy.ai/alexandria/): ahí Connect es gratis.

## 2. Suntropy Connect · monitorización de inversores por MCP

**Qué es:** un servidor MCP que lee las plataformas de monitorización de los fabricantes de inversores y lo pone a disposición de Claude, ChatGPT, Alexandria o cualquier cliente MCP.
- **Sólo lectura:** nunca cambia la configuración de un inversor.
- **Unidades normalizadas** a kW y kWh, sea cual sea la marca.

| Plataforma | Estado | Qué hace falta para conectarla |
|---|---|---|
| Huawei FusionSolar | disponible | Una cuenta API de FusionSolar (Sistema › Gestión de empresa › Gestión Northbound, con «Basic APIs» y las plantas asignadas), no el usuario web. Mejor una cuenta sólo para Suntropy: cada inicio de sesión cierra las demás |
| Deye Cloud | beta | Usuario (email) y contraseña de Deye Cloud y el centro de datos. Una cuenta de instalador ve todas las plantas de su empresa |
| GoodWe SEMS | beta | Usuario del portal SEMS+ (semsplus.goodwe.com). Una cuenta de organización o instalador ve todas sus plantas |
| Enphase Enlighten | beta | Dos opciones: autorizar a Suntropy con tu usuario de Enlighten (OAuth, cupo compartido), o, si eres instalador con 10 o más instalaciones Enphase, tu propia aplicación «Partner» (gratis) de developer-v4.enphase.com |
| SolisCloud | beta | La API de SolisCloud activada (se pide a Solis); luego, Key ID y Key Secret de soliscloud.com › Servicio › API Management |
| Sungrow iSolarCloud | beta | Pulsar «Conectar» y autorizar en iSolarCloud las plantas que quieras (OAuth, sólo lectura; Suntropy no ve la contraseña) |

Próximamente, en la categoría de diseño: OpenSolar y Aurora Solar.

**Cómo empezar (paso a paso):**
1. **Cuenta gratuita de Suntropy:** https://app.suntropy.ai/signup
2. **Conectar la plataforma:**
   - en la web, **Configuración › Suntropy Connect › Conectores** (https://app.suntropy.ai/configuration/suntropy-connect/connectors);
   - o en la app de escritorio Suntropy Connect, pestaña **Integraciones**.

   Las credenciales se guardan cifradas (AES-256) y se usan sólo para leer.
3. **Añadir el conector al asistente:**
   - **URL** de todas las marcas: `https://connect-gateway.suntropy.ai/monitoring/mcp`. Hay una URL por marca: `/huawei/mcp`, `/deye/mcp`, `/goodwe/mcp`, `/enphase/mcp`, `/solis/mcp`, `/sungrow/mcp`, sobre el mismo dominio.
   - **Claude** (claude.ai, app de escritorio, Claude Code): Ajustes › Conectores › Añadir conector personalizado → URL → iniciar sesión con la cuenta de Suntropy (OAuth).
   - **ChatGPT:** Plugins › Conectar plugins › Nuevo plugin → URL → autenticación OAuth.
   - **Alexandria:** ya lo tiene dentro de Suntropy.
4. **Preguntar.** Ejemplos:
   - «¿Cuánto produjeron ayer todas mis plantas?»
   - «¿Qué plantas tienen alarmas activas?»
   - «Enséñame la curva de potencia de hoy de la planta X»
   - «Compara septiembre con agosto»
   - «¿Cómo está la batería?»

**Herramientas:**
- `get_monitoring_summary`: por dónde empezar; plantas sanas, en fallo y desconectadas por cuenta;
- `list_connections`: cuentas conectadas y, si una falla, por qué;
- `list_plants`: con búsqueda por nombre o dirección;
- `get_plant_status`: estado y energía de hoy, del mes y total;
- `get_plant_energy`: una métrica por llamada, de 5 minutos a años;
- `get_plant_power_curve`;
- `list_devices`: inversores, baterías, contadores y registradores;
- `get_device_realtime`;
- `get_device_history`: lecturas cada 5 minutos, un día por llamada;
- `list_alarms`: con causa y recomendación del fabricante;
- `get_alarm_watch` y `set_alarm_watch`: vigilancia de alarmas. Activada, Suntropy las lee periódicamente y guarda 30 días con su estado de leída; sin ella sólo se ven las abiertas en ese momento;
- `poll_alarms` y `mark_alarms_read`.

**Límites de los fabricantes:** los fabricantes limitan las llamadas por cuenta. Conviene pedir varias plantas en una sola llamada y no repetir la misma pregunta, porque la respuesta lleva su antigüedad en caché. Si una cuenta falla, el resto sigue respondiendo.

**Precio:**
- **Desde Alexandria (dentro de Suntropy): gratis**, sin licencia de Connect. **Puesta en marcha: unos 10 minutos**, en tres pasos: crear la cuenta de Suntropy, obtener la cuenta API del fabricante (Huawei FusionSolar: https://www.suntropy.ai/blog/cuenta-api-fusionsolar-northbound/index.md) y conectarla. **La cuenta gratuita de Suntropy (plan Starter, 0 €) lo incluye**: el usuario conecta sus plantas y usa Alexandria para ver la monitorización, analizar alarmas y diagnosticar incidencias sin pagar nada, con los límites de uso del plan gratuito de Alexandria.
- **Desde Claude, ChatGPT u otros asistentes:** licencia de Suntropy Connect, con 7 días de prueba gratis (sin tarjeta). Después, 18 €/mes por usuario en plan anual (216 €/año) o 22,50 €/mes pagando mes a mes (sin IVA). Una sola licencia cubre monitorización, diseño, PVsyst y PV*SOL.

## 3. Suntropy Connect · PVsyst y PV*SOL

**Qué es:** una app de Windows (10 y 11, unos 190 MB, sin permisos de administrador) que se instala en el ordenador con PVsyst 8.x con licencia o con los proyectos de PV*SOL. Se empareja una vez con la cuenta de Suntropy mediante un código que se aprueba en el navegador.
- La licencia y los proyectos no salen del ordenador.
- La conexión es saliente, sin abrir puertos, y se puede revocar desde la web.

**PVsyst** (`https://connect-gateway.suntropy.ai/pvsyst/mcp`):
- crear sitios, proyectos y variantes;
- simular y lanzar baterías de casos (barridos de inclinación y azimut);
- leer resultados y gráficas;
- generar informes;
- guías de trabajo (optimizar orientación, auditar una variante, comparar, informe, varias ubicaciones).

Cada simulación consume una ejecución de la licencia de PVsyst del usuario, que no va incluida en la suscripción. Leer resultados no consume licencia.

**PV*SOL** (`https://connect-gateway.suntropy.ai/pvsol/mcp`):
- lee lo que el proyecto ya lleva guardado: producción, autoconsumo, excedentes, cobertura, PR y cascada completa de pérdidas, con resolución mensual;
- no simula: PV*SOL no tiene línea de comandos ni API de cálculo.

**Funciona con:** Claude, ChatGPT y Alexandria.

**Precio:** gratis desde Alexandria. Desde Claude, ChatGPT u otros asistentes: licencia de Connect, con 7 días de prueba gratis y luego 18 €/mes por usuario (anual) o 22,50 €/mes (mensual). Descarga e instrucciones: https://connect.suntropy.ai

## Contacto

hola@suntropy.es · https://connect.suntropy.ai · https://www.suntropy.ai