Manuel

L’intégration Claude ajoute une extension à l’application de bureau Claude (Windows, macOS) pour vous permettre de piloter GeckoFlag en discutant avec Claude. Vous pouvez rechercher, consulter, créer et mettre à jour des tickets, des projets, des pages wiki et des notes, et exporter un diagramme de Gantt vers Excel. L’extension fonctionne sur le PC de l’utilisateur et communique directement avec son GeckoFlag, et uniquement avec lui. Toutes les opérations s’effectuent avec les droits du propriétaire du jeton d’API.

Réglages de l’administrateur

1. 1Ouvrez Paramètres dans le menu latéral, puis cliquez sur Modifier sur la carte Intégration Claude.
2. 2Activez Activer l’intégration Claude (désactivée par défaut). Si Claude doit aussi pouvoir créer et modifier des éléments, activez également Autoriser l’écriture, puis enregistrez. Si l’écriture n’est pas autorisée, tous les jetons sont en lecture seule.
3. 3Dans Utilisateurs, ouvrez Modifier pour l’utilisateur concerné, activez Autoriser l’intégration Claude (API) et cliquez sur Mettre à jour. Ce réglage est distinct de « Autoriser la saisie assistée par IA ». Si vous retirez l’autorisation, tous les jetons d’API de l’utilisateur sont supprimés.

Créer un jeton d’API

1. 1Ouvrez Profil dans le menu latéral et, dans la section Jetons d’API, indiquez le nom du jeton, l’expiration (30 jours, 90 jours, 365 jours ou sans expiration ; 90 jours par défaut) et l’autorisation (Lecture seule ou Lecture et écriture), puis créez le jeton.
2. 2Copiez le jeton affiché (une chaîne commençant par gfk_). Il n’est affiché qu’une seule fois, juste après sa création. Notez aussi l’« URL à saisir dans l’extension » affichée dans la même section.

• Chaque personne peut créer jusqu’à 5 jetons, et supprimer à tout moment depuis son profil ceux dont elle n’a plus besoin.
• Lorsqu’un jeton est créé, son propriétaire reçoit un e-mail de notification. Lorsqu’un utilisateur change son mot de passe, tous ses jetons sont supprimés.

Configurer l’application de bureau Claude

1. 1Dans l’application de bureau Claude, ouvrez Settings (Paramètres) → Extensions, glissez-déposez le fichier de l’extension GeckoFlag (.mcpb) et cliquez sur Install (Installer). Vous pouvez aussi l’installer en double-cliquant sur le fichier ou depuis Advanced settings (Paramètres avancés). Le fichier de l’extension est inclus dans le téléchargement auquel vous avez accès après l’achat de GeckoFlag.
2. 2Dans l’écran de configuration, renseignez les champs suivants, puis cliquez sur Save (Enregistrer).
   • GeckoFlag URL (obligatoire) : l’URL que vous avez notée. https:// est obligatoire (http:// n’est accepté que pour localhost, *.test et *.local).
   • API token (obligatoire) : le jeton copié. Il est enregistré masqué.
   • Export folder (facultatif) : le dossier où enregistrer les fichiers Excel du diagramme de Gantt. Si ce champ est vide, ils sont enregistrés dans le dossier Téléchargements.
   
3. 3Demandez à Claude « Vérifie que tu es bien connecté à GeckoFlag ». Si le propriétaire du jeton, la version de GeckoFlag et la possibilité d’écrire ou non s’affichent, la configuration est terminée.

Pour un guide détaillé avec captures d’écran, consultez le guide de configuration de l’intégration Claude. Nous vous recommandons de régler les opérations d’écriture sur « toujours demander » dans les paramètres de l’extension de Claude.

Ce que vous pouvez faire

• Tickets : recherche (par projet, statut, responsable, créateur, priorité, mot-clé, échéance ou ticket parent), consultation des détails et des commentaires, création (avec ticket parent et destinataires des notifications si besoin), modification des champs, publication de commentaires et changement de statut.
• Projets : consultation de la liste et des détails, création (sauf invités), modification du nom, de la description, du propriétaire et de la période, passage de l’état terminé à non terminé et inversement, ajout et retrait de membres (propriétaire et administrateurs).
• Wiki : consultation, réécriture du titre et du contenu, ajout de texte à la fin (membres du projet et administrateurs).
• Notes : liste, recherche, consultation, création, réécriture et ajout de texte dans vos propres notes.
• Données de référence : ajout de types de ticket, de statuts, de priorités et de postes (services), et modification de leur nom et de leur couleur (administrateurs).
• Diagramme de Gantt : enregistre sur le PC les tickets d’un projet (jusqu’à 5 000) dans un fichier Excel. Au-delà de 120 jours, l’affichage passe à 1 colonne = 1 semaine.
• Recherche d’utilisateurs : recherche d’un utilisateur par son nom (renvoie uniquement l’identifiant et le rôle, jamais l’adresse e-mail).

Vous pouvez désigner un ticket par sa clé, comme « WEB-12 ». L’écriture nécessite à la fois un jeton « Lecture et écriture » et l’option « Autoriser l’écriture » du site.