Konfigurieren der Authentifizierung für MCP- und API-Plug-Ins in Agents

Tipp

Empfohlen: Beginnen Sie mit Work IQ Dev Tools für unterstützte Pro-Code-, deklarative Agent- und Plug-In-Szenarien. Siehe WIQD-Schnellstart. Toolkitbasierte Anweisungen bleiben für vorhandene Projekte und Workflows verfügbar, die sie erfordern. Überprüfen Sie die Unterstützung der Funktionen und der Zielerfahrung , bevor Sie ein Tool auswählen: WIQD ist nicht für benutzerdefinierte Engine-Agenten vorgesehen.

Deklarative Agents in Microsoft 365 Copilot stellen über API- oder MCP-Plug-Ins eine Verbindung mit Back-End-Diensten her. Diese Aktionsintegrationen verbinden den Agent mit einem MCP-Server (Model Context Protocol) oder einer API, die in einem OpenAPI-Dokument beschrieben wird. Konfigurieren Sie die Authentifizierung, damit Microsoft 365 Copilot die richtigen Anmeldeinformationen im Namen des angemeldeten Benutzers abrufen und senden kann.

Hinweis

In diesem Artikel wird die Authentifizierung in einem API- oder MCP-Plug-In-Manifest für einen deklarativen Agent konfiguriert. Das äußere installierbare Paket wird nicht konfiguriert. Siehe Plugins und deklarative Agentaktionen für die Manifestbeziehung.

In den exemplarischen Vorgehensweisen für die Authentifizierung wird ein MCP-Plug-In als Standardbeispiel verwendet. Das MCP-Plug-In ist die Integration des Agenten in den Remoteserver, nicht den Server selbst. Die gleichen Konfigurationsschritte gelten für API-Plug-Ins, die aus einem OpenAPI-Dokument erstellt wurden, sofern nicht in jedem Artikel angegeben.

Unterstützte Authentifizierungsschemas

Wählen Sie das Authentifizierungsschema aus, das der Art und Weise entspricht, wie Ihr MCP-Server oder Ihre API seine Endpunkte schützt:

Authentifizierungsschema MCP-Plugins API-Plug-Ins Artikel
Microsoft Entra einmaliges Anmelden (SSO) Unterstützt Unterstützt Konfigurieren der Microsoft Entra SSO-Authentifizierung
Dynamische Clientregistrierung (DCR) Unterstützt Nicht unterstützt Konfigurieren der dynamischen Clientregistrierung
OAuth 2.0 Autorisierungscodeflow Unterstützt Unterstützt OAuth 2.0-Authentifizierung konfigurieren
API-Schlüssel Nicht unterstützt Unterstützt API-Schlüssel-Authentifizierung konfigurieren
Keine Authentifizierung (anonym) Unterstützt Unterstützt Keine Authentifizierung konfigurieren (anonym)

Hinweis

Diese Tabelle behandelt MCP- und API-Plug-Ins, die als deklarative Agentaktionen verwendet werden. Ein Plug-In, das im agentConnectors Microsoft 365-App-Manifest auf einen Remote-MCP-Server verweist, verwendet eine andere Autorisierungskonfiguration. Dieses Schema umfasst ApiKeyPluginVault, während MCP-Plug-Ins, die als deklarative Agent-Aktionen verwendet werden, API-Schlüssel nicht unterstützen. Informationen zu Konfigurations- und Hostanforderungen finden Sie unter Konfigurieren von MCP-Remoteservern für Microsoft 365 Copilot-Plug-Ins.

Funktionsweise der Plug-In-Authentifizierung

Für Schemas, die Anmeldeinformationen erfordern, ist eine Authentifizierungskonfiguration (Authentifizierungskonfiguration) ein im Microsoft Enterprise-Tokenspeicher gespeicherter Eintrag, der die Anmeldeinformationen oder Clientdetails enthält, die für die Authentifizierung bei Ihrem MCP-Server oder Ihrer API erforderlich sind. Für anonymen Zugriff ist keine Authentifizierungskonfiguration erforderlich. Wählen Sie den unterstützten Konfigurationspfad für Ihr Projekt aus:

  • Work IQ Dev Tools (empfohlen) konfiguriert die Authentifizierung, wenn Sie eine OpenAPI- oder Remote-MCP-Aktion mit wiqd agent add actionhinzufügen. Um einen unterstützten Authentifizierungstyp in einem vorhandenen Plug-In-Manifest zu konfigurieren, verwenden Sie wiqd agent add auth. Befolgen Sie die unten stehenden schemaspezifischen WIQD-Anweisungen für die richtigen Optionen, und führen Sie dann den Bereitstellungsworkflow des Agents für Ihre Umgebung aus.
  • Das Microsoft 365 Agents Toolkit erstellt die Authentifizierungskonfiguration und aktualisiert Ihr Plug-In-Manifest automatisch, wenn Sie den Agent erstellen.
  • Der Entwicklerskill "Deklarativer Agent" (nur MCP-Plug-Ins) erstellt die Authentifizierungskonfiguration und aktualisiert das Manifest für Sie über Anweisungen in natürlicher Sprache.
  • Im Microsoft Teams-Entwicklerportal können Sie die Authentifizierungskonfiguration manuell erstellen oder ein von Agents, Toolkit oder den erstellten Skill verwalten.

Bei authentifizierten Schemata verweist Ihr Plug-In-Manifest anhand seiner ID im Laufzeitauthentifizierungsobjekt auf die Authentifizierungskonfiguration. Zur Laufzeit verwendet Microsoft 365 Copilot die Authentifizierungskonfiguration, um ein Token oder einen API-Schlüssel aus dem Tokenspeicher abzurufen, und fügt es ein, wenn das Plug-In Ihren MCP-Server oder Ihre API aufruft.

Beginnen Sie mit dem WIQD-Abschnitt für das ausgewählte Authentifizierungsschema. Dieselben Artikel enthalten Toolkit-, Entwickler-Skill-, Portal- und manuelle Alternativen, sofern unterstützt.

Hinweis

Folgen Sie für ein Plug-In-Paket, das Cowork mit einem Remote-MCP-Server verbindet, der Authentifizierung im App-Manifest. Schritte zur Registrierung freigegebener Anmeldeinformationen machen diese Konfiguration nicht austauschbar mit der MCP-Plug-In-Manifestkonfiguration eines Agents. Wenn Ihr OAuth-Anbieter die Microsoft Identity Platform verwendet und die Verbindung eine automatische Tokenaktualisierung benötigt, schließen Sie sie in das Feld Bereich der OAuth-Konfiguration mit allen API-spezifischen delegierten Bereichen einoffline_access.