Chargekeeper mit Claude verbinden (MCP)

Chargekeeper stellt einen MCP-Server (Model Context Protocol) bereit. Nach der Verbindung mit Claude können Sie Ihren Ladepark in natürlicher Sprache abfragen: Status der Ladestationen, Fehler, laufende Ladevorgänge, Rechnungen, Tarife, Alarme… und, je nach gewährten Rechten, auf die Ladestationen einwirken.

1. Ihr MCP-Verbindungsgeheimnis erhalten

Zunächst muss Ihnen das Chargekeeper-Anbindungsteam ein MCP-Verbindungsgeheimnis bereitstellen. Wenden Sie sich dafür an das Vertriebsteam oder das Anbindungsteam.

Sie erhalten zwei Angaben:

Angabe	Beschreibung
Mandant	Die Kennung Ihres Chargekeeper-Bereichs (zum Beispiel `mon-cpo`).
MCP-API-Schlüssel	Das Geheimnis, mit dem Claude auf Ihren Bereich zugreifen darf.

Der MCP-API-Schlüssel ist ein Geheimnis: Bewahren Sie ihn in einem Passwort-Tresor auf und geben Sie ihn nicht weiter.

Die Rechte des Schlüssels

Die Rechte werden vom Chargekeeper-Team am Schlüssel festgelegt. Geben Sie in Ihrer Anfrage an, was Sie benötigen:

Recht	Was es erlaubt
Diagnosen lesen	Status der Ladestationen, Ladevorgänge und Fehler einsehen
Konfiguration lesen	Die OCPP-Konfiguration der Ladestationen einsehen
Konfiguration ändern	Die OCPP-Konfiguration der Ladestationen ändern
Unkritische Aktionen	Den Cache einer Ladestation leeren, eine OCPP-Nachricht anfordern, einen Anschluss wieder in Betrieb nehmen
Kritische Aktionen	Eine Ladestation neu starten, einen Anschluss entriegeln, einen Anschluss außer Betrieb setzen

Ein Schlüssel kann außerdem:

im Modus mit Bestätigung arbeiten: Claude muss dann vor jeder sensiblen Aktion (Neustart, Entriegelung, Außerbetriebnahme, Konfigurationsänderung) eine ausdrückliche Bestätigung einholen;
auf bestimmte Ladestationen beschränkt sein;
ein Ablaufdatum haben.

Für die reine Abfrage fordern Sie einen Schlüssel mit Leserechten an. Änderungs- und Aktionsrechte wirken auf echte Ladestationen.

2. Die Einstellungen von Claude öffnen

Melden Sie sich unter https://claude.ai/ bei Ihrem Claude-Konto an.
Klicken Sie unten links auf Ihren Namen und dann auf Einstellungen.

3. Den Chargekeeper-Connector hinzufügen

Klicken Sie im Einstellungsmenü auf Connectors.
Klicken Sie auf die Schaltfläche Hinzufügen.

Im Fenster für den benutzerdefinierten Connector:
- erstes Feld (Name): geben Sie Chargekeeper ein;
- URL des MCP-Servers: geben Sie https://mcp.service-evse.com/mcp ein.
Klicken Sie auf Weiter.

4. Mit Ihrem Geheimnis anmelden

Eine Chargekeeper-Anmeldeseite öffnet sich:

Mandant: geben Sie die Kennung Ihres Bereichs ein (z. B. mon-cpo).
MCP-API-Schlüssel: fügen Sie Ihren Schlüssel ein.
Klicken Sie auf die Anmeldeschaltfläche.

Eine Autorisierungsseite zeigt anschließend Ihren Bereich, die Berechtigungen und die Liste der verfügbaren Tools. Bestätigen Sie den Zugriff: Sie werden zu Claude zurückgeleitet.

Tatsächlich gelten die Rechte des MCP-API-Schlüssels. Um zu erweitern oder einzuschränken, was Claude tun darf, muss der Schlüssel geändert werden.

5. Festlegen, wann Claude die Tools verwenden darf

Der Connector Chargekeeper erscheint nun unter Einstellungen → Connectors. Klicken Sie darauf: Im Bereich der Tool-Berechtigungen legen Sie für alle Tools oder für jedes einzeln fest:

✓ (Häkchen): Claude verwendet das Tool, ohne nachzufragen;
✋ (Hand) — Genehmigung erforderlich: Claude bittet vor jeder Verwendung um Ihre Zustimmung;
⃠ (durchgestrichener Kreis): Claude kann das Tool nicht verwenden.

Behalten Sie Genehmigung erforderlich mindestens für die Tools bei, die auf Ladestationen einwirken: Change Availability, Change Charger Configuration, Clear Cache, Reset Charger, Trigger Message, Unlock Connector.

Die Schaltfläche Trennen entzieht Claude den Zugriff auf Ihren Chargekeeper-Bereich.

6. Den Connector verwenden

Aktivieren Sie in einer neuen Unterhaltung den Connector Chargekeeper über das Tool-Menü unter dem Eingabefeld und stellen Sie Ihre Frage. Beispiele:

„Welche Ladestationen haben gerade einen Fehler?“
„Zeig mir den Neustartverlauf der Ladestation ACME-001.“
„Gab es diese Woche auffällige Ladevorgänge?“
„Welcher Tarif gilt im Bereich Parkplatz Nord?“

Die Verbindung bleibt bestehen: Claude erneuert den Zugriff automatisch, ohne in jeder Unterhaltung erneut nach dem Schlüssel zu fragen. Nach 30 Tagen ohne Nutzung müssen Sie sich erneut anmelden.

Einschränkungen

Die Anzahl der MCP-Tool-Aufrufe ist pro Monat und pro Bereich begrenzt (standardmäßig 5.000). Fragen Sie Claude „Wie hoch ist mein MCP-Kontingent?“, um Ihren Verbrauch zu sehen.
Wird der Schlüssel deaktiviert, läuft er ab oder wird er gelöscht, verliert Claude den Zugriff: Fordern Sie einen neuen Schlüssel an und verbinden Sie den Connector erneut.

Fehlerbehebung

Situation	Lösung
Die Anmeldung wird abgelehnt	Prüfen Sie den Mandanten (nur die Kennung, ohne `https://` und ohne Domainnamen) und den Schlüssel. Besteht der Fehler weiter, ist der Schlüssel möglicherweise abgelaufen oder deaktiviert: Wenden Sie sich an das Anbindungsteam.
Eine Aktion wird abgelehnt	Der Schlüssel verfügt nicht über das erforderliche Recht, oder die Ladestation gehört nicht zu den für den Schlüssel zugelassenen Ladestationen.