Collegare Chargekeeper a Claude (MCP)

Chargekeeper mette a disposizione un server MCP (Model Context Protocol). Una volta collegato a Claude, consente di interrogare il parco in linguaggio naturale: stato delle stazioni di ricarica, errori, sessioni in corso, fatture, tariffe, allarmi… e, in base ai diritti concessi, di agire sulle stazioni.

1. Ottenere il segreto di connessione MCP

Per iniziare, il team connessione Chargekeeper deve fornirvi un segreto di connessione MCP. Rivolgetevi al team commerciale o al team connessione per richiederlo.

Riceverete due informazioni:

La chiave API MCP è un segreto: conservatela in un gestore di password e non condividetela.

I diritti associati alla chiave

I diritti sono definiti sulla chiave dal team Chargekeeper. Indicate nella richiesta ciò di cui avete bisogno:

Una chiave può inoltre:

• funzionare in modalità con conferma: Claude deve allora ottenere una conferma esplicita prima di ogni azione sensibile (riavvio, sblocco, messa fuori servizio, modifica della configurazione);
• essere limitata ad alcune stazioni soltanto;
• avere una data di scadenza.

Per la sola consultazione, richiedete una chiave in sola lettura. I diritti di modifica e di azione agiscono su stazioni reali.

2. Aprire le impostazioni di Claude

1. Accedete al vostro account Claude su https://claude.ai/.
2. Cliccate sul vostro nome in basso a sinistra, poi su Impostazioni.

3. Aggiungere il connettore Chargekeeper

1. Nel menu delle impostazioni, cliccate su Connettori.
2. Cliccate sul pulsante Aggiungi.

3. Nella finestra del connettore personalizzato:
   • primo campo (nome): inserite Chargekeeper;
   • URL del server MCP: inserite https://mcp.service-evse.com/mcp.
4. Cliccate su Continua.

4. Accedere con il vostro segreto

Si apre una pagina di accesso Chargekeeper:

1. Tenant: inserite l'identificativo del vostro spazio (es. mon-cpo).
2. Chiave API MCP: incollate la vostra chiave.
3. Cliccate sul pulsante di accesso.

Una pagina di autorizzazione mostra quindi il vostro spazio, i permessi e l'elenco degli strumenti disponibili. Confermate l'accesso: verrete reindirizzati a Claude.

I diritti effettivamente applicati sono quelli della chiave API MCP. Per ampliare o limitare ciò che Claude può fare, occorre modificare la chiave.

5. Scegliere quando Claude può usare gli strumenti

Il connettore Chargekeeper compare ora in Impostazioni → Connettori. Cliccandoci sopra, la sezione delle autorizzazioni degli strumenti permette di scegliere, per tutti gli strumenti o per ciascuno:

• ✓ (spunta): Claude usa lo strumento senza chiedervelo;
• ✋ (mano) — approvazione richiesta: Claude chiede il vostro consenso prima di ogni utilizzo;
• ⃠ (cerchio barrato): Claude non può usare lo strumento.

Mantenete approvazione richiesta almeno per gli strumenti che agiscono sulle stazioni: Change Availability, Change Charger Configuration, Clear Cache, Reset Charger, Trigger Message, Unlock Connector.

Il pulsante Disconnetti revoca l'accesso di Claude al vostro spazio Chargekeeper.

6. Usare il connettore

In una nuova conversazione, attivate il connettore Chargekeeper dal menu degli strumenti sotto la casella di testo, poi fate la vostra domanda. Esempi:

• «Quali stazioni sono in errore in questo momento?»
• «Mostrami la cronologia dei riavvii della stazione ACME-001.»
• «Ci sono state sessioni anomale questa settimana?»
• «Quale tariffa si applica nell'area Parcheggio Nord?»

La connessione viene mantenuta: Claude rinnova l'accesso automaticamente, senza richiedere la chiave a ogni conversazione. Dopo 30 giorni di inutilizzo, sarà necessario accedere di nuovo.

Limiti

• Il numero di chiamate agli strumenti MCP è limitato al mese e per spazio (5.000 per impostazione predefinita). Chiedete a Claude «Qual è la mia quota MCP?» per conoscere il vostro consumo.
• Se la chiave viene disattivata, scade o viene eliminata, Claude perde l'accesso: richiedete una nuova chiave e ricollegate il connettore.

Risoluzione dei problemi