Connettore MCP per Claude & ChatGPT

Collega Plantime a Claude o ChatGPT per leggere i planning, pianificare i turni e gestire i fogli ore conversando.

Cosa fa il connettore MCP di Plantime

Il server MCP (Model Context Protocol) di Plantime permette ad assistenti IA come Claude e ChatGPT di lavorare con il tuo workspace Plantime per conto tuo. Una volta collegato, puoi chiedere all'assistente di:

  • Leggere il tuo workspace — organizzazioni, team, planning, statistiche dei turni e fogli ore
  • Pianificare i turni — creare turni singoli, ripetere modelli su intervalli di date, copiare settimane o riempire un periodo basandosi sul ritmo recente del tuo team
  • Assegnare i turni — assegnare o rimuovere membri del team, applicare o scartare le assegnazioni suggerite, oppure eseguire il pianificatore automatico per coprire i turni aperti in base a disponibilità, competenze e carico di lavoro
  • Gestire i fogli ore — elencare, esaminare, approvare, rifiutare o ricalcolare i fogli ore

Tutto avviene con il tuo account Plantime. Il connettore vede e modifica solo ciò che puoi vedere e modificare tu: la maggior parte degli strumenti di pianificazione richiede un ruolo di manager, admin o proprietario nel team, e gli strumenti dei fogli ore permettono anche ai dipendenti di consultare e approvare i propri fogli.

Configurazione

Il connettore è un server MCP remoto con accesso OAuth — non c'è nulla da installare.

URL del server: https://www.plantime.io/api/mcp/v1

Claude (claude.ai e Claude Desktop)

  1. Apri Impostazioni → Connettori (con un piano Claude a pagamento)
  2. Scegli Aggiungi connettore personalizzato
  3. Inserisci l'URL del server qui sopra e conferma
  4. Claude ti reindirizza a Plantime per accedere e autorizzare l'accesso
  5. Gli strumenti Plantime diventano disponibili nelle tue conversazioni

Claude Code

claude mcp add --transport http plantime https://www.plantime.io/api/mcp/v1

Poi esegui /mcp in Claude Code per completare l'accesso OAuth.

ChatGPT

  1. Apri Impostazioni → App e connettori
  2. Scegli Crea (modalità sviluppatore) oppure aggiungi l'app Plantime dal catalogo una volta pubblicata
  3. Inserisci l'URL del server qui sopra, seleziona l'autenticazione OAuth e salva
  4. Accedi a Plantime quando ti viene chiesto di autorizzare

Esempi di prompt

  • «Quali team gestisco in Plantime?»
  • «Mostrami il planning della prossima settimana per il team cucina, con le persone assegnate.»
  • «Aggiungi un turno bar martedì prossimo dalle 16:00 alle 23:00 per due persone.»
  • «Copia i turni di questa settimana nelle prossime due settimane.»
  • «Assegna automaticamente i turni aperti della prima settimana di luglio.»
  • «Mostrami i fogli ore in attesa e approva quello di Maria se le ore sono corrette.»

Accesso ai dati e sicurezza

  • L'autorizzazione usa OAuth: accedi direttamente a Plantime e l'assistente riceve un token di accesso limitato. La tua password Plantime non viene mai condivisa con l'assistente.
  • Tutte le azioni vengono verificate lato server in base ai ruoli del tuo account, esattamente come nell'app web di Plantime.
  • Le azioni distruttive sono prudenti: l'eliminazione dei turni è una cancellazione soft con una finestra di annullamento di un'ora (undo_delete_shifts), e i fogli ore approvati non possono essere ricalcolati.
  • Puoi revocare l'accesso in qualsiasi momento rimuovendo il connettore da Claude o ChatGPT.

Risoluzione dei problemi

Errore «Unauthenticated» o 401 — la sessione è scaduta. Rimuovi e riaggiungi il connettore, oppure usa l'opzione di riconnessione dell'assistente per accedere di nuovo.

L'assistente non vede un team o un'organizzazione — il connettore mostra solo i workspace a cui appartiene il tuo account Plantime. Gli strumenti di pianificazione richiedono inoltre un ruolo di manager, admin o proprietario in quel team.

Gli intervalli di date si comportano in modo inatteso — per la maggior parte degli strumenti la fine dell'intervallo è esclusiva: per includere tutto il 15 giugno, indica come fine il 16 giugno alle 00:00. Le date vengono interpretate come ISO 8601.

Annullare un'eliminazione — chiedi all'assistente di annullarla. Le eliminazioni restituiscono un riferimento di annullamento valido per un'ora. Oltre, i turni vanno ricreati.

Gli strumenti sono elencati ma le chiamate falliscono — verifica prima che il tuo account Plantime funzioni nell'app web su plantime.io; il connettore ha esattamente gli stessi permessi.

Supporto

Se sei bloccato, scrivici a support@plantime.io o visita la pagina di supporto. Allega il prompt usato e il messaggio di errore mostrato dall'assistente — di solito basta per individuare il problema.