# Zugriff für KI (MCP)

> Wie SOLECTRUS seine Messwerte über das Model Context Protocol an Claude, ChatGPT oder ein lokales KI-Tool ausliefert, und wie der Zugang gesichert ist.

SOLECTRUS kann seine Daten an einen KI-Client ausliefern, der sie dann in natürlicher Sprache auswertet. Dazu dient das [Model Context Protocol](https://modelcontextprotocol.io) (MCP), das Claude, ChatGPT und lokale Werkzeuge wie LM Studio sprechen. Fragen wie „Läuft nachts etwas, das besser aus wäre?" oder „Zieht die Wärmepumpe mehr als letzten Winter?" beantwortet die KI damit aus den eigenen Messwerten.

> **Nur mit Sponsoring**
>
>
> Der KI-Zugriff erfordert ein aktives [Sponsoring-Abo](https://solectrus.de/sponsoring/).
>

Der Zugriff ist **ausschließlich lesend**. Eine KI kann keine Einstellungen ändern, keine Messwerte schreiben und keine Zahlungen anlegen.

## Freischalten

Die Schnittstelle ist ab Werk abgeschaltet. Der Administrator aktiviert sie unter _Einstellungen → Allgemein → Zugriff für KI_. Darunter erscheint anschließend die Endpunkt-URL, die der KI-Client braucht:

```
https://beispiel.de/mcp
```

Solange der Schalter aus ist, existiert die Schnittstelle für die Außenwelt nicht: Der Endpunkt und die gesamte Anmeldung antworten wie eine unbekannte Adresse mit einem 404.

## Anmeldung

Der Zugang ist mit OAuth 2.1 geschützt. Der KI-Client leitet einmalig auf eine Seite der eigenen SOLECTRUS-Instanz weiter, auf der das **Admin-Passwort** einzugeben ist. Ein weiteres Passwort, ein Konto oder ein API-Schlüssel sind nicht nötig. Die Seite nennt vorher, welcher Client den Zugriff erhält.

Eine Freigabe gilt **90 Tage**, unabhängig davon, wie oft der Client in der Zwischenzeit nachlädt. Danach fragt er erneut nach dem Passwort.

## Zugang beenden

Beide Wege trennen sämtliche verbundenen Clients auf einmal:

- **Das Admin-Passwort ändern.** Es ist das einzige Merkmal, das diese Anmeldung prüft, und eine Änderung entwertet jede erteilte Freigabe.
- **Den Schalter unter _Einstellungen → Allgemein_ ausschalten.** Dabei wechselt der Schlüssel, mit dem die Freigaben signiert sind. Ein späteres Wiedereinschalten holt alte Verbindungen nicht zurück.

Einzelne Clients lassen sich nicht abmelden. Die Freigaben sind zustandslos und werden nicht gespeichert, deshalb gibt es auch keine Liste verbundener Clients.

## Wo der KI-Client läuft

Entscheidend ist, von wo aus der Client die Verbindung aufbaut, nicht der Browser des Nutzers:

| Client                             | Verbindung kommt aus | Erreichbarkeit                  |
| ---------------------------------- | -------------------- | ------------------------------- |
| claude.ai im Browser, Claude mobil | Anthropics Cloud     | öffentliche HTTPS-Adresse nötig |
| ChatGPT, Web wie Desktop           | OpenAIs Cloud        | öffentliche HTTPS-Adresse nötig |
| Claude Desktop, lokale Werkzeuge   | eigener Rechner      | Adresse im lokalen Netz genügt  |

Läuft SOLECTRUS bereits unter einer eigenen Domain und ist von außen über HTTPS erreichbar, ist nichts weiter zu tun: Die Endpunkt-URL wird als Connector im KI-Client hinterlegt, das war es. HELIOS richtet die Domain samt Zertifikat ein, siehe [`APP_HOST`](/docs/referenz/dashboard/allgemeine-konfiguration/#app_host).

Ist die Instanz nur im lokalen Netz erreichbar, bleiben zwei Wege. Entweder wird sie über einen Reverse Proxy oder einen Cloudflare-Tunnel per HTTPS veröffentlicht. Oder es kommt ein Client zum Zuge, der auf dem eigenen Rechner läuft, etwa Claude Desktop. Der spricht die lokale Adresse direkt an, auch ohne HTTPS.

### Claude Desktop

Claude Desktop bindet die Schnittstelle über [`mcp-remote`](https://www.npmjs.com/package/mcp-remote) ein, das die Anmeldung übernimmt und dafür kurz den Browser öffnet:

```json title="claude_desktop_config.json"
{
  "mcpServers": {
    "solectrus": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://beispiel.de/mcp"]
    }
  }
}
```

Zeigt der Eintrag auf eine Adresse im lokalen Netz ohne HTTPS, kommt `--allow-http` als weiteres Argument dazu:

```json title="claude_desktop_config.json"
{
  "mcpServers": {
    "solectrus": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "http://192.168.1.42:3000/mcp", "--allow-http"]
    }
  }
}
```

## Was die KI zu sehen bekommt

Die Schnittstelle liefert dieselben Daten, die auch das Dashboard zeigt:

- die konfigurierten Sensoren mit ihren aktuellen Werten
- Summen, Zeitreihen und Top-10-Ranglisten für beliebige Zeiträume
- die Prognose der kommenden Tage
- Strompreise und Einspeisevergütung samt ihrer Historie
- Angaben zur Anlage, etwa Inbetriebnahme, Währung und Zeitzone
- die [Amortisationsrechnung](/docs/bedienung/amortisation/) mit den erfassten Zahlungen

Der letzte Punkt ist bei der Entscheidung zu bedenken: Wer den Zugriff freischaltet, gibt auch die Investitionen und Kosten der Anlage an den KI-Anbieter weiter.