Configurer l’authentification pour les plug-ins MCP et API dans les agents

Conseil

Recommandé : Commencez avec les outils de développement Work IQ pour les scénarios de plug-in et d’agent déclaratif pro-code pris en charge. Voir le guide de démarrage rapide de WIQD. Les instructions basées sur la boîte à outils restent disponibles pour les projets existants et les flux de travail qui les nécessitent. Vérifiez la prise en charge de la capacité et de l’expérience cible avant de choisir un outil : WIQD ne cible pas les agents de moteur personnalisés.

Les agents déclaratifs dans Microsoft 365 Copilot se connectent aux services principaux via des plug-ins API ou MCP. Ces intégrations d’action connectent l’agent à un serveur MCP (Model Context Protocol) ou à une API décrite dans un document OpenAPI. Configurez l’authentification afin que Microsoft 365 Copilot puisse obtenir et envoyer les informations d’identification appropriées au nom de l’utilisateur connecté.

Remarque

Cet article configure l’authentification dans un manifeste de plug-in d’API ou MCP pour un agent déclaratif. Il ne configure pas le package installable externe. Voir Plug-ins et actions d’agent déclaratif pour la relation de manifeste.

Les procédures d’authentification utilisent un plug-in MCP comme exemple par défaut. Le plug-in MCP est l’intégration de l’agent au serveur distant, et non au serveur lui-même. Les mêmes étapes de configuration s’appliquent aux plug-ins d’API créés à partir d’un document OpenAPI, sauf indication contraire dans chaque article.

Schémas d’authentification pris en charge

Choisissez le schéma d’authentification qui correspond à la façon dont votre serveur MCP ou votre API protège ses points de terminaison :

Schéma d’authentification Plug-ins MCP Plug-ins API Article
Authentification unique (SSO) Microsoft Entra Pris en charge Pris en charge Configurer l’authentification SSO de Microsoft Entra
Inscription client dynamique (DCR) Pris en charge Non pris en charge Configurer l’inscription du client dynamique
Flux de code d’autorisation OAuth 2.0 Pris en charge Pris en charge Configurer l’authentification OAuth 2.0
Clé API Non pris en charge Pris en charge Configurer l’authentification par clé API
Aucune authentification (anonyme) Pris en charge Pris en charge Ne configurer aucune authentification (anonyme)

Remarque

Ce tableau couvre les plug-ins MCP et API utilisés comme actions d’agent déclaratif. Un plug-in qui fait référence à un serveur agentConnectors MCP distant dans le manifeste de l’application Microsoft 365 utilise une configuration d’autorisation différente. Ce schéma inclut ApiKeyPluginVault, tandis que les plug-ins MCP utilisés comme actions d’agent déclaratif ne prennent pas en charge les clés API. Pour connaître la configuration et la configuration requise pour l’hôte, consultez Configurer des serveurs MCP distants pour les plug-ins Microsoft 365 Copilot.

Fonctionnement de l’authentification par plug-in

Pour les schémas qui nécessitent des informations d’identification, une configuration d’authentification (auth config) est un enregistrement stocké dans le magasin de jetons Microsoft Enterprise qui contient les informations d’identification ou les détails client nécessaires pour s’authentifier auprès de votre serveur MCP ou API. L’accès anonyme ne nécessite pas de configuration d’authentification. Choisissez le chemin de configuration pris en charge pour votre projet :

  • Work IQ Dev Tools (recommandé) configure l’authentification lorsque vous ajoutez une action OpenAPI ou MCP distante avec wiqd agent add action. Pour configurer un type d’authentification pris en charge dans un manifeste de plug-in existant, utilisez wiqd agent add auth. Suivez les instructions WIQD spécifiques au schéma ci-dessous pour connaître les options appropriées, puis complétez le workflow d’approvisionnement de l’agent pour votre environnement.
  • Microsoft 365 Agents Toolkit crée la configuration d’authentification et met à jour automatiquement le manifeste du plug-in à mesure que vous générez l’agent.
  • La compétence de développeur d’agent déclaratif (plug-ins MCP uniquement) crée la configuration d’authentification et met à jour le manifeste pour vous à partir d’instructions en langage naturel.
  • Le portail de développement Microsoft Teams vous permet de créer manuellement la configuration d’authentification, ou d’en gérer une qui est créée par Agents Toolkit ou la compétence.

Pour les schémas authentifiés, votre manifeste de plug-in référence la configuration d’authentification par son ID dans l’objet d’authentification d’exécution. Au moment de l’exécution, Microsoft 365 Copilot utilise la configuration d’authentification pour obtenir un jeton ou une clé API à partir du magasin de jetons et l’inclut lorsque le plug-in appelle votre serveur MCP ou votre API.

Commencez par la section WIQD du schéma d’authentification choisi. Les mêmes articles conservent les alternatives Toolkit, Developer-Skill, Portal et Manual lorsqu’elles sont prises en charge.

Remarque

Pour un package de plug-in qui connecte Cowork à un serveur MCP distant, suivez l’authentification dans le manifeste de l’application. Les étapes d’inscription des informations d’identification partagées ne rendent pas cette configuration interchangeable avec la configuration du manifeste du plug-in MCP d’un agent. Si votre fournisseur OAuth utilise la plateforme d’identités Microsoft et que la connexion nécessite une actualisation automatique du jeton, incluez offline_access dans le champ Étendue de la configuration OAuth les étendues déléguées spécifiques à l’API.