Manuale

Integrazione con Claude

Integrazione con Claude

v1.11.0+

L’integrazione con Claude aggiunge un’estensione all’app desktop di Claude (Windows, macOS) per gestire GeckoFlag conversando con Claude. Permette di cercare, consultare, creare e aggiornare ticket, progetti, wiki e note e di esportare diagrammi di Gantt in Excel. L’estensione funziona sul PC dell’utente e comunica direttamente solo con il GeckoFlag dell’utente. Ogni operazione avviene con i permessi dell’utente titolare del token API.

Impostazioni dell’amministratore

  1. 1Apra Impostazioni nel menu laterale e faccia clic su Modifica nella scheda Integrazione con Claude.Schermata delle impostazioni con la scheda «Claude Integration» evidenziata in rosso
  2. 2Attivi Attiva l’integrazione con Claude (disattivata per impostazione predefinita). Se vuole che Claude crei e modifichi anche dati, attivi pure Consenti la scrittura e salvi. Se la scrittura non è consentita, tutti i token sono di sola lettura.Schermata delle impostazioni dell’integrazione con Claude con le caselle «Enable Claude integration» e «Allow writing» evidenziate in rosso e, sotto, il numero di utenti autorizzati e di token API
  3. 3In Utenti apra Modifica per l’utente interessato, attivi Consenti l’integrazione con Claude (API) e faccia clic su Aggiorna. È un’impostazione separata da «Consenti la registrazione assistita dall’IA». Revocando l’autorizzazione, tutti i token API di quell’utente vengono eliminati.Schermata di modifica utente con «Users» nel menu laterale e la casella «Allow Claude integration (API)» evidenziati in rosso

Creare un token API

  1. 1Apra Profilo nel menu laterale e, nella sezione Token API, indichi nome del token, scadenza (30, 90 o 365 giorni oppure nessuna scadenza; predefinita 90 giorni) e permesso (Sola lettura oppure Lettura e scrittura), quindi crei il token.Sezione «API Tokens (Claude Integration)» della schermata del profilo con i campi Token name, Expires in e Permission evidenziati in rosso
  2. 2Copi il token mostrato (una stringa che inizia con gfk_). Il token viene mostrato una sola volta, subito dopo la creazione. Annoti anche l’«URL da inserire nell’estensione» mostrato nella stessa sezione.
  • Ogni persona può creare fino a 5 token; quelli non più usati si possono eliminare in qualsiasi momento dal profilo.
  • Alla creazione di un token, l’utente riceve un’e-mail di notifica. Cambiando la password, tutti i token di quella persona vengono eliminati.

Configurare l’app desktop di Claude

  1. 1Nell’app desktop di Claude apra Settings (Impostazioni) → Extensions (Estensioni), trascini e rilasci il file dell’estensione di GeckoFlag (.mcpb) e faccia clic su Install. Può installarla anche facendo doppio clic sul file o da Advanced settings. Il file dell’estensione è incluso nel download che riceve dopo l’acquisto di GeckoFlag.
  2. 2Nella schermata di configurazione compili le voci seguenti e faccia clic su Save.
    • GeckoFlag URL (obbligatorio): l’URL annotato. Serve https:// (http:// solo per localhost, *.test e *.local).
    • API token (obbligatorio): il token copiato. Viene salvato in forma mascherata.
    • Export folder (facoltativo): la cartella in cui salvare i file Excel del Gantt. Se vuoto, i file vengono salvati nella cartella Download.
    Schermata di configurazione dell’estensione di GeckoFlag con i campi GeckoFlag URL, API token ed Export folder
  3. 3Chieda a Claude «Verifica la connessione a GeckoFlag». Se compaiono il titolare del token, la versione di GeckoFlag e se la scrittura è possibile, la configurazione è completa.

Per i passaggi dettagliati con schermate, consulti Integrazione con Claude: guida alla configurazione. Si consiglia di impostare le operazioni di scrittura su «chiedi ogni volta» nelle impostazioni dell’estensione in Claude.

Cosa può fare

  • Ticket: ricerca (per progetto, stato, assegnatario, autore, priorità, parola chiave, scadenza, ticket padre), consultazione di dettagli e commenti, creazione (anche indicando ticket padre e destinatari delle notifiche), modifica dei campi, pubblicazione di commenti, cambio di stato.
  • Progetti: consultazione di elenco e dettagli, creazione (tranne gli ospiti), modifica di nome, descrizione, proprietario e periodo, passaggio tra completato e non completato, aggiunta e rimozione di membri (proprietario e amministratori).
  • Wiki: consultazione, riscrittura di titolo e testo, aggiunta in fondo (membri del progetto e amministratori).
  • Note: elenco, ricerca, consultazione, creazione, riscrittura e integrazione delle proprie note.
  • Impostazioni di base: aggiunta di tipi di ticket, stati, priorità, qualifiche e reparti e modifica di nome e colore (amministratori).
  • Diagramma di Gantt: salva sul PC i ticket di un progetto (fino a 5.000) in un file Excel. Oltre i 120 giorni, 1 colonna = 1 settimana.
  • Ricerca utenti: trova utenti per nome (solo ID e ruolo; gli indirizzi e-mail non vengono restituiti).

I ticket si possono indicare con chiavi come «WEB-12». Per scrivere servono sia un token «Lettura e scrittura» sia «Consenti la scrittura» del sito.

Limitazioni e limiti

  • Non è possibile eliminare (progetti, ticket, commenti, impostazioni di base, wiki, note), modificare commenti, allegare o consultare immagini e file, cambiare la chiave di un progetto né riordinare le impostazioni di base.
  • Non è possibile aggiungere o modificare utenti, cambiare le impostazioni del sito, usare la bacheca Kanban, i segnalibri o le impostazioni delle notifiche, né leggere le note di altri utenti (nemmeno da amministratore).
  • Le scritture avvengono una alla volta. Più elementi vengono eseguiti da Claude uno per uno. L’attesa della risposta è di 30 secondi e, per evitare registrazioni doppie, le scritture non vengono ritentate automaticamente.
  • Il titolo di un ticket può contenere fino a 50 caratteri e il nome di un’impostazione di base fino a 20 (fino a 10 voci ciascuna, colore a scelta tra 8). Il testo del wiki può arrivare a 65.535 byte in totale e quello di una nota a 1.000.000 di byte.
  • I testi letti da Claude vengono troncati oltre 8.000 caratteri per descrizioni, wiki e note e oltre 2.000 caratteri per i commenti. I testi troncati non vengono riscritti: Claude suggerisce invece di aggiungere contenuto in fondo.
  • Ricerche ed elenchi mostrano fino a 50 risultati per pagina. Il limite di frequenza è di 60 richieste al minuto per token.
  • Si può usare solo mentre l’app desktop di Claude è in esecuzione sul PC.

Cronologia ed e-mail di notifica

  • Le modifiche ai campi dei ticket, come le modifiche dalle schermate, non lasciano un commento di cronologia e non inviano e-mail. Per lasciare la cronologia, chieda «fai la modifica tramite un commento».
  • Se cambia lo stato o altro tramite un commento, come nelle schermate viene registrata la cronologia e ricevono un’e-mail i membri che ricevono le notifiche di tutti i commenti.
  • Alla creazione di un ticket ricevono un’e-mail solo i membri indicati come destinatari delle notifiche. Alla creazione di un progetto i membri ricevono un’e-mail di invito (non inviata per le aggiunte successive).
  • Le operazioni vengono registrate come operazioni del titolare del token, senza l’indicazione «tramite Claude».

Sicurezza e trattamento dei dati

Quando l’integrazione con Claude è disattivata, l’API viene trattata come un URL inesistente (404). Anche progetti e ticket per cui non si hanno permessi vengono trattati come «inesistenti». Sul server viene salvato solo l’hash dei token, e la restrizione di accesso per indirizzo IP di GeckoFlag si applica anche all’API. Il contenuto di ticket, wiki e note letto da Claude viene inviato ad Anthropic come parte della conversazione. Prima di adottare la funzione, verifichi che le norme interne o i contratti con i clienti non limitino l’invio a servizi esterni. Se la connessione non riesce, consulti Se qualcosa non funziona.