Panoramica della certificazione server Microsoft MCP (anteprima)

I server Model Context Protocol (MCP) sono servizi che offrono strumenti e funzionalità che gli agenti possono usare in Microsoft 365 Copilot e altre esperienze alimentate dall'intelligenza artificiale. La certificazione offre a clienti e amministratori la certezza che un servizio esterno soddisfi i requisiti di Microsoft in termini di affidabilità, sicurezza, conformità e funzionamento responsabile prima di essere reso ampiamente disponibile. I server MCP certificati offrono chiare istruzioni di configurazione, un'esecuzione affidabile degli strumenti, un'autenticazione appropriata e una documentazione che aiuta i creatori e gli amministratori a comprendere come utilizzare il server in modo sicuro.

Questo processo aggiornato mantiene intatti i principi fondamentali della certificazione: gli editori verificati inviano un pacchetto MCP, Microsoft convalida il pacchetto e il comportamento in fase di esecuzione, risolve i problemi prima dell'approvazione e gli editori restano responsabili del mantenimento dell'esperienza certificata dopo la pubblicazione.

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 consultare la lista dei server MCP certificati correnti, vai all'Elenco di tutti i server MCP.

Prerequisites

Prima di inviare 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à dell'editore: devi essere un editore verificato e possedere o controllare l'endpoint server MCP che invii.
• Preparazione dell'autenticazione: supporta un metodo di autenticazione approvato e fornisci dettagli di configurazione per la convalida.
• Completezza del pacchetto: includi il pacchetto MCP, i metadati, la documentazione pubblica, le icone, i link per supporto, privacy e termini.
• Preparazione al test: testa gli strumenti MCP prima della presentazione e includi prove di valutazione quando disponibili.

Idoneità dell'editore

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

• Avere un account Microsoft Partner Center con la verifica aziendale completata.
• Essere iscritta 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.

Processo di certificazione

Il percorso di alto livello è semplice: prepara il pacchetto, invialo nel Centro per i partner, supera la convalida e la revisione, poi pubblica e mantieni il server MCP certificato.

Definizioni e personalizzazione del pacchetto

Per asset di pacchetti come dimensioni delle icone, regole di area sicura, personalizzazione e contrasto, usa le linee guida per i pacchetti di Microsoft 365 / Teams come riferimento per la preparazione all'invio. Vedi Preparare l'invio a Teams Store.

File di manifesto

Il file manifesto è 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 convalidare il server MCP durante la certificazione. Di seguito è riportata la struttura del file manifesto:

{
  "$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>"
    "contactInfo": {
      "defaultSupport": {
        "userEmailsForChatSupport": [
          "ISV_EmailAddress1",
          "ISV_EmailAddress2"
        ],
        "emailsForEmailSupport": [  
          "<SUPPORT_Email_Address>"
        ]
      }
    }  
  },
  "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 di introduzione

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

Pubblicazione e disponibilità

Dopo l'approvazione della certificazione, il server MCP viene pubblicato sulle superfici di individuazione e runtime supportate da Microsoft. I MCP certificati sono disponibili in Azure Foundry oltre a Copilot Studio. Quando applicabile, gli MCP certificati devono anche allinearsi alle esperienze di governance amministrativa e individuazione 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.
• Mantieni un supporto accurato, la privacy, i termini e i link ai metadati.
• Monitora l'integrità del servizio, la telemetria e la qualità del runtime affinché l'esperienza certificata rimanga affidabile.
• Invia nuovamente gli aggiornamenti del pacchetto quando aggiungi strumenti, modifichi i metadati certificati o apporti modifiche significative al comportamento.

FAQ

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 di Azure utilizzando il portale di Azure.

2. Conserva i seguenti segreti nel Key Vault:

   Segreti obbligatori:

   • ClientId
   • ClientSecret
   • TokenUrl

   Segreti opzionali (a seconda della configurazione del provider di identità):

   • AuthorizationUrl (richiesto per il provider di identità OAuth2)
   • RefreshUrl
   • Scopes
   • AzureActiveDirectoryResourceId (richiesto per AAD IdentityProvider)

3. Crea un'entità servizio per l'applicazione Microsoft:

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

   Assegna a questa entità servizio il ruolo Key Vault Secrets User (o un'autorizzazione di lettura RBAC equivalente) per Azure Key Vault, in modo che il servizio di certificazione possa recuperare i segreti durante la convalida.

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

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

   authorization.referenceId deve essere l'URI di Azure Key Vault.

   Esempio:

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

5. Compila e invia il pacchetto di certificazione MCP.

Durante la convalida della certificazione, il servizio recupera in modo sicuro la configurazione OAuth dall'Azure Key Vault di riferimento.

Quali sono i requisiti del provider di identità?

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

I nomi dei segreti sono sensibili alle maiuscole e alle minuscole?

Sì. I nomi dei segreti distinguono tra maiuscole e minuscole e devono corrispondere esattamente:

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

Quale valore devo usare per authorization.referenceId?

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

Contenuti correlati

• Certificazione del server Microsoft MCP - Microsoft Copilot Studio
• Pubblicare agenti per Microsoft 365 Copilot
• Preparati per la pubblicazione nello Store di Teams
• Progetta l'icona dell'app per lo Store di Teams