Assistants IA (MCP) pas à pas

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.

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, 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.

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 et les autres connecteurs web n'ont pas besoin de jeton : ils te demandent ton consentement à la place (étape suivante).

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_..." }
    }
  }
}

claude.ai, Claude Desktop

Aucun jeton à copier : 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.

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

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.

Demande avec tes propres mots, ex. :

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

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, 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, ex. : /mcp__smileagile__prepare_retrospective Avengers

Ressources

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

Du sondage à la rétrospective, ex. pour l'équipe Avengers, 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 Avengers, et écris un email qui invite l'équipe à voter.
   SmileAgile n'envoie pas l'email : les adresses de tes coéquipiers ne sont pas partagées avec l'assistant. Il écrit l'email pour que tu l'envoies, ou l'envoie avec son propre connecteur email (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 Avengers ? 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, 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 Avengers 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.

• Les résultats sont agrégés : jamais qui a voté quoi, aussi pour les commentaires.
• 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é.

• 401 Le jeton est faux, révoqué ou expiré : crées-en un nouveau.
• 403 Ton compte doit posséder une équipe ou un département.
• 429 Trop de requêtes (120 par minute et par jeton) : attends une minute.
• MCP server smileagile already exists in local config Claude Code a déjà un serveur avec ce nom, ex. avec un ancien jeton : supprime-le d'abord, puis ajoute-le à nouveau. Utilise le nom donné à claude mcp add, ex. smileagile-dev pour un serveur de test.

  claude mcp remove smileagile