Den HeidiFi MCP-Server verbinden

Der HeidiFi MCP-Server erlaubt KI-Assistenten, Ihre Captive-Portal-Daten sicher zu lesen. So können Sie Fragen wie «Wie viele Gäste hat mein Café diese Woche erfasst?» oder «Zeig mir meine aktiven Kampagnen» direkt in Claude, ChatGPT oder jeder MCP-kompatiblen App stellen.

Die Verbindung läuft über das Model Context Protocol mit Ihrem HeidiFi-Konto – keine API-Schlüssel zum Kopieren oder Speichern. Sie melden sich einmal an, genehmigen den Zugriff, und Ihr Assistent erhält Lesezugriff, beschränkt auf Ihre Standorte.

Was Ihr Assistent kann

Nach der Verbindung stehen diese Lesewerkzeuge zur Verfügung:

• Standorte – Ihre Standorte auflisten und Details ansehen
• Access Points – Ihre WLAN-Access-Points und deren Status sehen
• Gäste – erfasste Gäste auflisten, nachschlagen und durchsuchen
• Kampagnen – Kampagnen auflisten und deren Konfiguration ansehen
• Auswertungen – Erfassungsstatistiken und Kampagnen-Performance
• Konfiguration – Marketing- und Splash-Seiten-Einstellungen der Standorte

Ihre MCP-Server-URL

Diese Adresse fügen Sie in Ihrer KI-App ein. Sie ist für alle gleich:

So funktioniert die Anmeldung

Wenn Sie den Connector hinzufügen, leitet Ihre App Sie zur HeidiFi-Anmeldeseite. Dort:

1. Melden Sie sich mit Ihrem HeidiFi-Konto (Google) an
2. Sehen Sie genau, was die App anfordert
3. Klicken Sie auf Authentifizieren, um zuzustimmen und zu Ihrer App zurückzukehren

Ihre App verbinden

Wählen Sie unten Ihre App für eine Schritt-für-Schritt-Anleitung.

Was Sie freigeben

Sie gewähren Lesezugriff auf Ihre Captive-Portal-Daten – derzeit die Möglichkeit, Ihre WLAN-Access-Points (Name, Status, Anzahl) anzusehen sowie die zugehörigen Standort-, Gäste-, Kampagnen- und Auswertungsdaten, die Ihr Assistent abfragt. HeidiFi gibt Ihr Passwort nie an die App weiter; die App erhält nur ein eingeschränktes Zugriffstoken.

Zugriff verwalten und widerrufen

Sie können die Verbindung jederzeit trennen:

• In Ihrer KI-App – entfernen Sie den HeidiFi-Connector in deren Einstellungen.
• In HeidiFi – widerrufen Sie den Zugriff in Ihrem HeidiFi-Dashboard. Nach dem Widerruf funktioniert das Token der App sofort nicht mehr.

Fehlerbehebung

• «Ihr Konto ist kein Captive-Portal-Mandant» – Der MCP-Server ist für Captive-Portal-Konten gedacht. Melden Sie sich mit dem HeidiFi-Konto an, das Ihre Standorte verwaltet.
• Der Connector lässt sich nicht hinzufügen / Fehler beim Verbinden – Stellen Sie sicher, dass die URL auf /mcp endet und keine Leerzeichen am Ende hat: https://mcp.heidifi.ai/mcp.
• Ich werde immer wieder zur Anmeldung aufgefordert – Ihr Zugriff ist möglicherweise abgelaufen oder wurde widerrufen. Fügen Sie den Connector erneut hinzu und authentifizieren Sie sich noch einmal.
• Nach dem Verbinden erscheinen keine Tools – Starten Sie Ihre KI-App neu (besonders Claude Desktop), damit sie die Connectors neu lädt.

Kommen Sie nicht weiter? Kontaktieren Sie uns – wir helfen Ihnen bei der Verbindung.