Chargekeeper koppelen aan Claude (MCP)

Chargekeeper biedt een MCP-server (Model Context Protocol). Eenmaal gekoppeld aan Claude kunt u uw park in natuurlijke taal bevragen: status van de laadpalen, fouten, lopende laadsessies, facturen, tarieven, meldingen… en, afhankelijk van de toegekende rechten, acties uitvoeren op de laadpalen.

1. Uw MCP-verbindingsgeheim verkrijgen

Om te beginnen moet het Chargekeeper-aansluitingsteam u een MCP-verbindingsgeheim bezorgen. Neem hiervoor contact op met het salesteam of het aansluitingsteam.

U ontvangt twee gegevens:

De MCP-API-sleutel is geheim: bewaar hem in een wachtwoordkluis en deel hem niet.

De rechten van de sleutel

De rechten worden door het Chargekeeper-team op de sleutel ingesteld. Geef in uw aanvraag aan wat u nodig hebt:

Een sleutel kan ook:

• werken in de modus met bevestiging: Claude moet dan vóór elke gevoelige actie (herstart, ontgrendeling, buiten bedrijf stellen, configuratiewijziging) uitdrukkelijk bevestiging krijgen;
• beperkt zijn tot bepaalde laadpalen;
• een vervaldatum hebben.

Vraag voor alleen raadplegen een sleutel met alleen leesrechten aan. Wijzigings- en actierechten werken op echte laadpalen.

2. De instellingen van Claude openen

1. Log in op uw Claude-account via https://claude.ai/.
2. Klik linksonder op uw naam en vervolgens op Instellingen.

3. De Chargekeeper-connector toevoegen

1. Klik in het instellingenmenu op Connectors.
2. Klik op de knop Toevoegen.

3. In het venster voor de aangepaste connector:
   • eerste veld (naam): vul Chargekeeper in;
   • URL van de MCP-server: vul https://mcp.service-evse.com/mcp in.
4. Klik op Doorgaan.

4. Inloggen met uw geheim

Er opent een Chargekeeper-inlogpagina:

1. Tenant: vul de identificatie van uw omgeving in (bijv. mon-cpo).
2. MCP-API-sleutel: plak uw sleutel.
3. Klik op de inlogknop.

Vervolgens toont een autorisatiepagina uw omgeving, de machtigingen en de lijst met beschikbare tools. Bevestig de toegang: u wordt teruggeleid naar Claude.

De rechten die werkelijk gelden, zijn die van de MCP-API-sleutel. Om uit te breiden of te beperken wat Claude mag doen, moet de sleutel worden aangepast.

5. Kiezen wanneer Claude de tools mag gebruiken

De connector Chargekeeper staat nu onder Instellingen → Connectors. Klik erop: in het onderdeel met toolmachtigingen kiest u, voor alle tools of per tool:

• ✓ (vinkje): Claude gebruikt de tool zonder het u te vragen;
• ✋ (hand) — goedkeuring vereist: Claude vraagt vóór elk gebruik uw toestemming;
• ⃠ (doorgestreepte cirkel): Claude kan de tool niet gebruiken.

Houd goedkeuring vereist minstens aan voor de tools die op laadpalen inwerken: Change Availability, Change Charger Configuration, Clear Cache, Reset Charger, Trigger Message, Unlock Connector.

Met de knop Loskoppelen trekt u de toegang van Claude tot uw Chargekeeper-omgeving in.

6. De connector gebruiken

Activeer in een nieuw gesprek de connector Chargekeeper via het toolmenu onder het invoerveld en stel uw vraag. Voorbeelden:

• ‘Welke laadpalen staan op dit moment in storing?’
• ‘Toon de herstartgeschiedenis van laadpaal ACME-001.’
• ‘Waren er deze week afwijkende laadsessies?’
• ‘Welk tarief geldt in de zone Parkeerterrein Noord?’

De verbinding blijft behouden: Claude vernieuwt de toegang automatisch, zonder in elk gesprek opnieuw om de sleutel te vragen. Na 30 dagen zonder gebruik moet u opnieuw inloggen.

Beperkingen

• Het aantal aanroepen van MCP-tools is beperkt per maand en per omgeving (standaard 5.000). Vraag Claude ‘Wat is mijn MCP-quotum?’ om uw verbruik te zien.
• Als de sleutel wordt uitgeschakeld, verloopt of wordt verwijderd, verliest Claude de toegang: vraag een nieuwe sleutel aan en koppel de connector opnieuw.

Problemen oplossen