Assistants IA (MCP) : pas à pas

Connecter Claude, ChatGPT, Cursor... au moral de tes équipes.

1 Ce qu'un assistant IA peut faire

SmileAgile a un serveur MCP : un assistant IA (Claude, ChatGPT, Cursor...) peut lire le moral de tes équipes et t'aider à préparer tes rétrospectives, tes bilans de santé et tes rapports.

Il voit exactement ce que tu vois dans SmileAgile, avec tes droits, et rien de plus.

Ce qu'il ne peut pas faire, volontairement

  • Voter : les votes doivent venir de personnes.
  • Voir qui a voté quoi : les résultats sont toujours agrégés.
  • Supprimer une équipe, un sondage ou un département, ou modifier les réglages du compte.

2 Créer un jeton

Pour Claude Code, Cursor et les autres outils installés sur ton ordinateur : un jeton d'accès personnel. Mon profil, Assistants IA (MCP):

  1. Nomme-le d'après l'outil et l'appareil, par ex. Claude Code sur mon portable.
  2. Choisis son accès : Lecture seule, ou Lecture et écriture pour aussi créer, clôturer et rouvrir des sondages et publier des liens de graphiques.
  3. Choisis son expiration : 30 jours, 90 jours ou 1 an.
  4. Copie-le tout de suite : il n'est affiché qu'une fois.
La création d'un jeton d'accès personnel dans Mon profil

Traite un jeton comme un mot de passe : quiconque l'a peut lire les données de tes équipes.

Tu peux révoquer un jeton à tout moment dans Mon profil : les assistants IA qui l'utilisent perdent leur accès immédiatement.

claude.ai, ChatGPT et les autres connecteurs web n'ont pas besoin de jeton : ils te demandent ton consentement à la place (étape suivante).

3 Connecter ton assistant IA

L'adresse du serveur MCP :

https://www.smileagile.io/mcp

Claude Code

Dans un terminal, avec ton jeton à la place de sa_... :

claude mcp add --transport http smileagile https://www.smileagile.io/mcp --header "Authorization: Bearer sa_..."

Ensuite, dans une nouvelle session, /mcp affiche smileagile comme connecté.

Cursor

Dans le fichier ~/.cursor/mcp.json, avec ton jeton à la place de sa_... :

{
  "mcpServers": {
    "smileagile": {
      "url": "https://www.smileagile.io/mcp",
      "headers": { "Authorization": "Bearer sa_..." }
    }
  }
}

Ou seulement l'adresse, sans les en-têtes : Cursor te demande alors ton consentement, comme claude.ai. Redémarre Cursor après avoir modifié le fichier.

claude.ai, Claude Desktop

Aucun jeton à copier : Personnaliser (ou Paramètres), Connecteurs, Ajouter un connecteur personnalisé, avec l'adresse du serveur MCP.

SmileAgile te demande de te connecter, puis montre ce que l'assistant pourra faire : autorise-le, et autorise aussi les modifications si tu veux qu'il crée ou clôture des sondages.

Le consentement que demande un assistant IA

L'accès apparaît ensuite dans Mon profil comme Connecté (OAuth), où tu peux le révoquer.

Avec une offre Team ou Enterprise, un propriétaire ajoute d'abord le connecteur à ton organisation Claude.

ChatGPT

Dans les paramètres de ChatGPT, active le mode développeur (Apps ou Connecteurs, Paramètres avancés), puis crée un connecteur avec l'adresse du serveur MCP et l'authentification OAuth.

SmileAgile te demande de te connecter et d'autoriser l'accès, comme pour claude.ai.

Le mode développeur dépend de ton offre ChatGPT : consulte l'aide d'OpenAI.

Autres assistants IA

Tout client qui gère les serveurs MCP distants (Streamable HTTP) fonctionne : avec un jeton d'accès personnel dans l'en-tête Authorization, ou avec OAuth.

4 Que demander

Demande avec tes propres mots, par ex. :

  • Comment va le moral de mes équipes ce mois-ci ?
  • Prépare ma prochaine rétrospective pour l'équipe Phoenix.
  • Quelles équipes de mon département dois-je surveiller ?
  • Crée le sondage de ce sprint et donne-moi le lien à partager.

À quoi ça ressemble

Exemple : une équipe fictive
Prépare ma prochaine rétrospective pour l'équipe Phoenix.
  • Moral : 3,1 sur 5, en baisse depuis 3,8 sur les 3 derniers sprints ; 7 votes sur 8.
  • Thèmes des commentaires : les exigences qui changent pendant le sprint (3 commentaires), les sessions de pair programming appréciées (2).
  • Un sujet à aborder : qu'est-ce qui nous aiderait à fixer le périmètre au sprint planning ?
  • Un format : Mad / Sad / Glad, pour laisser d'abord sortir la frustration.

Outils

Lecture : les équipes, les sondages, leurs résultats agrégés, l'évolution du moral, la participation d'un sondage ouvert, les départements (organizations, dans les outils), et les commentaires d'un sondage clôturé.

Écriture, avec un accès Lecture et écriture : créer, clôturer et rouvrir un sondage, publier ou révoquer le lien du graphique d'une équipe. L'assistant te demande avant de modifier quoi que ce soit.

Prompts

Des demandes toutes prêtes : Préparer ma rétrospective, Bilan de santé du sprint, Rapport de département. Dans Claude Code, par ex. :

/mcp__smileagile__prepare_retrospective Phoenix

Ressources

Le graphique du moral d'une équipe, en image, et cette documentation.

Compétences

Apprends une méthode à ton assistant, par ex. un script de rétrospective minute par minute ou des actions SMART, à partir des données de tes équipes : Compétences IA : pas à pas.

5 Un sprint avec ton assistant IA

Du sondage à la rétrospective, par ex. pour l'équipe Phoenix, avec un accès Lecture et écriture :

  1. Avant la fin du sprint, vérifie qu'aucun sondage n'est encore ouvert :
    Y a-t-il un sondage ouvert pour mes équipes ?
  2. Ouvre le sondage et invite l'équipe :
    Ouvre le sondage de ce sprint pour Phoenix, et écris un courriel qui invite l'équipe à voter.
    SmileAgile n'envoie pas le courriel : les adresses de tes coéquipiers ne sont pas partagées avec l'assistant. Il écrit le courriel pour que tu l'envoies, ou l'envoie avec son propre connecteur de messagerie (Gmail, Outlook...) si tu en as connecté un.
  3. Deux jours, puis un jour avant la rétrospective, vérifie la participation :
    Notre rétrospective est jeudi : combien de personnes ont voté pour Phoenix ? Si c'est moins que d'habitude, écris un rappel.
    L'assistant n'agit pas tout seul : demande-lui ces jours-là, ou planifie-le si ton assistant le permet, par ex. une tâche planifiée dans Claude Code. Le prompt Bilan de santé du sprint fait aussi cette vérification.
  4. Le jour même, clôture le sondage et prépare la rétrospective :
    Clôture le sondage Phoenix et prépare ma rétrospective, avec le graphique.
    L'assistant te demande avant de clôturer le sondage. Les commentaires deviennent lisibles une fois qu'il est clôturé : le prompt Préparer ma rétrospective propose alors des sujets à aborder et un format.

6 Confidentialité et sécurité

  • Les résultats sont agrégés : jamais qui a voté quoi, commentaires compris.
  • Les commentaires sont écrits par les votants : l'assistant les reçoit comme du texte à analyser, jamais comme des instructions.
  • Chaque lecture des commentaires et chaque modification sont enregistrées.
  • Les votants sont prévenus, sur la page de vote, que leurs commentaires peuvent être analysés avec des outils d'IA.
  • Ce que l'assistant fait des données dépend de son fournisseur : vérifie ses réglages de confidentialité.

7 Dépannage

  • 401 Le jeton est invalide, révoqué ou expiré : crées-en un nouveau.
  • 403 Ton compte doit posséder une équipe ou un département.
  • Rate limit reached Trop de requêtes : 60 par minute et par jeton ou connexion. Le message indique combien de secondes attendre avant de réessayer.
  • MCP server smileagile already exists in local config Claude Code a déjà un serveur avec ce nom, par ex. avec un ancien jeton : supprime-le d'abord, puis ajoute-le à nouveau. Utilise le nom donné à claude mcp add, par ex. smileagile-dev pour un serveur de test.
    claude mcp remove smileagile