Documentazione CrankPal
Vai al gestionale

Configurazione

Claude e ChatGPT

Come collegare il tuo account Claude o ChatGPT ai dati dell'officina, che cosa può leggere l'assistente e come si scollega.

Se usi già Claude o ChatGPT, puoi collegarli al gestionale e chiedere, con parole tue, come va l'officina: quanto hai fatturato a settembre rispetto ad agosto, quali interventi rendono di più, quali clienti non tornano da sei mesi, quali ricambi sono sotto scorta. L'assistente legge i dati quando glielo chiedi, con i tuoi permessi, e non può modificare niente.

La funzione è in anteprima. Si trova in ImpostazioniIntegrazioniClaude e ChatGPT, è inclusa da Premium in su e la possono usare solo gli amministratori dell'officina.

Prima di cominciare#

  • Un account Claude o ChatGPT tuo, con un piano che permette di aggiungere connettori personalizzati. Questo dipende dal fornitore, non da CrankPal: controlla sul suo sito.
  • Il ruolo di amministratore nel gestionale. Vedi utenti, ruoli e permessi.
  • Un secondo fattore d'accesso attivo sul tuo account CrankPal: app authenticator, codice via email o passkey. Il collegamento si conferma con quello. Lo attivi da ImpostazioniAccountSicurezza.

Collegare Claude#

  1. Copia l'indirizzo della tua officina

    Nella scheda Claude e ChatGPT trovi l'indirizzo da incollare nell'assistente. È quello della tua officina e finisce con /mcp. Premi Copia.

  2. Aggiungi il connettore in Claude

    Su claude.ai, o nell'app per computer, apri le impostazioni, poi Connettori e Aggiungi connettore personalizzato. Dagli un nome, per esempio CrankPal, e incolla l'indirizzo. Con Claude Code lo aggiungi come server MCP remoto, con lo stesso indirizzo.

  3. Accedi e conferma

    Claude apre una pagina di CrankPal. Se non sei già dentro, accedi. La pagina dice chi chiede il collegamento, che cosa potrà leggere e che cosa no. Scegli se includere email e telefono dei clienti, premi Collega e conferma col secondo fattore. Torni su Claude, collegato.

Collegare ChatGPT#

  1. Attiva la modalità sviluppatore

    In ChatGPT i connettori personalizzati passano dalla modalità sviluppatore, che si attiva dalle impostazioni. La disponibilità dipende dal tuo piano ChatGPT.

  2. Crea l'app con l'indirizzo di CrankPal

    Crea una nuova app MCP, incolla l'indirizzo copiato dalla scheda Claude e ChatGPT e scegli l'autenticazione OAuth.

  3. Accedi e conferma

    Come per Claude: accedi a CrankPal, scegli se includere i recapiti dei clienti, premi Collega e conferma col secondo fattore.

Che cosa può leggere, e che cosa no#

Quando glielo chiedi, l'assistente può leggere:

  • gli appuntamenti e il carico dell'agenda;
  • gli ordini di lavoro, i preventivi e i pagamenti ancora da incassare;
  • il report del periodo, con gli stessi numeri della pagina Report, e i margini;
  • il magazzino e i ricambi sotto scorta;
  • i clienti, con le loro visite e la spesa in officina;
  • la documentazione di CrankPal, per le domande su come si fa una cosa.

Email e telefono dei clienti escono solo se li hai inclusi al collegamento. L'assistente non può creare, modificare o cancellare niente, né scrivere ai clienti. Rispetta i permessi del tuo utente e i moduli del tuo piano: se il magazzino non è nel piano, te lo dice invece di inventare giacenze.

L'assistente risponde quando gli fai una domanda, anche dentro un'attività programmata dell'assistente stesso (per esempio un riepilogo ogni lunedì mattina), se il tuo piano Claude o ChatGPT le prevede. Non reagisce da solo a quello che succede in officina.

Vedere gli accessi e scollegare#

Nella scheda Claude e ChatGPT trovi i collegamenti attivi: chi li ha creati, quando, l'ultimo accesso e quante letture nelle ultime 24 ore. Ultimi accessi mostra ogni lettura: quale strumento, quando e quante righe. Scollega chiude subito il collegamento.

Quando nasce un collegamento, tutti gli amministratori dell'officina ricevono un'email: se non lo riconoscete, scollegatelo.

Un collegamento si chiude anche da solo quando cambi la password, quando il tuo utente viene disattivato o non è più amministratore, e quando nessuno lo usa per 90 giorni. Se l'officina passa a un piano senza connettore, il collegamento resta ma l'assistente non legge più niente finché non torni a Premium o superiore. Vedi funzioni per piano.

Problemi frequenti#

Claude o ChatGPT dicono che non riescono a raggiungere il server.

Controlla di aver incollato l'indirizzo esatto della scheda, con /mcp in fondo e senza spazi.

La pagina di CrankPal dice che serve un secondo fattore.

Attivalo da ImpostazioniAccountSicurezza, poi ricomincia il collegamento dall'assistente.

Le risposte non hanno email e telefono dei clienti.

Hai collegato l'assistente senza recapiti. Scollegalo e ricollegalo spuntando la casella dei recapiti.

L'assistente dice che ha raggiunto il limite giornaliero.

Ogni collegamento può leggere fino a 5.000 righe al giorno: il connettore serve a rispondere a domande, non a copiare l'anagrafica. Fai una domanda più precisa, o riprova il giorno dopo.