Panoramica della certificazione Microsoft MCP server (anteprima)

Note

Le funzionalità in questo articolo sono alimentate dallo standard harness, che utilizza le opzioni di fatturazione descritte in Licensing per gli agenti alimentati dallo standard harness. Impara come accedere alle funzionalità standard negli agenti standard Access e nei flussi degli agenti.

Importante

Questo articolo contiene la documentazione sull'anteprima di Microsoft Copilot Studio ed è pertanto soggetto a modifiche.

Le funzionalità di anteprima non sono destinate all'uso in produzione e possono avere funzionalità limitate. Queste funzionalità sono disponibili prima di una versione ufficiale in modo che sia possibile ottenere l'accesso iniziale e inviare commenti.

Se stai creando un agente destinato alla produzione, vedi Panoramica di Microsoft Copilot Studio.

I server Model Context Protocol (MCP) sono servizi che forniscono strumenti e azioni che gli agenti possono utilizzare attraverso Microsoft 365 Copilot e altre esperienze basate sull'IA. La certificazione dà a clienti e amministratori la fiducia che un servizio esterno soddisfi le aspettative Microsoft in termini di affidabilità, sicurezza, conformità e gestione responsabile prima ancora di essere ampiamente disponibile. I server MCP certificati forniscono indicazioni chiare per la configurazione, un'esecuzione affidabile degli strumenti, un'autenticazione appropriata e documentazione che aiuta produttori e amministratori a capire come utilizzare il server in modo sicuro.

Questo processo aggiornato mantiene intatti i fondamenti della certificazione: gli editori verificati inviano un pacchetto MCP, Microsoft valida il pacchetto e il comportamento in runtime, risolve i problemi prima dell'approvazione e gli editori rimangono responsabili di mantenere l'esperienza certificata dopo la pubblicazione.

Importante

In futuro, utilizza il tipo di offerta Partner Center Apps and Agents per M365 e Copilot per le sottomissioni di certificazione Microsoft MCP server. Non è necessario riinviare i server MCP certificati tramite il processo precedente solo a causa di questo cambiamento. Se sarà necessario, Microsoft si farà avanti. Microsoft trasferirà gli MCP certificati esistenti al nuovo percorso di processo. Se hai difficoltà, puoi usare il vecchio percorso fino alla fine di luglio 2026. Per ulteriori informazioni, consulta la certificazione Microsoft MCP server - Microsoft Copilot Studio.

Server MCP certificati

Ogni server MCP certificato fornisce contenuto di riferimento per supportare la configurazione degli strumenti e delle azioni che si integrano con Microsoft 365 Copilot e altre esperienze di intelligenza artificiale. Per vedere l'elenco filtrato dei server MCP certificati attuali, vai su Elenco dei server MCP di tutti i server MCP.

Prerequisiti

Prima di sottoporre un server MCP per la certificazione, assicurati che la tua organizzazione e il pacchetto rispettino requisiti di idoneità di base, aspetti tecnici e di conformità:

  • Idoneità Publisher: Devi essere un publisher verificato e possedere o controllare l'endpoint server MCP che invii.
  • Prontezza dell'autenticazione: Supportare un metodo di autenticazione approvato e fornire dettagli di configurazione per la validazione.
  • Completezza del pacchetto: Includere il pacchetto MCP, i metadati, la documentazione pubblica, le icone, i link per supporto, privacy e termini.
  • Prontezza al test: Testare gli strumenti MCP prima della presentazione e includere prove di valutazione quando disponibili.

Idoneità dell'editore

Per sottoporre server MCP alla certificazione, devi essere un editore verificato. La tua organizzazione deve:

  • Avere un account Microsoft Partner Center con la verifica aziendale completata.
  • Iscriversi al programma Microsoft 365 e Copilot.
  • Possiedi o controlla l'endpoint server MCP che stai inviando.

Se sei un editore indipendente che non possiede il servizio sottostante, non sei idoneo a inviare direttamente il servizio. Devi collaborare con il proprietario del servizio o completare la verifica prima di proseguire la certificazione.

Cosa cambia

Il processo di certificazione aggiornato introduce modifiche ai percorsi di invio, ai requisiti del pacchetto e alle superfici di pubblicazione.

Area Linee guida aggiornate
Tipo di offerta nel Partner Center Usa Apps e Agenti per M365 e Copilot per le nuove presentazioni di certificazioni MCP.
Pacchetto Tutte le invii MCP ora richiedono un file manifest, un file tool, intro.md un file e una configurazione di autenticazione Azure Key Vault.
MCP certificati esistenti Gli MCP certificati tramite il processo precedente non devono agire solo a causa del cambiamento di processo; Microsoft li fa passare a questa nuova strada.
Superfici editoriali Si prevede che server MCP certificati siano disponibili in Azure Foundry oltre a Copilot Studio, con superfici più ampie per la scoperta e la governance del centro Amministrazione Microsoft 365, a seconda delle applicazioni.
Definizioni di pacchetti Includi un link alle guide per il pacchetto e le icone Microsoft in modo che gli editori seguano i requisiti corretti di dimensioni, branding, aree di sicurezza, contrasto e immagine. Vedi Preparare la presentazione del negozio Teams.

Processo di certificazione

Il percorso di alto livello è semplice: preparare il pacchetto, inviarlo nel Partner Center, superare la validazione e la revisione, poi pubblicare e mantenere il server MCP certificato.

Step Stage Che succede
1 Preparare il pacchetto Assembla il pacchetto server MCP, includendo il manifesto, le definizioni degli strumenti, i dettagli di autenticazione, i metadati richiesti, la documentazione pubblica, le icone e eventuali artefatti di supporto.
2 Invia tramite Partner Center Crea una nuova offerta utilizzando le app e gli agenti per M365 e il tipo di offerta Copilot. Carica il pacchetto e fornisci le informazioni commerciali, legali, di supporto e dell'editore richieste.
3 Convalida automatizzata Microsoft valida la struttura del pacchetto, i campi richiesti, la correttezza dello schema, la completezza dei metadati e la prontezza delle policy di base. Devi risolvere i problemi di blocco prima che la revisione possa continuare.
4 Revisione funzionale e di sicurezza Microsoft esamina il server MCP per funzionalità, comportamento degli endpoint, autenticazione, sicurezza, conformità, prontezza telemetrica e considerazioni responsabili sull'IA. La prova di valutazione può aiutare ad accelerare la revisione.
5 Approvazione e pubblicazione Dopo l'approvazione, il server MCP certificato viene pubblicato sulle superfici supportate per la discovery e l'esecuzione di Microsoft. Si prevede che gli MCP certificati siano individuabili in Copilot Studio e Azure Foundry, con il supporto della governance amministrativa Microsoft 365 se applicabile.
6 Manutenzione e aggiornamento Mantieni l'implementazione allineata con il pacchetto certificato. Riinvia aggiornamenti quando introduci nuovi strumenti, cambiamenti significativi ai metadati o modifiche ai pacchetti che influenzano l'esperienza certificata.

Definizioni di confezioni e branding

Per asset di pacchetti come dimensioni delle icone, regole dell'area sicura, branding e contrasto, usa le linee guida per i pacchetti di Microsoft 365 / Teams come riferimento per la prontezza alla presentazione. Vedi Preparare la presentazione del negozio Teams.

Area del pacchetto. Indicazioni pubbliche includendo
File di manifesti e definizioni di strumenti Descrivi il server MCP, gli strumenti, i prompt/risorse se applicabili, la configurazione degli endpoint e gli schemi degli strumenti.
Autenticazione e configurazione dei test Includere dettagli di autenticazione supportati, credenziali di test o istruzioni di configurazione, e qualsiasi configurazione di ambiente necessaria per la validazione.
Metadati e documentazione pubblica Fornisci nome di visualizzazione, descrizioni brevi e lunghe, categorie, informazioni sull'editore, link di supporto, link per privacy/termini e documentazione introduttiva.
Branding e asset dell'app Usa le indicazioni necessarie per icone e immagini di Microsoft 365/Teams per icone colore, icone di contorno/predefinite, dimensioni, aree sicure, contrasto e branding. Vedi Preparare la presentazione del negozio Teams.
Prove di valutazione, se disponibili Includere prove rappresentative di test funzionali e di sicurezza. Queste evidenze sono utili per validare il comportamento atteso e la revisione dell'accelerazione, specialmente per azioni a rischio elevato o comportamenti guidati dall'IA.

Importante

Microsoft supporta solo nomi e valori di intestazione American Standard Code for Information Interchange (ASCII) nei file di manifesti e definizioni degli strumenti. I caratteri non ASCII potrebbero causare fallimenti di validazione.

File di manifesto

Il file manifest è un file JSON che contiene la definizione del server MCP, le definizioni degli strumenti, la configurazione dell'autenticazione, i metadati, la documentazione pubblica e qualsiasi artefatto di supporto. Il file deve seguire la struttura richiesta e includere tutte le informazioni necessarie affinché Microsoft possa validare il server MCP durante la certificazione. Ecco un esempio di struttura del file manifest:

{
  "$schema": "https://developer.microsoft.com/en-us/json-schemas/teams/vDevPreview/MicrosoftTeams.schema.json",
  "manifestVersion": "devPreview",
  "version": "1.0.0",
  "id": "<APP_ID>",
  "developer": {
    "name": "<COMPANY_NAME>",
    "websiteUrl": "<COMPANY_WEBSITE_URL>",
    "privacyUrl": "<PRIVACY_POLICY_URL>",
    "termsOfUseUrl": "<TERMS_OF_USE_URL>"
  },
  "name": {
    "short": "<MCP_SHORT_NAME>",
    "full": "<MCP_FULL_NAME>"
  },
  "description": {
    "short": "<SHORT_DESCRIPTION>",
    "full": "<LONG_DESCRIPTION>"
  },
  "agentConnectors": [
    {
      "id": "<CONNECTOR_ID>",
      "displayName": "<CONNECTOR_DISPLAY_NAME>",
      "description": "<CONNECTOR_DESCRIPTION>",
      "toolSource": {
        "remoteMcpServer": {
          "mcpServerUrl": "<MCP_SERVER_URL>",
          "mcpToolDescription": {
            "file": "mcptools.json"
          },
          "authorization": {
            "type": "AzureKeyVault",
            "referenceId": "<KEYVAULT_URI>"
          }
        }
      }
    }
  ],
  "icons": {
    "outline": "Outline.png",
    "color": "Color.png"
  },
  "accentColor": "<HEX_COLOR>"
}

File introduttivo

Crea un intro.md (o Readme.md) file per documentare le funzionalità e le caratteristiche del tuo server MCP. Per vedere esempi di intro.md file, vai su Readme.md. Puoi anche consultare altri intro.md file nel repository GitHub di Power Platform Connectors.

Tip

Includi una sezione Problemi noti e limitazioni nel tuo file intro.md per tenere informati gli utenti e aiutarli a evitare problemi comuni. Ad esempio, se il tuo server MCP ha un problema noto con uno strumento o un'azione specifica, documentalo in questa sezione insieme a eventuali soluzioni alternative.

Pubblicazione e disponibilità

Dopo l'approvazione della certificazione, il server MCP viene pubblicato sulle superfici di discovery e runtime supportate da Microsoft. MCP certificati sono disponibili in Azure Foundry oltre a Copilot Studio. Quando applicabile, i MCP certificati dovrebbero anche allinearsi alle esperienze di governance amministrativa e discovery di Microsoft 365 utilizzate per abilitare, distribuire o gestire agenti e strumenti per un'organizzazione.

Responsabilità post-certificazione

Dopo la certificazione, gli editori sono responsabili di mantenere l'esperienza certificata:

  • Mantieni l'implementazione MCP allineata con il pacchetto certificato e la documentazione pubblica.
  • Mantenere un supporto accurato, la privacy, i termini e i link ai metadati.
  • Monitorare la salute del servizio, la telemetria e la qualità del runtime affinché l'esperienza certificata rimanga affidabile.
  • Riinvia aggiornamenti dei pacchetti quando aggiungi strumenti, modifichi metadati certificati o apporti cambiamenti significativi al comportamento.

Domande frequenti

Come posso configurare il Key Vault?

Per configurare l'autenticazione con Azure Key Vault, segui questi passaggi:

  1. Crea un Azure Key Vault nel tuo tenant Azure usando il portale Azure.

  2. Conserva i seguenti segreti nel Key Vault:

    Segreti obbligatori:

    • ClientId
    • ClientSecret
    • TokenUrl

    Segreti opzionali (a seconda della configurazione del Fornitore di Identità):

    • AuthorizationUrl (richiesto per OAuth2 IdentityProvider)
    • RefreshUrl
    • Scopes
    • AzureActiveDirectoryResourceId (richiesto per AAD IdentityProvider)

  3. Crea un principio di servizio per l'applicazione Microsoft:

    8e91e74f-afe9-41cd-8c3f-17a9562a74ea

    Concedere a questo principale di servizio Key Vault Secrets User (o equivalente accesso di lettura RBAC) a Azure Key Vault affinché il servizio di certificazione possa recuperare i segreti durante la validazione.

  4. Aggiungi l'URI di Key Vault al manifesto MCP:

    "authorization": {
  "type": "AzureKeyVault",
  "referenceId": "https://<your-keyvault>.vault.azure.net/"
}

    Deve authorization.referenceId essere l'Azure Key Vault URI.

    Esempio:

    "authorization": {
  "type": "AzureKeyVault",
  "referenceId": "https://contoso-mcp-kv.vault.azure.net/"
}

  5. Compila e invia il pacchetto di certificazione MCP.

Durante la validazione della certificazione, il servizio recupera in modo sicuro la configurazione OAuth dall'Azure Key Vault riferito.

Quali sono i requisiti del fornitore di identità?

La tabella seguente elenca i segreti Key Vault richiesti per ogni tipo di fornitore di identità:

Fornitore di identità Segreti richiesti di AzureKey Vault
OAuth2 ClientId, ClientSecret, AuthorizationUrlTokenUrl
OAuth2 + Token di aggiornamento ClientId, ClientSecret, AuthorizationUrl, TokenUrl, RefreshUrl
OAuth2 con Scopi Aggiungere Scopes
Azure AD ClientId, ClientSecret, TokenUrlAzureActiveDirectoryResourceId

I nomi segreti sono distinti dalla maiuscula?

Yes. I nomi segreti sono sensibili alla maiuscola e dovrebbero corrispondere esattamente:

  • ClientId
  • ClientSecret
  • AuthorizationUrl
  • TokenUrl
  • RefreshUrl
  • Scopes
  • AzureActiveDirectoryResourceId

Quale valore dovrei usare per authorization.referenceId?

Usa l'URI di Key Vault (non un URI segreto) per authorization.referenceId.

Contenuti correlati

  • Last updated on