Nota
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare ad accedere o modificare le directory.
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare a modificare le directory.
Utilizzare la decisione del server MCP dal piano del componente per fornire strumenti o risorse ospitati in remoto. Il server MCP in esecuzione rimane separato dal pacchetto di plug-in, pertanto è necessario implementare o confermare sia il runtime remoto che la connessione supportata all'esperienza Microsoft di destinazione.
Riutilizzare un server MCP
Prima di creare un server:
- Identificare un server MCP approvato che espone gli strumenti o le risorse necessarie.
- Esamina le definizioni degli strumenti, gli input, gli output, gli errori, le annotazioni e il comportamento di conferma.
- Verificare che il trasporto, il modello di autenticazione e le funzionalità di protocollo siano supportate dall'esperienza Microsoft di destinazione.
- Conferma il proprietario del server, l'endpoint, la versione, la disponibilità, la gestione dei dati, il supporto e il processo di modifica.
- Ottenere l'accesso e configurare la connessione di sviluppo o di test.
- Testare scenari rappresentativi di individuazione, autenticazione, chiamata e errore.
Il riferimento a un server MCP non trasferisce la responsabilità per il suo funzionamento. Annotare il proprietario del servizio e il contratto di supporto prima di riutilizzarlo.
Creare e gestire un server MCP
Creare un nuovo server MCP quando nessun server approvato soddisfa i requisiti.
- Implementare solo gli strumenti e le risorse richiesti dal piano dei componenti.
- Definisci in modo chiaro nomi, descrizioni, ingressi, output, errori e annotazioni di sicurezza.
- Implementare l'autenticazione, l'autorizzazione, l'accesso ai dati e il comportamento con privilegi minimi.
- Configurare hosting, rete, segreti, registrazione, monitoraggio, scalabilità e risposta agli incidenti.
- Versione del comportamento del protocollo e aspettative di compatibilità dei documenti.
- Testare il server in modo indipendente prima di connetterlo a un'esperienza Microsoft.
GitHub Copilot può essere utile per il codice del server, gli schemi, i test e le modifiche al repository. Non fornisce da solo il runtime MCP, l'hosting, l'autenticazione o la connessione Microsoft 365.
Connettere il server
Usa l'integrazione supportata dallo strumento di sviluppo selezionato e dall'esperienza di destinazione.
Nota
Utilizzare WIQD per creare un plug-in che fa riferimento a un server MCP remoto. Per la configurazione manuale tramite la agentConnectors matrice nel manifesto dell'app Microsoft 365, vedere Configurare server MCP remoti per i plug-in di Microsoft 365 Copilot. Questa configurazione è diversa dal manifesto del plug-in MCP usato per le azioni dell'agente dichiarativo. Il supporto dipende dall'esperienza di destinazione.
| Approccio allo sviluppo | Inizia con |
|---|---|
| Strumenti di sviluppo Work IQ (consigliati per scenari pro-code supportati) | Crea un plug-in con Work IQ Dev Tools; per un'azione dell'agente, utilizzare il flusso di lavoro dell'azione dell'agente WIQD |
| Progetto agente dichiarativo esistente che utilizza Agents Toolkit | Procedura dettagliata per l'integrazione MCP basata su toolkit |
| Copilot Studio | Documentazione di Microsoft Copilot Studio |
| Risposta MCP interattiva | Aggiungere app MCP agli agenti dichiarativi |
| Registrazione del server MCP remoto BYO con l'interfaccia a riga di comando di Agent 365 | Registrare un server MCP remoto in Strumenti agente |
Importante
La route Agent 365 CLI BYO MCP è in anteprima e usa un modello di registrazione e amministrazione separato da un plug-in MCP creato in pacchetto per un agente dichiarativo di Microsoft 365. I client supportati documentati sono Copilot Studio, Visual Studio Code, Claude Code e GitHub Copilot CLI. Gli agenti dichiarativi di Microsoft 365 non sono supportati da questa route. Gli amministratori usano gli strumenti agente per rivedere, approvare, acconsentire, bloccare e monitorare il server registrato.
Strumenti di sviluppo di Work IQ
Il wiqd plugin add connector comando aggiunge un connettore MCP remoto a un pacchetto di plug-in WIQD. I requisiti server documentati includono:
- HTTPS con TLS 1.2 o versione successiva.
- Trasporto HTTP streamable con JSON-RPC 2.0.
- Supporto per
tools/listetools/call. - Lo strumento chiama il completamento in meno di 30 secondi.
Scaffolding WIQD contro manifesto versione 1.29, dove mcpToolDescription è facoltativo. Se si include un file di descrizione dello strumento, passare il relativo percorso relativo a con wiqd plugin add connector --tool-description <relative-file-path> insieme alle appPackage opzioni di connettore richieste. Il file di riferimento deve essere incluso nel file ZIP. Per conoscere il comportamento di individuazione di Cowork corrente e i requisiti del pacchetto, consulta Creare plug-in per Copilot Cowork.
Per l'autenticazione con chiave OAuth o API, registrare prima le credenziali e aggiungere al pacchetto solo l'identificatore di riferimento. Non inserire segreti client, chiavi API o token nel manifesto. Vedi la guida di riferimento per la creazione di plug-in WIQD.
Per la route del pacchetto plug-in WIQD, configurare l'autenticazione e l'individuazione degli strumenti nel manifesto dell'app Microsoft 365. Se invece si aggiunge il server come azione MCP a un agente dichiarativo, utilizzare l'autenticazione dell'azione dell'agente e l'individuazione dinamica o gli strumenti aggiunti per l'agente. Seguire i requisiti dell'integrazione selezionata anziché copiare la configurazione tra i modelli manifesto.
Verificare che la funzionalità MCP funzioni
Il server MCP e la relativa connessione sono pronti per l'integrazione quando:
- L'endpoint è disponibile nell'ambiente di sviluppo o di test.
- Gli strumenti o le risorse necessari possono essere individuati dall'esperienza di destinazione.
- Le operazioni rappresentative restituiscono i risultati strutturati attesi.
- L'autenticazione, l'autorizzazione, il consenso e le autorizzazioni funzionano come previsto.
- Il comportamento di conferma, timeout, servizio non disponibile, input non valido e errore parziale è comprensibile.
- I log e il monitoraggio forniscono informazioni sufficienti per diagnosticare gli errori.
- Vengono registrati il proprietario del server, la versione, l'endpoint, l'hosting, le dipendenze, le limitazioni e le prove di test.
Usa il debug MCP e API locale quando il server non è raggiungibile pubblicamente durante lo sviluppo.
Continua con qualsiasi altro componente del piano. Una volta completati, integra e testa i tuoi componenti.