Avant de commencer
- L’accès à une équipe Qwairy sur une offre Starter ou supérieure. Vous pouvez vous connecter avant toute collecte. Les requêtes renvoient des données dès qu’une marque active a des réponses générées.
- Un agent Copilot Studio que vous pouvez modifier, avec l’orchestration générative activée. Les agents Copilot Studio n’utilisent les serveurs MCP qu’avec l’orchestration générative, que le plan Copilot Studio pour Teams inclus dans certains abonnements Microsoft 365 ne propose pas.
- Un agent qui authentifie ses utilisateurs. Conservez l’option par défaut Authentifier avec Microsoft, ou utilisez Authentifier manuellement. Avec Aucune authentification, l’agent ne peut pas utiliser d’outils avec les identifiants des utilisateurs.
- Un agent monolocataire. Copilot Studio ne prend pas en charge les outils MCP en mode multilocataire.
- Des stratégies de données Power Platform qui autorisent la connexion. Copilot Studio accède aux serveurs MCP par des connecteurs Power Platform, donc les stratégies de données de votre organisation s’appliquent aussi à Qwairy.
Connecter Qwairy à votre agent
1
Ouvrez l’assistant d’intégration MCP
Dans Copilot Studio, ouvrez votre agent et accédez à Outils. Sélectionnez Ajouter un outil, puis Nouvel outil, puis Model Context Protocol.
2
Renseignez les détails du serveur
Remplissez les champs obligatoires.
L’agent lit la description pour décider quand appeler Qwairy. Adaptez-la aux questions auxquelles votre agent doit répondre.
3
Choisissez OAuth 2.0 avec la découverte dynamique
Sélectionnez OAuth 2.0 comme type d’authentification, puis Découverte dynamique. Sélectionnez Créer, puis Suivant.Copilot Studio trouve les points de connexion de Qwairy et s’inscrit automatiquement. Vous ne saisissez ni ID client, ni clé secrète client, ni URL OAuth.
4
Connectez votre compte Qwairy
Dans Ajouter un outil, sélectionnez Créer une connexion. Quand la page de connexion Qwairy s’ouvre, connectez-vous avec le compte Qwairy qui a accès à vos marques et autorisez l’accès. Sélectionnez ensuite Ajouter à l’agent.
Vérifier que la connexion fonctionne
Dans Outils, sélectionnez Qwairy et vérifiez que ses outils apparaissent. Envoyez ensuite ce message dans le volet de test de votre agent :list_brands de Qwairy et afficher les marques accessibles. Si le volet de test vous demande de connecter ou d’autoriser Qwairy, suivez ses instructions et renvoyez le message. Une réponse générale sans appel d’outil ne confirme pas la connexion.
Si Qwairy indique qu’aucune marque n’a été trouvée, la connexion fonctionne, mais le compte Qwairy connecté n’a accès à aucune marque active. Reconnectez-vous avec le compte qui a accès à vos marques.
Partager l’agent avec vos collègues
Publiez à nouveau l’agent après avoir ajouté Qwairy. Tant que vous ne le publiez pas, les personnes qui utilisent l’agent sur ses canaux conservent la version précédente. Par défaut, la connexion Qwairy utilise les identifiants de chaque utilisateur. Chaque personne qui utilise l’agent se connecte avec son propre compte Qwairy et ne voit que les marques auxquelles ce compte a accès. Avec Informations d’identification fournies par le créateur, chaque utilisateur interroge Qwairy avec votre compte et ses accès.Dépannage
Copilot Studio ne propose qu’OAuth 2.0
Sélectionnez OAuth 2.0 avec Découverte dynamique. Le serveur d’autorisation de Qwairy suit OAuth 2.1, qui consolide les pratiques d’OAuth 2.0, et cette option de Copilot Studio mène sa connexion à terme. Aucune option OAuth 2.1 n’est nécessaire.Copilot Studio demande un ID client, une clé secrète client ou des URL
Vous avez sélectionné Dynamique ou Manuel. Revenez au type d’authentification et choisissez Découverte dynamique, qui permet à Copilot Studio de s’inscrire lui-même auprès de Qwairy. Si l’outil existe déjà, retirez-le de l’agent et ajoutez-le à nouveau.L’agent répond sans appeler Qwairy
Vérifiez que l’orchestration générative est activée pour l’agent et que son authentification n’est pas réglée sur Aucune authentification. Ouvrez ensuite Outils, sélectionnez Qwairy et vérifiez que ses outils apparaissent et sont activés. Si l’agent répond toujours à partir de ses connaissances générales ou du web, vérifiez comment la connexion s’authentifie. Qwairy refuse les requêtes sans jeton Qwairy valide dans l’en-têteAuthorization, par exemple celles d’une connexion créée sans authentification. Retirez Qwairy de l’agent, ajoutez-le à nouveau avec OAuth 2.0 et Découverte dynamique, puis créez une connexion.
La connexion est bloquée
Une stratégie de données Power Platform peut bloquer le connecteur que Copilot Studio a créé pour Qwairy. Demandez à votre administrateur Power Platform de l’autoriser dans l’environnement de votre agent. Si le connecteur est autorisé mais que Qwairy reste indisponible pour certains utilisateurs ou groupes, une politique de l’organisation peut limiter l’outil. Un administrateur Microsoft 365 peut examiner la demande d’accès dans le centre d’administration Microsoft 365, sous Agents > Tools > Requests.L’autorisation échoue
Connectez-vous avec le compte Qwairy qui a accès à vos marques, et vérifiez que son équipe est sur une offre Starter ou supérieure. Si le problème persiste, retirez Qwairy de l’agent, ajoutez-le à nouveau et créez une connexion. Consultez le dépannage général.Documentation officielle
Les libellés de l’interface, les plans, l’authentification et les stratégies de données sont maintenus par Microsoft. Consultez Connecter votre agent à un serveur MCP existant, Étendre votre agent avec le Model Context Protocol et Configurer l’authentification des utilisateurs dans Copilot Studio. Procédure vérifiée d’après la documentation de Microsoft le 20 novembre 2026.Étapes suivantes
- Référence des outils : le rôle de chaque outil Qwairy
- Exemples de conversations : des prompts à essayer
- Tous les clients pris en charge

