MCP-Server: Digital-Simon in Claude, Cursor & Co.

So funktioniert es

Dein KI-Client stellt die Frage – der MCP-Server liest die Anlage und gibt die Antwort zurück. Kein Umweg über Exporte oder Screenshots.

Abfrage: dein Client (Claude, Cursor, n8n oder eigener Agent) ruft mit deinem API-Key an.
Server: Digital-Simon holt Geräte, Messwerte und Zeitverläufe aus deinem Konto.
Antwort: Messwerte und Auswertungen gehen zurück – und bei ausdrücklicher Freigabe auch Aktionen.

Der API-Key entscheidet, welche Daten dein Client sieht; die Trennung zwischen Kunden passiert serverseitig.

Schaubild: Dein KI-Client (Claude, Cursor, n8n, eigener Agent) fragt den Digital-Simon MCP-Server ab; der Server liest die Anlage (PV, Speicher, Verbrauch, Wärmepumpe, Wallbox) und liefert Ergebnisse und Aktionen zurück. — KI-Client → MCP-Server → Anlage: Fragen, Analysieren, Entscheiden, Handeln.

Was MCP ist – und was wir damit machen

MCP (Model Context Protocol) ist ein offener Standard, über den KI-Assistenten Werkzeuge ansprechen: Der Assistent fragt, das Werkzeug antwortet. Statt Daten aus Screenshots oder Tabellen abzuschreiben, greift er direkt auf die Quelle zu.

Wir stellen unsere Plattform als MCP-Server bereit. Der Zugang läuft über deinen Konto-API-Key, die Trennung zwischen Kunden passiert serverseitig: Ein Key sieht genau die Geräte und Projekte seines Kontos.

Werkzeuge für Geräte, Messwerte und Zeitverläufe

Werkzeug	Was es tut
`list_instances`	Alle verbundenen Geräte mit Status, Projekt, letztem Abruf und Fehler
`get_latest_metrics`	Aktuelle Messwerte einer Anlage – der neueste Wert je Messgröße
`get_metrics_history`	Zeitverlauf (Standard sieben Tage, Zeitraum und Messgrößen frei wählbar)
`poll_instance`	Messwerte sofort neu abrufen
`test_instance`	Verbindung prüfen: Status, letzter Fehler, Anzahl aktueller Werte
`list_connectors`	Katalog der Geräte-Vorlagen (Hersteller, Kategorie)
`send_command`	Schalten – nur bei Geräten, bei denen „Schalten erlauben“ aktiv ist

Nur Lesen oder auch Schalten entscheidest du pro Gerät. Ohne Freigabe wird ein Schaltbefehl abgelehnt.

So bindest du es an

1 · Freigabe

In Digital-Simon unter Profil → API-Zugang das Häkchen „MCP-Zugang“ setzen. Ohne Häkchen wird jeder MCP-Aufruf abgelehnt – jederzeit wieder abschaltbar.

2 · API-Key kopieren

Direkt darunter steht dein Konto-API-Key. Er wirkt wie ein Passwort: bei Bedarf einen neuen erzeugen – der alte wird sofort ungültig.

3 · Client eintragen

Zwei Angaben im MCP-fähigen Client hinterlegen – Endpunkt und Key (Fenster unten). Fertig – der Assistent kennt deine Geräte.

Endpunkt und Konfiguration (Darstellung je Client leicht unterschiedlich):

{
  "mcpServers": {
    "digital-simon": {
      "url": "https://mcp.umweltsicherheit.org/mcp",
      "headers": { "X-API-Key": "<dein Konto-API-Key>" }
    }
  }
}

Wo genau eintragen?

Diese zwei Angaben gehören nicht in Digital-Simon, sondern in die KI, die sich verbinden soll. Die Stelle heißt je nach Programm anders:

Claude (Desktop oder Web): Einstellungen → Connectors → Add custom connector – URL eintragen, unter Request headers den Header X-API-Key anlegen.
Cursor: Einstellungen → MCP → Add new MCP server (oder die Datei ~/.cursor/mcp.json).
n8n: Node MCP Client Tool → Credential „MCP Client" → URL und Header.
VS Code · Cline · Windsurf: eigene MCP-Einstellungen, gleiches Schema wie oben.

      url:https://mcp.umweltsicherheit.org/mcp ← der Endpunkt
      headers:X-API-Key: <dein Konto-API-Key> ← der Schlüssel
    

Mehr braucht es nicht: diese zwei Felder trägst du in der KI ein, die sich verbinden soll – fertig.

Transport: Streamable HTTP (POST auf /mcp). Alternativ kann der Key als Authorization: Bearer … übergeben werden.

Was dabei herauskommt

„Welche Anlagen liefern gerade keine Daten?“

Antwort mit Status, Projekt und letztem Abruf je Gerät – aus dem Muster-Projekt: drei Geräte, zwei aktiv, eines seit Tagen ohne Werte.

„Wie lädt der Speicher heute?“

Antwort mit Messwerten: Batterieladung 84 %, 167 W Ladung, 119 W gehen direkt ins Haus – die Zahlen kommen aus der Anlage, nicht aus einer Schätzung.

„Wie war der Verbrauch in den letzten sieben Tagen?“

Zeitverlauf über get_metrics_history – der Assistent rechnet daraus Summen, Mittelwerte und Vergleiche.

Die Beispiele stammen aus dem Demo-Projekt „Familie Huber – PV & Speicher“ (Muster-Daten).

Sicherheit und Grenzen

Zugang nur mit Freigabe: MCP ist am Konto ausdrücklich zu aktivieren und jederzeit abzuschalten. Ein neuer API-Key ändert die Freigabe nicht.
Trennung zwischen Kunden: Jeder Aufruf läuft mit dem Key des Aufrufers – sichtbar sind nur die eigenen Projekte und Geräte.
Schalten nur mit Erlaubnis: send_command funktioniert ausschließlich bei Geräten mit „Schalten erlauben“ und nicht, solange ein Gerät pausiert ist.
Key wie ein Passwort behandeln: nicht in Chats, Screenshots oder öffentliche Repositories legen.
Keine fachliche Freigabe: Der MCP-Zugang ersetzt keine Planung, Installation oder Prüfung durch einen Fachbetrieb.

Für KI-Assistenten und Verzeichnisse

Diese Angaben sind bewusst als Text formuliert, damit Assistenten und Verzeichnisse sie übernehmen können.

Server: Digital-Simon EMS (Umweltsicherheit, Linz, Österreich)
Endpunkt: https://mcp.umweltsicherheit.org/mcp
Transport: Streamable HTTP (MCP-Protokoll 2024-11-05), stateless
Authentifizierung: Konto-API-Key per X-API-Key oder Authorization: Bearer; Freigabe am Konto („MCP-Zugang“)
Werkzeuge: list_instances, get_latest_metrics, get_metrics_history, poll_instance, test_instance, list_connectors, send_command
Daten: Energiemanagement-Messwerte (PV-Erzeugung, Verbrauch, Speicher, Netzbezug), Gerätestatus, Zeitverläufe
Einstieg: Konto in Digital-Simon anlegen, Profil → API-Zugang → „MCP-Zugang“ aktivieren
Kurzfassung für Assistenten: siehe llms.txt