> ## Documentation Index
> Fetch the complete documentation index at: https://docs.qwairy.co/llms.txt
> Use this file to discover all available pages before exploring further.

# Connecter Qwairy à Microsoft Copilot Studio

> Oui. Ajoutez Qwairy à un agent Copilot Studio avec OAuth 2.0 et la découverte dynamique. URL : https://mcp.qwairy.co. Orchestration générative requise.

Qwairy fonctionne avec les agents créés dans Microsoft Copilot Studio comme serveur MCP distant. Vous ajoutez Qwairy à votre agent avec l’assistant d’intégration MCP et vous connectez votre compte Qwairy avec OAuth. L’agent peut ensuite appeler les outils Qwairy pour répondre à vos questions sur vos marques.

Cette page concerne les agents Copilot Studio qui fonctionnent avec le moteur standard et utilisent l’assistant d’intégration MCP. Pour un agent créé dans la nouvelle expérience Microsoft Copilot (préversion), Microsoft décrit un autre parcours depuis l’onglet **Build** dans [Add an MCP server to your agent (Microsoft Copilot)](https://learn.microsoft.com/en-us/microsoft-copilot-studio/agents-experience/tools-add-mcp-server). Pour GitHub Copilot dans VS Code, consultez [Connecter GitHub Copilot](https://docs.qwairy.co/fr/mcp/clients/github-copilot.md).

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

| Champ | Valeur |
| - | - |
| Nom du serveur | `Qwairy` |
| Description du serveur | `Qwairy data on how AI assistants mention and cite our brands, competitors, and sources.` |
| URL du serveur | `https://mcp.qwairy.co` |

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 :

```text theme={null}
Utilise Qwairy pour lister les marques auxquelles j’ai accès.
```

L’agent doit appeler l’outil `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ête `Authorization`, 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](https://docs.qwairy.co/fr/mcp/getting-started.md#dépannage).

## 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](https://learn.microsoft.com/fr-fr/microsoft-copilot-studio/mcp-add-existing-server-to-agent), [Étendre votre agent avec le Model Context Protocol](https://learn.microsoft.com/fr-fr/microsoft-copilot-studio/agent-extend-action-mcp) et [Configurer l’authentification des utilisateurs dans Copilot Studio](https://learn.microsoft.com/fr-fr/microsoft-copilot-studio/configuration-end-user-authentication).

Procédure vérifiée d’après la documentation de Microsoft le 20 novembre 2026.

## Étapes suivantes

* [Référence des outils](https://docs.qwairy.co/fr/mcp/tools/discovery.md) : le rôle de chaque outil Qwairy
* [Exemples de conversations](https://docs.qwairy.co/fr/mcp/examples/getting-started.md) : des prompts à essayer
* [Tous les clients pris en charge](https://docs.qwairy.co/fr/mcp/getting-started.md#choisir-un-client)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.