Passer au contenu principal

Présentation

Teamova expose un serveur MCP (Model Context Protocol) qui vous permet d’interagir avec vos données Planning Poker depuis n’importe quel assistant IA. Posez des questions sur vos sessions, consultez les résultats et créez de nouvelles sessions — le tout en langage naturel.

Multi-plateforme

Compatible avec Claude, ChatGPT, Copilot, Gemini et tout client MCP.

Sécurisé par conception

OAuth 2.1 avec PKCE — vous contrôlez quelles organisations et quelles permissions accorder.

Démarrage rapide

Prérequis

  • Vous avez un compte Teamova actif.
  • Vous êtes membre d’au moins une organisation.
  • Vous utilisez un assistant IA compatible MCP (Claude, ChatGPT, Copilot, Gemini, …).
1

Trouvez votre URL de serveur MCP

Allez dans Compte > Comptes Connectés dans Teamova. L’URL du serveur MCP est affichée dans la section MCP en bas de la page.
https://mcp.teamova.net/mcp
2

Ajoutez à votre assistant IA

Collez l’URL dans les paramètres MCP de votre assistant IA :
  • Claude : Paramètres > Serveurs MCP > Ajouter un serveur
  • ChatGPT : Paramètres > Apps > Ajouter un serveur MCP
  • Copilot : Copilot Studio > Actions > MCP
  • Gemini : Paramètres > Serveurs MCP
3

Autorisez l'accès

Votre assistant IA vous redirigera vers l’écran de consentement Teamova. Sélectionnez les organisations auxquelles accorder l’accès, vérifiez les permissions et cliquez sur Autoriser.Vous pouvez sélectionner une ou plusieurs organisations — l’assistant IA pourra accéder aux données de toutes les organisations sélectionnées.Après autorisation, la page confirmera que la connexion a réussi. Vous pouvez ensuite retourner à votre assistant IA.
4

Commencez à utiliser

Demandez ce que vous voulez à votre assistant sur vos sessions Planning Poker :
  • « Liste mes organisations »
  • « Montre-moi les résultats de ma dernière session Planning Poker »
  • « Liste toutes les sessions actives dans l’organisation Marketing »
  • « Crée une nouvelle session Planning Poker pour le Sprint 13 »

Outils disponibles

Le serveur MCP expose les outils suivants aux assistants IA :
OutilTypeDescription
teamova_list_organizationsLectureListez vos organisations autorisées avec noms et identifiants
teamova_list_sessionsLectureListez et filtrez vos sessions Planning Poker avec pagination
teamova_get_sessionLectureDétails complets d’une session : participants, stories et votes
teamova_get_session_resultsLectureRésultats agrégés : consensus, écart-type, temps de vote
teamova_create_sessionÉcritureCréez une nouvelle session avec sélection guidée du deck et de l’équipe
teamova_add_storiesÉcritureAjoutez un lot de stories à une session existante

Filtrage par organisation

Si vous avez autorisé plusieurs organisations, vous pouvez filtrer les sessions par organisation :
  • « Liste les sessions de mon organisation Marketing » — l’assistant utilisera teamova_list_organizations pour trouver l’identifiant, puis appellera teamova_list_sessions avec le filtre organization_id.
  • Si aucun filtre n’est spécifié, l’assistant retournera les sessions de toutes les organisations autorisées.
Les outils d’écriture nécessitent la permission planning-poker:write. Les outils de lecture nécessitent uniquement planning-poker:read.

Permissions

Lorsque vous connectez Teamova, vous accordez des permissions spécifiques (scopes) à l’assistant IA :
ScopeCe qu’il autorise
planning-poker:readVoir les sessions, résultats, votes et statistiques
planning-poker:writeCréer des sessions et ajouter des stories
team:readVoir les informations d’équipe et les membres
organization:readLister vos organisations autorisées
Vous pouvez révoquer l’accès à tout moment depuis Compte > Comptes Connectés.

Support multi-organisation

Teamova supporte l’autorisation d’assistants IA sur plusieurs organisations :
  • Lors du consentement, sélectionnez une ou plusieurs organisations avec les cases à cocher.
  • Après autorisation, l’assistant IA peut accéder aux données de toutes les organisations sélectionnées.
  • Utilisez « Tout sélectionner » pour autoriser rapidement toutes vos organisations.
  • Filtrez à tout moment en demandant à l’assistant de se concentrer sur une organisation spécifique.
Si vous ajoutez une nouvelle organisation par la suite, vous devrez reconnecter votre assistant IA pour l’inclure.

Sécurité

  • OAuth 2.1 + PKCE — Authentification standard avec clé de preuve pour l’échange de code
  • Accès multi-organisation — Choisissez exactement quelles organisations partager lors du consentement
  • Permissions granulaires — Les assistants IA n’accèdent qu’à ce que vous autorisez explicitement
  • Expiration des tokens — Les tokens d’accès expirent après 1 heure ; les tokens de rafraîchissement après 30 jours
  • Révocation — Révoquez l’accès instantanément depuis les paramètres de votre compte

Exemples de prompts

Voici quelques exemples de prompts à utiliser avec votre assistant IA une fois connecté :
« Quelles sont mes organisations autorisées ? »L’assistant appellera teamova_list_organizations et vous montrera tous les espaces de travail connectés.
« Montre-moi les résultats de la session Planning Poker du Sprint 12 »L’assistant appellera teamova_get_session_results et présentera les estimations consensus, l’écart-type et les temps de vote pour chaque story.
« Liste toutes les sessions actives de mon organisation Marketing »L’assistant trouvera l’identifiant de l’organisation, puis appellera teamova_list_sessions avec le filtre organisation.
« Crée une session Planning Poker Sprint 13 avec le deck Fibonacci »L’assistant utilisera teamova_create_session, demandera confirmation, puis créera la session.
« Ajoute ces stories à la session Sprint 13 : Login utilisateur, Réinitialisation mot de passe, Édition profil »L’assistant appellera teamova_add_stories pour ajouter les stories par lot.
« Compare les estimations du Sprint 11 et du Sprint 12 »L’assistant appellera teamova_get_session_results pour les deux sessions et présentera une comparaison.

Dépannage

Assurez-vous d’être connecté à Teamova avant d’autoriser l’assistant IA. Si l’écran de consentement n’apparaît pas, essayez de vider les cookies du navigateur et de vous reconnecter.
Le serveur MCP ne retourne que les sessions des organisations que vous avez autorisées. Si vous avez plusieurs organisations, vérifiez que vous avez sélectionné les bonnes lors de l’étape de consentement, ou demandez à l’assistant de « lister mes organisations » pour vérifier lesquelles sont connectées.
Si les noms d’organisation apparaissent comme des UUID au lieu de noms, reconnectez votre assistant IA. Les connexions plus anciennes peuvent ne pas contenir les noms d’organisation dans le token.
Les outils d’écriture nécessitent le scope planning-poker:write. Si vous n’avez accordé que l’accès en lecture, reconnectez-vous et sélectionnez la permission d’écriture.