Créer un plug-in pour un agent déclaratif à partir d’un serveur MCP

Ce guide vous montre comment intégrer votre service à un agent déclaratif pour Microsoft 365 Copilot en ajoutant un serveur MCP en tant que plug-in à l’aide de Microsoft 365 Agents Toolkit. En suivant ces étapes, vous activez l’accès conversationnel basé sur l’IA à vos services exposés à MCP pour les utilisateurs professionnels.

Cette procédure pas à pas utilise le serveur GitHub MCP comme exemple. Le serveur MCP GitHub est un serveur MCP distant, fourni et géré par GitHub, qui expose des outils pour travailler avec des référentiels, des problèmes, des demandes de tirage et d’autres fonctionnalités GitHub. Vous l’utilisez ici pour créer un agent capable de rechercher des référentiels et des utilisateurs GitHub à partir d’invites en langage naturel. Vous pouvez suivre les mêmes étapes avec votre propre serveur MCP.

Générez et utilisez le plug-in en quatre étapes : créer un client OAuth pour l’authentification, créer l’agent, publier et charger une version test de l’agent, puis utiliser l’agent.

Configuration requise

Avant de commencer, assurez-vous que vous disposez des conditions préalables suivantes :

• Configuration requise spécifiée dans Configuration requise pour les options d’extensibilité de Copilot
• Visual Studio Code
• Microsoft 365 Agents Toolkit version 6.12.0 ou ultérieure

Pour compléter l’exemple GitHub de cette procédure pas à pas, vous avez également besoin d’un compte GitHub. Un compte GitHub n’est pas nécessaire pour créer un plug-in à partir de votre propre serveur MCP.

Étape 1 : Création d’un client OAuth pour l’authentification

Le serveur GitHub MCP exige que chaque utilisateur se connecte avant de renvoyer des données, le plug-in a donc besoin d’un client OAuth. Dans ce guide, utilisez OAuth (avec inscription statique). Lorsque vous créez l’agent et sélectionnez ce type d’authentification, Agents Toolkit vous invite immédiatement à entrer ces valeurs, donc créez d’abord le client. Copilot utilise ensuite l’inscription pour obtenir un jeton d’accès au nom de l’utilisateur connecté chaque fois que l’agent appelle le serveur MCP.

Pour créer un client OAuth :

1. Accédez à https://github.com/settings/developers dans votre navigateur. Sélectionnez Applications >OAuthNouvelle application OAuth.

2. Ajoutez un nom et une URL de page d’accueil pour votre application, et définissez-la https://teams.microsoft.com/api/platform/v1.0/oAuthRedirect comme URL de rappel d’autorisation. Sélectionnez Enregistrer l’application.

3. Une fois l’application créée, sélectionnez Générer une nouvelle clé secrète client. Copiez le secret et l’ID client à entrer lorsque vous créez l’agent.

Étape 2 : Créer l’agent

Pour créer l’agent :

1. Ouvrez Visual Studio Code et sélectionnez l’icône Microsoft 365 Agents Toolkit dans la barre d’activité.

2. Sélectionnez Créer un agent/une application dans le volet Office Agents Toolkit.

   

3. Sélectionnez l’agent déclaratif.

4. Sélectionnez Ajouter une action, puis sélectionnez Démarrer avec un serveur MCP.

5. Entrez l’URL https://api.githubcopilot.com/mcp/du serveur GitHub MCP.

   

6. Sélectionnez le type d’authentification. Pour cet exercice, sélectionnez OAuth (avec inscription statique).

   

7. Lorsque vous y êtes invité, entrez l’ID client de l’application OAuth que vous avez inscrite, puis entrez la clé secrète client.

8. Lorsque vous êtes invité à indiquer des étendues, appuyez sur Entrée pour continuer.

9. Choisissez un emplacement pour le projet d’agent.

10. Entrez un nom pour l’agent.

Une fois ces étapes terminées, Agents Toolkit génère les fichiers requis pour l’agent et ouvre une nouvelle fenêtre Visual Studio Code avec le projet d’agent chargé.

Agents Toolkit configure le manifeste de plug-in généré (ai-plugin.json) pour la découverte d’outils dynamiques, de sorte que l’agent résout les outils du serveur MCP - y compris ceux qui renvoient des widgets d’interface utilisateur (applications MCP) - au moment de l’exécution et que vous n’ajoutiez pas d’outils manuellement. Pour épingler un ensemble d’outils fixe et organisé, consultez Configurer des outils épinglés avec Agents Toolkit.

Étape 3 : Publier et charger une version test de l’agent

Pour publier et charger une version test de l’agent :

1. Dans le volet Comptes de la boîte à outils des agents, sélectionnez Se connecter à Microsoft 365. (Si vous êtes déjà connecté, passez à l’étape suivante).

2. Vérifiez que Chargement d’application personnalisée activé et Accès Copilot activé s’affichent sous votre compte Microsoft 365. Si ce n’est pas le cas, contactez l’administrateur de votre organization pour la mettre en case activée. Pour plus d’informations, consultez Configuration requise pour les options d’extensibilité de Copilot.

3. Dans le volet Cycle de vie , sélectionnez Provisionner.

4. Lisez le message dans la boîte de dialogue, puis sélectionnez Confirmer pour continuer.

5. Attendez que la boîte à outils signale que l’approvisionnement est terminé.

Étape 4 : Utiliser l’agent

Pour utiliser l’agent :

1. Dans votre navigateur, accédez à https://m365.cloud.microsoft/chat.

2. Dans la section Agents de la barre latérale, recherchez votre agent. Il s’agit du nom que vous avez donné à l’Étape 2 : créer l’agent, avec dev un ajout à la fin. Sélectionnez l’agent.

3. Demandez à l’agent de trouver un référentiel ou un utilisateur. Par exemple : can you find a repo for kiota?.

4. Lorsque vous y êtes invité, sélectionnez Se connecter à {agent-name}. Dans la fenêtre contextuelle, connectez-vous avec votre compte GitHub et autorisez l’agent.

5. Lorsque la fenêtre contextuelle se ferme, l’agent renvoie une réponse.

   

6. Si l’outil appelé par l’agent renvoie un widget d’interface utilisateur (application MCP), vérifiez que l’agent affiche le widget en ligne dans la réponse. Pour plus d’informations, consultez Ajouter des applications MCP aux agents déclaratifs dans Microsoft 365 Copilot.

Contenu connexe

• Ajouter des applications MCP aux agents déclaratifs dans Microsoft 365 Copilot