Creare o riutilizzare i server MCP

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:

  1. Identificare un server MCP approvato che espone gli strumenti o le risorse necessarie.
  2. Esamina le definizioni degli strumenti, gli input, gli output, gli errori, le annotazioni e il comportamento di conferma.
  3. Verificare che il trasporto, il modello di autenticazione e le funzionalità di protocollo siano supportate dall'esperienza Microsoft di destinazione.
  4. Conferma il proprietario del server, l'endpoint, la versione, la disponibilità, la gestione dei dati, il supporto e il processo di modifica.
  5. Ottenere l'accesso e configurare la connessione di sviluppo o di test.
  6. 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.

  1. Implementare solo gli strumenti e le risorse richiesti dal piano dei componenti.
  2. Definisci in modo chiaro nomi, descrizioni, ingressi, output, errori e annotazioni di sicurezza.
  3. Implementare l'autenticazione, l'autorizzazione, l'accesso ai dati e il comportamento con privilegi minimi.
  4. Configurare hosting, rete, segreti, registrazione, monitoraggio, scalabilità e risposta agli incidenti.
  5. Versione del comportamento del protocollo e aspettative di compatibilità dei documenti.
  6. 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/list e tools/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.