Connecter Chargekeeper à Claude (MCP)
Chargekeeper dispose d'un serveur MCP (Model Context Protocol). Une fois connecté à Claude, il permet d'interroger votre parc en langage naturel : état des bornes, erreurs, sessions en cours, factures, tarifs, alertes… et, selon les droits accordés, d'agir sur les bornes.
1. Obtenir votre secret de connexion MCP
Pour commencer, l'équipe connexion Chargekeeper doit vous fournir un secret de connexion MCP. Rapprochez-vous de l'équipe commerciale ou de l'équipe connexion pour en faire la demande.
Vous recevrez deux informations :
| Information | Description |
|---|---|
| Locataire | L'identifiant de votre espace Chargekeeper (par exemple mon-cpo). |
| Clé API MCP | Le secret qui autorise Claude à accéder à votre espace. |
La clé API MCP est un secret : conservez-la dans un coffre-fort de mots de passe et ne la partagez pas.
Les droits associés à la clé
Les droits sont fixés sur la clé par l'équipe Chargekeeper. Précisez dans votre demande ce dont vous avez besoin :
| Droit | Ce qu'il permet |
|---|---|
| Lecture des diagnostics | Consulter l'état des bornes, les sessions, les erreurs |
| Lecture de la configuration | Consulter la configuration OCPP des bornes |
| Modification de la configuration | Modifier la configuration OCPP des bornes |
| Actions non critiques | Vider le cache d'une borne, lui demander un message OCPP, remettre un connecteur en service |
| Actions critiques | Redémarrer une borne, déverrouiller un connecteur, mettre un connecteur hors service |
Une clé peut aussi :
- fonctionner en mode avec confirmation : Claude doit alors obtenir une confirmation explicite avant chaque action sensible (redémarrage, déverrouillage, mise hors service, modification de configuration) ;
- être limitée à certaines bornes seulement ;
- avoir une date d'expiration.
Pour un usage de consultation, demandez une clé en lecture seule. Les droits de modification et d'action agissent sur des bornes réelles.
2. Ouvrir les paramètres de Claude
- Connectez-vous à votre compte Claude sur https://claude.ai/.
- Cliquez sur votre nom en bas à gauche, puis sur Paramètres.

3. Ajouter le connecteur Chargekeeper
- Dans le menu des paramètres, cliquez sur Connecteurs.
- Cliquez sur le bouton Ajouter.

- Dans la fenêtre Ajouter un connecteur personnalisé :
- premier champ (nom) : saisissez
Chargekeeper; - URL du serveur MCP : saisissez
https://mcp.service-evse.com/mcp.
- premier champ (nom) : saisissez
- Cliquez sur Continuer.

4. Se connecter avec votre secret
Une page Chargekeeper Se connecter s'ouvre :
- Locataire : saisissez l'identifiant de votre espace (ex.
mon-cpo). - Clé API MCP : collez votre clé.
- Cliquez sur Se connecter et continuer.

Une page d'autorisation affiche ensuite votre espace, les permissions et la liste des outils disponibles. Validez l'accès : vous êtes redirigé vers Claude.
Les droits réellement appliqués sont ceux de la clé API MCP. Pour élargir ou restreindre ce que Claude peut faire, c'est la clé qu'il faut faire modifier.
5. Choisir quand Claude peut utiliser les outils
Le connecteur Chargekeeper apparaît dans Paramètres → Connecteurs. En cliquant dessus, la section Autorisations des outils permet de choisir, pour tous les outils ou outil par outil :
- ✓ (coche) : Claude utilise l'outil sans vous demander ;
- ✋ (main) — Nécessite une approbation : Claude vous demande votre accord avant chaque utilisation ;
- ⃠ (cercle barré) : Claude ne peut pas utiliser l'outil.

Conservez Nécessite une approbation au moins pour les outils qui agissent sur les bornes : Change Availability, Change Charger Configuration, Clear Cache, Reset Charger, Trigger Message, Unlock Connector.
Le bouton Déconnecter retire l'accès de Claude à votre espace Chargekeeper.
6. Utiliser le connecteur
Dans une nouvelle conversation, activez le connecteur Chargekeeper depuis le menu des outils, sous la zone de saisie, puis posez votre question. Exemples :
- « Quelles bornes sont en erreur en ce moment ? »
- « Donne-moi l'historique des redémarrages de la borne ACME-001. »
- « Y a-t-il des sessions anormales cette semaine ? »
- « Quel tarif s'applique sur la zone Parking Nord ? »
La connexion est conservée : Claude renouvelle l'accès automatiquement, sans redemander la clé à chaque conversation. Après 30 jours sans utilisation, il faudra vous reconnecter.
Limites
- Le nombre d'appels aux outils MCP est limité par mois et par espace (5 000 par défaut). Demandez à Claude « Quel est mon quota MCP ? » pour connaître votre consommation.
- Si la clé est désactivée, expirée ou supprimée, Claude perd l'accès : demandez une nouvelle clé et reconnectez le connecteur.
En cas de problème
| Situation | Solution |
|---|---|
| La connexion est refusée | Vérifiez le locataire (identifiant seul, sans https:// ni nom de domaine) et la clé. Si l'erreur persiste, la clé est peut-être expirée ou désactivée : contactez l'équipe connexion. |
| Une action est refusée | La clé ne dispose pas du droit nécessaire, ou la borne ne fait pas partie des bornes autorisées pour la clé. |