messpunkt.io KI-Assistent verbinden
Preview V1 in Vorbereitung (1.0.0-rc.3) — der Server für KI-Assistenten geht zusammen mit der Produktions-Schnittstelle live.
Anleitung für Vermieter

Mit Claude, ChatGPT oder Codex verbinden

Frag deinen eigenen KI-Assistenten nach deinen Liegenschaften, Verbräuchen und Geräten, zum Beispiel: „Wie hoch war der Wärmeverbrauch 2025 in der Musterstraße 12?“ Der Assistent liest dafür dieselben Daten, die du im Vermieter-Portal siehst.

Live seit 30. September 2026. Der Zugang wird je Kundenkonto freigeschaltet. Schreib uns dafür an kontakt@messpunkt.io. Ohne Freischaltung zeigt dir die Anmeldung einen Hinweis statt der Freigabe. Neuigkeiten stehen im Changelog.

Was du brauchst

  • Dein Konto im Vermieter-Portal. Du meldest dich beim Verbinden mit denselben Zugangsdaten an.
  • Freigeschalteter API-Zugang für deinen Kunden. Der Zugang gehört zu deinem Vertrag mit messpunkt.io und wird je Kunde freigeschaltet. Fehlt die Freigabe, zeigt die Anmeldeseite „Verbindung noch nicht freigeschaltet“ an, und es werden keine Daten geteilt. Wende dich in dem Fall an kontakt@messpunkt.io.
  • Einen KI-Assistenten, der „Connectoren“ oder „MCP-Server“ einbinden kann. Das sind zum Beispiel Claude (im Browser, in der App oder als Claude Code), ChatGPT und Codex.

Diese Adresse trägst du im Assistenten ein:

https://mcp.messpunkt.io/v1

Schritte je Assistent

Jeder Abschnitt trennt zwei Dinge: Was wir bei messpunkt.io selbst geprüft haben, und was aus der Anleitung des Anbieters stammt und mit messpunkt.io noch nicht geprüft ist. Die Menüs der Anbieter ändern sich gelegentlich. Wenn ein Menüpunkt anders heißt, sieh in der verlinkten Anbieter-Hilfe nach.

Claude (claude.ai, Claude Desktop)

  1. Öffne Anpassen › Connectoren („Customize › Connectors“).
  2. Klicke auf + und dann auf Benutzerdefinierten Connector hinzufügen („Add custom connector“).
  3. Gib als Adresse https://mcp.messpunkt.io/v1 ein. Die „Erweiterten Einstellungen“ lässt du leer.
  4. Klicke auf Hinzufügen und danach auf Verbinden. Es öffnet sich die messpunkt.io-Anmeldung (siehe Was beim Verbinden passiert).

Bei Claude Team und Enterprise muss zuerst ein Organisations-Owner den Connector unter Organisationseinstellungen › Connectoren anlegen. Danach verbindet sich jedes Mitglied selbst über Anpassen › Connectoren. Quelle: Claude-Hilfe zu Custom Connectors.

Bei uns geprüft

  • Noch nichts, was speziell Claude betrifft.

Noch nicht geprüft

  • Der ganze Ablauf mit claude.ai gegen den laufenden messpunkt.io-Server.
  • Dass claude.ai sich bei uns ohne eigene Client-ID anmeldet. Laut Anthropic geht das mit dem Verfahren, das unser Anmeldeserver anbietet (Anthropic-Doku zur Anmeldung von Connectoren); live ausprobiert haben wir es noch nicht.

Claude Code (Terminal)

  1. Füge den Server hinzu:
    claude mcp add --transport http --scope user messpunkt https://mcp.messpunkt.io/v1
    Mit --scope user steht messpunkt.io dir in jedem Ordner zur Verfügung. Ohne diese Angabe gilt der Eintrag nur für den Ordner, in dem du den Befehl ausführst.
  2. Starte die Anmeldung in Claude Code mit /mcp (oder im Terminal mit claude mcp login messpunkt). Dein Browser öffnet die messpunkt.io-Anmeldung.
  3. Nach dem Zustimmen kehrt der Browser zu Claude Code zurück. Die Anmeldung ist damit gespeichert.

Quelle: Claude-Code-Dokumentation zu MCP.

Bei uns geprüft

  • Der ganze Ablauf gegen den laufenden messpunkt.io-Server (30.09.2026): Anmeldung, Freigabe, Abfragen von Liegenschaften, Verbräuchen und Gerätestatus.
  • Die Rückleitungsadresse, die Claude Code benutzt (http://localhost:PORT/callback, mit wechselndem Port), nimmt unser Anmeldeserver an. Das belegt ein automatischer Test.

Noch nicht geprüft

  • Nichts Wesentliches.

Codex (Terminal)

  1. Füge den Server hinzu:
    codex mcp add messpunkt --url https://mcp.messpunkt.io/v1
    oder trage ihn in ~/.codex/config.toml ein:
    [mcp_servers.messpunkt]
    url = "https://mcp.messpunkt.io/v1"
  2. Melde dich an:
    codex mcp login messpunkt
    Dein Browser öffnet die messpunkt.io-Anmeldung.

Für die heutigen Funktionen (nur lesen) brauchst du keine weitere Einstellung. Die Codex-Option mcp_elicitations (Rückfragen des Servers erlauben) wird erst für spätere Funktionen wichtig, bei denen der Assistent dich vor einer Änderung um Bestätigung bittet. Quelle: Codex-Dokumentation zu MCP.

Bei uns geprüft

  • Die Rückleitungsadresse, die Codex benutzt (http://127.0.0.1:PORT/callback/…), nimmt unser Anmeldeserver an. Das belegt ein automatischer Test.

Noch nicht geprüft

  • Der ganze Ablauf mit Codex gegen den laufenden messpunkt.io-Server.

ChatGPT

  1. Schalte unter Einstellungen › Sicherheit und Anmeldung den Entwicklermodus ein („Developer mode“; laut OpenAI für Plus, Pro, Business, Enterprise und Education im Browser).
  2. Lege über das Plus-Zeichen eine App für einen entfernten MCP-Server an und gib https://mcp.messpunkt.io/v1 als Adresse ein. Als Anmeldeart wählst du „OAuth“ (so heißt der Punkt im Menü).
  3. Verbinde die App. Es öffnet sich die messpunkt.io-Anmeldung.

Quelle: OpenAI-Dokumentation zum Entwicklermodus.

Bei uns geprüft

  • Noch nichts, was speziell ChatGPT betrifft.

Noch nicht geprüft

  • Der ganze Ablauf mit ChatGPT gegen den messpunkt.io-Server.
  • Die genauen Menübezeichnungen. OpenAI ändert sie häufig.

Was beim Verbinden passiert

  1. Anmelden. Dein Browser öffnet die messpunkt.io-Anmeldung. Melde dich mit deinem Konto aus dem Vermieter-Portal an. Deine Zugangsdaten bekommt der KI-Assistent nie zu sehen. Bist du mit dem falschen Konto angemeldet, wählst du auf der Freigabe-Seite unter „Nicht du?“ Mit einem anderen Konto anmelden.
  2. Freigabe-Seite. Dort steht, welche Anwendung zugreifen möchte (Art der Anwendung: „KI-Assistent“), und du entscheidest:
    • Für welchen Kunden, wenn du mehrere betreust. Kunden, für die die Verbindung noch nicht freigeschaltet ist, sind ausgegraut.
    • Welche Liegenschaften: „Alle Liegenschaften, auch künftige“ ist vorausgewählt. Neu angelegte Liegenschaften sind dann automatisch dabei. Alternativ wählst du „Nur ausgewählte Liegenschaften“ und hakst sie einzeln an. Künftige sind dann nicht eingeschlossen.
    • Was geteilt wird, in einfachen Sätzen: die Struktur deiner Liegenschaften mit Adressen, Wohn- und Nutzeinheiten und den Namen deiner Mieter, genau wie im Vermieter-Portal; der Gerätestatus einschließlich Eichung; die Verbräuche als monatliche Werte. Ein eigener Hinweiskasten erinnert daran, dass Mieternamen und die Verbräuche je Wohnung personenbezogene Daten deiner Mieter sind (mehr dazu unter Datenschutz). Außerdem steht dort: Die Anwendung kann nur lesen und nichts ändern, und der Zugriff gilt, bis du die Verbindung trennst.
  3. Zustimmen oder Ablehnen. Nach „Zustimmen“ kehrt der Browser zu deinem Assistenten zurück und die Verbindung steht. Nach „Ablehnen“ wird nichts geteilt.
Warnung bei Claude Code und Codex ist normal. Diese Programme laufen auf deinem eigenen Computer. Die Freigabe-Seite zeigt deshalb: „Diese Anwendung läuft auf deinem eigenen Computer … Die Identität der Anwendung wird nicht überprüft.“ Stimme nur zu, wenn du das Programm gerade selbst gestartet hast.

Beispielfragen

Du kannst ganz normal fragen und Liegenschaften mit ihrem Namen oder einem Teil der Adresse nennen. Passen mehrere, fragt der Assistent nach.

So sehen die Antworten aus, die der Assistent von messpunkt.io bekommt (gekürzt, mit erfundenen Testdaten). Der Assistent formuliert daraus seine eigene Antwort.

„Welche Liegenschaften habe ich?“
3 Liegenschaften:
- Testhaus Gartenweg, Gartenweg 5, 30000 Musterstadt (id …; 2 Nutzeinheiten, 2 Anlagen)
- Testhaus Gartenweg Nord, Gartenweg 7, 30000 Musterstadt (id …; 0 Nutzeinheiten, 0 Anlagen)
- Testhaus Waldstrasse (id …; 0 Nutzeinheiten, 0 Anlagen)
„Wie hoch war der Wärmeverbrauch 2025 in der Nordstrasse?“
Verbrauch Testhaus Nordstrasse, 2025-01 bis 2025-12 (Gliederung systems):
- Heizung Nordstrasse:
Wärme (Wärmemenge) [kWh]: Summe 15300.00; 2025-01 2700.00, 2025-02 2520.00, … 2025-12 2700.00
Heizkostenverteiler (HKV-Einheiten) [unit]: Summe 340.00; 2025-01 60.00, … 2025-11 44.00 (calculated), 2025-12 60.00
…
Hinweis: Werte sind höchstens monatlich aufgelöst.
Hinweis: Aussenwasser wird getrennt von Kalt- und Warmwasser ausgewiesen, und jede Kennzahl hat ihre eigene Einheit; eine Summe über verschiedene Kennzahlen gibt es nicht. …
Hinweis: Startwert des Tauschgeräts angenommen (0) — nicht erfasst. Betrifft: S-HCA-004.
„Wie viel Wärme wurde 2023 im Testhaus Gartenweg verbraucht?“ (Werte gibt es erst später)
Verbrauch Testhaus Gartenweg, 2023-01 bis 2023-12 (Gliederung systems):
- Heizung Gartenweg: keine Werte für die gewählten Kennzahlen im Zeitraum
…
Hinweis: Für 2023-01 bis 2023-12 liegen keine Werte vor. Die ersten Monatswerte dieser Liegenschaft gibt es ab 2026-01.
„Welche Geräte sind stumm?“
Geräte Testhaus Gartenweg: 7 gelistet, 1 stumm, 1 mit abgelaufener Eichung, 1 mit unbekanntem Eichstatus.
- HKV Wohnung 1, Heizkostenverteiler G-HCA-002 (WE 1): sendet; zuletzt 2026-09-14; keine Eichpflicht
- Kaltwasser Wohnung 2, Kaltwasserzähler G-KW-005 (WE 2): STUMM; zuletzt 2026-08-01; Eichung ABGELAUFEN (gültig war bis 2024-12-31)
- Waermezaehler Technik, Wärmezähler G-WMZ-004: sendet; zuletzt 2026-09-14; Eichstatus unbekannt
- …
Hinweis: Stumm heißt: seit mehr als 7 Tagen kein Funktelegramm. Der letzte Empfang ist nur als Datum angegeben.
Hinweis: Eichstatus unbekannt — das heißt nicht, dass die Eichung in Ordnung ist.
Hinweis: 1 Messpunkt (Kaltwasser ohne Anlage) ist keiner Heizungs- oder Wasseranlage zugeordnet und wird deshalb nicht ausgewertet. Lass die Zuordnung von messpunkt.io prüfen (kontakt@messpunkt.io).
„Wie viel Wasser wurde im Gartenweg verbraucht?“ (Name passt auf zwei Liegenschaften)
Mehrere Liegenschaften passen zu ‚Gartenweg‘: Testhaus Gartenweg (Gartenweg 5, 30000 Musterstadt, id …); Testhaus Gartenweg Nord (Gartenweg 7, 30000 Musterstadt, id …). Bitte erneut mit dem vollständigen Namen oder der id einer dieser Liegenschaften fragen.

Mit der Frage „Womit bist du verbunden?“ zeigt dir der Assistent, für welchen Kunden, mit welchen Rechten und für welche Liegenschaften die Verbindung gilt, und wie du sie trennst oder mit anderen Rechten neu verbindest.

Was der Assistent nicht kann und was die Antworten nicht bedeuten

  • Nur lesen. Der Assistent kann nichts ändern, zum Beispiel keinen Mieterwechsel eintragen. Das machst du weiter im Vermieter-Portal.
  • Höchstens monatliche Werte. Tages- oder Stundenwerte gibt es nicht, auch nicht auf Nachfrage. Feinere Werte je Wohnung würden verraten, wann Bewohner zu Hause sind.
  • „Eichstatus unbekannt“ heißt nicht, dass die Eichung in Ordnung ist. Es bedeutet nur, dass uns für dieses Gerät keine Eichdaten vorliegen. Geräte ohne Eichpflicht, etwa Heizkostenverteiler, erscheinen als „keine Eichpflicht“.
  • Jede Verbrauchsart in ihrer eigenen Einheit. Wärme in kWh, Wasser in m³, Heizkostenverteiler in HKV-Einheiten. Der Assistent zählt diese nicht zusammen.
  • Außenwasser getrennt. Wasser von Außenzapfstellen (zum Beispiel Gartenwasser) wird getrennt ausgewiesen und nicht zum Wasser der Wohnungen gezählt.
  • Differenzzähler ohne Wert. Messpunkte, deren Verbrauch als Rest aus anderen Zählern entsteht, zeigen in Version 1 keinen Wert. Das ist nicht dasselbe wie „0“.
  • Die Summe aller Wohnungen ist nicht der Gesamtverbrauch des Hauses. Allgemein- und Vorerfassungswerte sind nicht enthalten.
  • KI-Assistenten können sich irren. Prüfe Zahlen, auf die es ankommt, zum Beispiel für eine Abrechnung, im Vermieter-Portal.

Wenn etwas nicht klappt

  • „Kein Zugang“ oder nicht dein Kunde auf der Anmeldeseite. Du bist vermutlich mit einem anderen Konto angemeldet als dem, mit dem du das Vermieter-Portal nutzt. Klicke auf Mit einem anderen Konto anmelden (auf der Hinweisseite oder auf der Freigabe-Seite unter „Nicht du?“) und wähle dein Portal-Konto.
  • „Verbindung noch nicht freigeschaltet“. Die Freigabe gehört zu deinem Vertrag und fehlt für diesen Kunden noch. Schreib an kontakt@messpunkt.io, dann schalten wir sie frei.
  • Keine oder weniger Werte als erwartet, etwa für 2025. Werte gibt es erst ab dem Monat, seit dem die Geräte deiner Liegenschaft bei messpunkt.io Daten liefern, und immer nur bis zum letzten abgeschlossenen Monat. Fehlen Monate, sagt die Antwort das ausdrücklich („Für 2025-01 bis 2025-12 liegen keine Werte vor. Die ersten Monatswerte dieser Liegenschaft gibt es ab …“), und eine Summe umfasst dann nur die Monate mit Werten.
  • Ein Messpunkt wird „nicht ausgewertet“. Er ist keiner Heizungs- oder Wasseranlage zugeordnet und trägt deshalb zu keinem Wert bei; die übrigen Werte stimmen. Lass die Zuordnung von messpunkt.io prüfen (kontakt@messpunkt.io).
  • Der Assistent sagt, ihm fehle ein Recht. Die Verbindung umfasst diesen Bereich (etwa die Verbräuche) nicht. Verbinde den Assistenten neu und gib den Bereich auf der Freigabe-Seite frei, siehe Verbindung trennen.

Hilft das nicht weiter, schreib an kontakt@messpunkt.io.

Verbindung trennen

Im Vermieter-Portal unter Einstellungen › Verbundene Anwendungen siehst du jede Anwendung, die auf deine Daten zugreifen darf, mit den freigegebenen Liegenschaften und dem Datum der letzten Nutzung. Mit Trennen beendest du den Zugriff. Er endet innerhalb einer Minute.

  • Deine eigenen Verbindungen kannst du immer trennen. Administratoren deines Kontos können alle Verbindungen trennen.
  • Du möchtest andere Liegenschaften freigeben? Dann trenne die Verbindung und verbinde den Assistenten neu. Auf der Freigabe-Seite triffst du die Auswahl dann neu.
  • Wenn du den Connector nur im Assistenten entfernst, bleibt die Freigabe bei messpunkt.io bestehen, bis du sie im Portal trennst.

Datenschutz

Wenn du einen KI-Assistenten verbindest, gehen die Daten, nach denen du fragst, an den Anbieter, den du gewählt hast, zum Beispiel Anthropic oder OpenAI. Dafür gelten dessen Bedingungen. Das schließt die Namen deiner Mieter ein, wenn du die Struktur deiner Liegenschaften freigibst.

Entwurf, juristisch zu prüfen
Für die Verarbeitung deiner Daten durch messpunkt.io gilt die Vereinbarung zur Auftragsverarbeitung (AVV) aus deinem Vertrag mit messpunkt.io. Die Weitergabe an den KI-Anbieter, den du verbindest, deckt sie nicht ab: Darüber entscheidest du selbst, als Verantwortlicher für die Daten deiner Mieter. Prüfe deshalb vor dem Verbinden, ob du mit dem Anbieter eine eigene Vereinbarung zur Auftragsverarbeitung brauchst (viele Anbieter bieten sie für Geschäftskonten an) und ob du die Namen deiner Mieter weitergeben darfst. Fragen dazu beantworten wir unter kontakt@messpunkt.io.

Zugriffsprotokoll. Jeden Abruf einer verbundenen Anwendung (KI-Assistent oder Hausverwaltungssoftware) protokollieren wir mit Zeitpunkt, Anwendung, Verbindung, deinem Benutzerkonto, dem aufgerufenen Werkzeug oder Endpunkt und dem Ergebnis. Nicht protokolliert werden die Inhalte der Antworten, Mieternamen und die Eingaben selbst; von den Eingaben speichern wir nur einen nicht umkehrbaren Prüfwert. Das Protokoll dient der Sicherheit und der Nachvollziehbarkeit. Wir bewahren es 90 Tage auf und löschen ältere Einträge danach automatisch.
Für Technikinteressierte
  • Die Anmeldung ist OAuth 2.1 mit PKCE (S256). Der Assistent bekommt ein Zugriffstoken, das höchstens eine Stunde gilt. Es ist auf die Ressource https://mcp.messpunkt.io/v1 ausgestellt und gilt nicht für die REST-Schnittstelle.
  • Assistenten weisen sich über ein Client-ID-Metadatendokument aus (CIMD, eine https-Adresse als client_id, öffentlicher Client mit token_endpoint_auth_method: none). Eine dynamische Client-Registrierung (DCR) gibt es nicht. Claude, Claude Code, Codex und ChatGPT nennen CIMD in ihrer Dokumentation.
  • Freigegebene Rechte: read:units (Struktur mit Mieternamen), read:devices (Geräte und Eichung), read:readings (Monatswerte).
  • Die Verbindung wird bei jeder Anfrage geprüft. Deshalb wirkt das Trennen spätestens nach 60 Sekunden.
  • Die Werkzeuge, ihre Beschreibungen und Schemas stehen in der MCP-Referenz (englisch).