Configurare l'autenticazione per i plug-in MCP e API negli agenti

Suggerimento

Consigliato: Inizia con Work IQ Dev Tools per scenari di agenti dichiarativi e plug-in pro-code supportati. Vedere la guida introduttiva di WIQD. Le istruzioni basate su toolkit rimangono disponibili per i progetti e i flussi di lavoro esistenti che le richiedono. Controlla il supporto per le funzionalità e l'esperienza di destinazione prima di scegliere uno strumento: WIQD non si rivolge agli agenti del motore personalizzato.

Gli agenti dichiarativi in Microsoft 365 Copilot si connettono ai servizi back-end tramite API o plug-in MCP. Queste integrazioni di azioni collegano l'agente a un server MCP (Model Context Protocol) o a un'API descritta da un documento OpenAPI. Configurare l'autenticazione in modo che Microsoft 365 Copilot possa ottenere e inviare le credenziali corrette per conto dell'utente connesso.

Nota

Questo articolo configura l'autenticazione in un manifesto del plug-in API o MCP per un agente dichiarativo. Non configura il pacchetto installabile esterno. Consulta Plugin e azioni dell'agente dichiarativo per la relazione manifesto.

Le procedure dettagliate di autenticazione usano un plug-in MCP come esempio predefinito. Il plug-in MCP è l'integrazione dell'agente con il server remoto, non il server stesso. Gli stessi passaggi di configurazione si applicano ai plug-in API creati da un documento OpenAPI, tranne dove indicato in ciascun articolo.

Schemi di autenticazione supportati

Scegli lo schema di autenticazione che corrisponde al modo in cui il server MCP o l'API protegge i suoi endpoint:

Schema di autenticazione Plug-in MCP Plug-in API Articolo
Single Sign-On (SSO) di Microsoft Entra Supportata Supportata Configurare l'autenticazione SSO di Microsoft Entra
Registrazione client dinamico (DCR) Supportata Non supportato Configurare la registrazione client dinamica
Flusso del codice di autorizzazione OAuth 2.0 Supportata Supportata Configurare l'autenticazione OAuth 2.0
Chiave API Non supportato Supportata Configurare l'autenticazione con chiave API
Nessuna autenticazione (anonima) Supportata Supportata Nessuna autenticazione (anonima)

Nota

Questa tabella illustra i plug-in MCP e API usati come azioni dell'agente dichiarativo. Un plug-in che fa riferimento a un server MCP remoto nel agentConnectors manifesto dell'app Microsoft 365 usa una configurazione di autorizzazione diversa. Tale schema include ApiKeyPluginVault, mentre i plug-in MCP utilizzati come azioni dell'agente dichiarativo non supportano le chiavi API. Per i requisiti di configurazione e host, vedere Configurare server MCP remoti per i plug-in di Microsoft 365 Copilot.

Funzionamento dell'autenticazione tramite plug-in

Per gli schemi che richiedono le credenziali, una configurazione di autenticazione (auth config) è un record archiviato nell'archivio token di Microsoft Enterprise che contiene le credenziali o i dettagli del client necessari per l'autenticazione nel server o nell'API MCP. L'accesso anonimo non richiede una configurazione di autenticazione. Scegliere il percorso di configurazione supportato per il progetto:

  • Work IQ Dev Tools (scelta consigliata) configura l'autenticazione quando si aggiunge un'azione OpenAPI o MCP remoto con wiqd agent add action. Per configurare un tipo di autenticazione supportato in un manifesto di plug-in esistente, utilizzate wiqd agent add auth. Seguire le indicazioni WIQD specifiche dello schema riportate di seguito per le opzioni corrette, quindi completare il flusso di lavoro di provisioning dell'agente per l'ambiente.
  • Microsoft 365 Agents Toolkit crea la configurazione di autenticazione e aggiorna automaticamente il manifesto del plug-in durante la compilazione dell'agente.
  • La competenza per lo sviluppatore dell'agente dichiarativo (solo plug-in MCP) crea la configurazione di autenticazione e aggiorna automaticamente il manifesto dalle istruzioni in linguaggio naturale.
  • Il portale per sviluppatori di Microsoft Teams consente di creare manualmente la configurazione di autenticazione o di gestirne una creata da Agents Toolkit o dalla competenza.

Per gli schemi autenticati, il manifesto del plug-in fa riferimento alla configurazione di autenticazione in base al suo ID nell'oggetto di autenticazione di runtime. In fase di esecuzione, Microsoft 365 Copilot usa la configurazione di autenticazione per ottenere un token o una chiave API dall'archivio token e la include quando il plug-in chiama il server MCP o l'API.

Iniziare con la sezione WIQD per lo schema di autenticazione scelto. Gli stessi articoli contengono Toolkit, developer-skill, portale e alternative manuali, dove supportate.

Nota

Per un pacchetto di plug-in che connette Cowork a un server MCP remoto, seguire l'autenticazione nel manifesto dell'app. I passaggi condivisi per la registrazione delle credenziali non rendono tale configurazione intercambiabile con la configurazione del manifesto del plug-in MCP di un agente. Se il provider OAuth utilizza Microsoft Identity Platform e la connessione richiede l'aggiornamento automatico del token, includerlo offline_access nel campo Ambito della configurazione OAuth con qualsiasi ambito delegato specifico dell'API.