Auf dieser Seite

KI-Assistenten verbinden

Sie können den Stromverbrauch eines Kunden in Ihrem KI-Assistenten auswerten. Dafür verbinden Sie ihn mit dem MCP-Server von Energiedaten. Diese Anleitung zeigt, wie Sie die Verbindung einrichten, einen Standort auswerten und die verfügbaren Werkzeuge nutzen. Einen Überblick finden Sie unter KI-Verbindungen.

Voraussetzungen

Sie benötigen ein Energiedaten-Konto und müssen Mitglied des gewünschten Teams sein. Für dieses Team muss der API-Zugriff verfügbar sein. Welche Werkzeuge Ihr Assistent nutzen kann, hängt vom Funktionsumfang des Teams ab: Lastganganalysen und Benchmarks setzen die erweiterte Analyse voraus. Für Abfragen zu Kunden und Standorten müssen die jeweiligen Funktionen verfügbar sein.

Ihr KI-Client muss Remote-MCP über HTTP und die Zugriffsfreigabe per OAuth im Browser unterstützen. Prüfen Sie, ob Sie mit Ihrem Konto eigene MCP-Verbindungen einrichten können. Ein Client, der ausschließlich lokale MCP-Server ausführt, kann diese URL nicht direkt verwenden.

Für ChatGPT brauchen Sie die Desktop-App. Die hier beschriebene direkte Verbindung mit Energiedaten ist in ChatGPT im Browser und in den mobilen Apps nicht verfügbar.

Wenn Sie Energiedaten neu nutzen, erstellen Sie ein Konto und folgen Sie den Ersten Schritten, um einen Zähler zu verbinden. Eine KI-Verbindung erzeugt keine Messwerte. Wählen Sie für die erste Auswertung einen verbundenen Stromzählpunkt mit Daten im gewünschten Zeitraum. Für aussagekräftige Leistungsprofile brauchen Sie Messwerte in stündlichen oder kürzeren Abständen.

Assistenten verbinden

Wählen Sie Claude im Web, ChatGPT und Codex am Desktop oder einen anderen MCP-Client.

Claude im Web

Öffnen Sie in Claude Settings, dann Connectors. Wählen Sie Add connector und anschließend Add custom connector.
Geben Sie einen Namen wie energiedaten.at und die Server-URL https://energiedaten.at/mcp ein. Wählen Sie Continue.
Lassen Sie nach der Serverprüfung die Authentifizierung auf Always required. Wählen Sie unter OAuth client die Option No client ID — register one automatically.
Wählen Sie Add, dann Connect. Melden Sie sich bei energiedaten.at an, wählen Sie das gewünschte Team und prüfen Sie die angeforderten Berechtigungen, bevor Sie den Zugriff freigeben.
Kehren Sie zu Claude zurück und öffnen Sie einen Chat. Prüfen Sie die Verbindung mit der Frage weiter unten. Wenn Claude um Erlaubnis für eine Abfrage bittet, prüfen Sie die Anfrage und wählen Sie Allow once, um sie einmalig zu erlauben.

Die genannten Schaltflächen entsprechen der englischen Claude-Oberfläche.

ChatGPT und Codex am Desktop

Öffnen Sie die ChatGPT-Desktop-App. Die Desktop-App und Codex verwenden dieselbe MCP-Konfiguration auf Ihrem Computer.

Öffnen Sie Settings, dann MCP servers, und wählen Sie Add server.
Geben Sie Energiedaten als Namen ein. Wählen Sie Streamable HTTP und tragen Sie https://energiedaten.at/mcp als Server-URL ein.
Speichern Sie mit Save und starten Sie die App neu.
Wählen Sie Authenticate, um die OAuth-Anmeldung zu starten. Melden Sie sich bei Energiedaten an, wählen Sie das gewünschte Team und geben Sie den Zugriff frei.
Öffnen Sie einen Chat und prüfen Sie die Verbindung mit der Frage weiter unten.

Die genannten Schaltflächen entsprechen der englischen Oberfläche. Weitere Hinweise finden Sie in der MCP-Anleitung von OpenAI.

Ein anderer MCP-Client

Die folgenden Schritte beschreiben den allgemeinen Ablauf. Bezeichnungen und Verbindungseinstellungen können je nach Client abweichen.

Fügen Sie in den Verbindungseinstellungen Ihres KI-Clients einen Remote-MCP-Server hinzu. Je nach Client heißt diese Einstellung Connector, Integration oder MCP-Server.
Geben Sie der Verbindung einen Namen, etwa Energiedaten, und tragen Sie diese Server-URL ein:
Text
```
https://energiedaten.at/mcp
```
Starten Sie die Verbindung per OAuth im Client. Melden Sie sich im geöffneten Browserfenster bei Energiedaten an.
Wählen Sie das Team, auf dessen Daten der Assistent zugreifen soll. Prüfen Sie die angeforderten Berechtigungen und die Hinweise zu Kundendaten und deren Verarbeitung durch Ihren KI-Anbieter. Geben Sie anschließend den Zugriff frei.
Kehren Sie zum KI-Client zurück. Aktivieren Sie die Verbindung für Ihren Chat, falls der Client dies verlangt.

Fragen Sie Ihren Assistenten:

Zeige mir über Energiedaten, welches Team verbunden ist. Liste danach dessen Zählpunkte mit den verfügbaren Datenzeiträumen auf.

Der Assistent kann dafür whoami und list-metering-points verwenden. Prüfen Sie vor der nächsten Abfrage den Teamnamen. Ein Teamwechsel in der Energiedaten-App ändert die KI-Verbindung nicht. Geben Sie den Zugriff erneut frei, um dabei ein anderes Team auszuwählen.

Den Stromverbrauch eines Standorts auswerten

Wählen Sie einen Standort oder Zählpunkt aus der Liste und einen Zeitraum, für den Daten verfügbar sind. Ersetzen Sie die Platzhalter in den eckigen Klammern:

Werte den Stromverbrauch von [Standortname] zwischen [Startdatum] und [Enddatum] aus. Zeige die Verbrauchsmuster an Werktagen und Wochenenden sowie die größten Lastspitzen mit Datum und Zählpunkt. Nenne Datenlücken, die die Analyse einschränken. Gib zu jedem Ergebnis die Einheit und den ausgewerteten Zeitraum an.

Der Assistent kann Verbrauchssummen, Lastprofile, Lastspitzen und Angaben zur Datenabdeckung gemeinsam auswerten. Fragen Sie zu einem bestimmten Tag nach oder vergleichen Sie zwei Zeiträume, die Sie in der Frage angeben. Prüfen Sie die Zahlen und die Hinweise zur Aussagekraft, bevor Sie die Antwort in einem Kundengespräch verwenden.

Clients mit Unterstützung für MCP-Promptvorlagen können außerdem site-deep-dive anbieten. Mit dieser Vorlage wertet der Assistent Verbrauch, Grundlast, Tagesprofil, Heatmap und Lastspitzen aus und zieht einen Benchmark heran, sofern dieser verfügbar ist. Der Assistent formuliert seine Antwort anhand der abgefragten Ergebnisse. Der Server liefert weder die Ursache einer Lastspitze noch einen fertigen Analysebericht.

Standorte vergleichen oder Datenqualität prüfen

Für einen Standortvergleich können Sie fragen:

Vergleiche den Stromverbrauch meiner Standorte zwischen [Startdatum] und [Enddatum]. Zeige auch Einspeisung und Energiebilanz, soweit Daten dazu vorliegen. Kennzeichne unvollständige Daten, bevor du die Standorte nach Verbrauch reihst.

Für eine Prüfung der Datenqualität:

Prüfe die verbundenen Zählpunkte für [Kunde oder Standort] zwischen [Startdatum] und [Enddatum]. Zeige je Zählpunkt die Datenabdeckung, die Verteilung der Qualitätsstufen und den Zeitpunkt der letzten Datenlieferung. Welche Lücken schränken einen Vergleich ein?

Die Promptvorlagen portfolio-review und data-quality-check führen durch diese Abläufe, wenn Ihr Client Prompts unterstützt. In Clients, die nur Werkzeuge anbieten, können Sie die Fragen direkt stellen.

Werkzeugreferenz

Ihr Client listet die für das verbundene Team verfügbaren Werkzeuge auf. Dieser Katalog ordnet die Werkzeuge des Servers nach Aufgabe.

Aufgabe	Werkzeuge	Ergebnis
Passende Daten finden	`whoami`, `list-customers`, `list-locations`, `list-metering-points`	Verbundenes Team, Kunden- und Standortnamen, Zählpunkte, Verbindungsstatus und abfragbare Datenzeiträume.
Verbrauch auswerten	`get-consumption-summary`, `get-consumption-series`	Energiesummen und Zeitreihe; Leistungswerte, sofern die Messintervalle sie ermöglichen.
Lastverlauf verstehen	`get-load-summary`, `get-day-profile`, `get-load-heatmap`, `get-load-duration-curve`	Grundlast, Lastfaktor, Werktags- und Wochenendprofile, Muster nach Wochentag und Stunde sowie Verteilung der Leistungswerte.
Spitzen prüfen und vergleichen	`get-peak-events`, `get-benchmark`, `get-energy-balance`	Lastspitzen einzelner Zählpunkte mit Zeitstempel, Gebäudebenchmark bei ausreichender Datengrundlage sowie Verbrauch, Einspeisung und Bilanz je Standort.
Datenqualität beurteilen	`get-data-coverage`	Datenabdeckung, Anzahl der Werte je Qualitätsstufe und Informationen zur letzten Datenlieferung für die ausgewählten Zählpunkte.

Ergebnisse richtig lesen

Energie wird in kWh, Leistung in kW angegeben. Stromlastprofile benötigen geeignete Intervallwerte; Gas- und Tageswerte ermöglichen nicht dieselben Analysen. Die Grundlast ist das fünfte Perzentil der Lastdauerlinie: jener Leistungswert, der mindestens 95 % der Zeit überschritten wird. Die Lastspitze eines einzelnen Zählpunkts ist von der höchsten gleichzeitigen Gesamtleistung aller Zählpunkte am Standort zu unterscheiden.

Prüfen Sie den angegebenen Zeitraum, die Zeitzone und die Datenabdeckung. Für die Ergebnisse gilt die Zeitzone Europe/Vienna. Der ausgewertete Zeitraum kann kürzer sein als angefragt. Er hängt davon ab, wie lange die Daten gespeichert werden, für welchen Zeitraum der Zugriff freigegeben ist und in welchen Abständen Messwerte vorliegen. Eine Abfrage umfasst höchstens 366 Tage. Zeitreihen können zu größeren Intervallen zusammengefasst werden, damit die Datenmenge pro Antwort begrenzt bleibt.

Fehlende Messwerte werden als null ausgegeben. Das bedeutet, dass kein Messwert vorliegt; ein gemessener Verbrauch von null wird als Zahlenwert erfasst. Auch innerhalb eines abfragbaren Zeitraums können Daten für einzelne Tage fehlen. Die Qualitätsangaben unterscheiden gemessene Werte (L1), zuverlässige Ersatzwerte (L2) und unzuverlässige Schätzwerte (L3). Für einen Gebäudebenchmark müssen die nötigen Gebäudeinformationen und ausreichend Messdaten vorliegen.

Probleme beheben

Beobachtung	Was Sie prüfen können
Das Fenster zur Zugriffsfreigabe öffnet sich nicht	Prüfen Sie, ob Ihr Client Remote-MCP über HTTP und OAuth unterstützt und ob die Server-URL vollständig ist. Folgen Sie der Anleitung Ihres Clients zum Einrichten eigener Verbindungen.
Die Zugriffsfreigabe oder eine Abfrage wird abgelehnt	Prüfen Sie Ihre Mitgliedschaft im ausgewählten Team und dessen API-Zugriff. Verbinden Sie den Client erneut, wenn die Freigabe abgelaufen oder widerrufen ist.
Der Assistent zeigt das falsche Team	Geben Sie den Zugriff erneut frei und wählen Sie dabei das gewünschte Team.
Ein Werkzeug oder Prompt fehlt	Prüfen Sie den Funktionsumfang für erweiterte Analyse, Standorte oder Kunden. Aktualisieren Sie nach einer Änderung die Werkzeugliste im Client.
Ein Zählpunkt wird angezeigt, lässt sich aber nicht auswerten	Prüfen Sie seinen Verbindungsstatus und wählen Sie einen Zeitraum, für den Daten verfügbar sind. Folgen Sie bei fehlender Verbindung der Anleitung Zähler verbinden.
Ergebnisse sind leer, unvollständig oder enthalten keine Leistungswerte	Fragen Sie nach Datenabdeckung und ausgewertetem Zeitraum. Prüfen Sie, ob Messwerte vorliegen und deren Intervalle die gewünschte Analyse ermöglichen.
Abfragen werden wegen eines Anfragelimits abgelehnt	Warten Sie vor dem nächsten Versuch und reduzieren Sie wiederholte Abfragen.

Zugriff und Widerruf

Über die Verbindung kann der Assistent die verfügbaren Daten des freigegebenen Teams lesen. Dazu gehören auch die dort verwalteten Kunden- und Standortinformationen. Ihr KI-Anbieter verarbeitet die abgefragten Daten nach seinen Bedingungen. Prüfen Sie vor dem Verbinden diese Bedingungen und ob Sie die Kundendaten weitergeben dürfen.

Um den Zugriff zu widerrufen, öffnen Sie das freigegebene Team in Energiedaten und wählen Sie unter Konto den Eintrag Verbundene Apps. Wählen Sie bei der Verbindung Widerrufen und bestätigen Sie den Vorgang. Wenn Sie die Verbindung später wieder nutzen möchten, geben Sie den Zugriff im KI-Client erneut frei. Chats und bereits übermittelte Daten verwalten Sie bei Ihrem KI-Anbieter.