Microsoft MCP 服务器认证(预览)

Note

本文介绍了由 标准线束驱动的代理或代理流中使用的功能。

Important

本文包含 Microsoft Copilot Studio 预览版文档,有可能会有变动。

预览功能不适合生产使用且功能可能受限。 这些功能在正式发布之前可用,以便你可以提前访问并提供 反馈。

如果您在构建可投入生产的代理,请参阅 Microsoft Copilot Studio 概述。

模型上下文协议(MCP)服务器是提供代理在支持的 Microsoft Copilot 及其他 AI 驱动体验中可以使用的工具和操作的服务。 认证让客户和管理员有信心,外部服务在广泛可用前,符合Microsoft对可靠性、安全性、合规性和负责任运营的期望。 认证的MCP服务器提供清晰的设置指导、可靠的工具执行、适当的认证以及帮助制作者和管理员安全使用服务器的文档。

这一更新流程保持了核心认证基础:

  • 经过认证的出版商需提交MCP包。
  • Microsoft会验证包和运行时的行为,并在批准前修复问题。
  • 出版商仍需负责在出版后保持认证体验。

Important

今后,请使用新的MCP 服务器认证受理表单提交 Microsoft MCP 服务器认证申请。

如果你已有认证的MCP服务器:

  • 如果你的MCP服务器已经通过之前的流程认证,你 无需 采取任何行动。
  • 现有认证MCP正在迁移到新的认证路径。
  • 如果你需要做什么,Microsoft会联系你。
  • 如果您已有带有 MCP 服务器的 Microsoft 365 代理,则无需单独提交。 这些MCP服务器将在今年晚些时候自动作为独立MCP服务器开放。

由于预览期间提交量较大,只能处理有限数量的提交内容。 如果你的提交被选中进入处理流程,Microsoft会联系你。 如果您有紧急发布时间要求或客户承诺,可以继续使用遗留认证流程,直至2026年11月18日。

认证的MCP服务器

每个认证的MCP服务器都提供参考内容,支持设置与Microsoft Copilot及其他AI体验集成的工具和操作。 要查看当前认证MCP服务器的筛选列表,请参见 所有MCP服务器列表。

Prerequisites

在提交MCP服务器认证前,确保您的组织和软件包符合基本资格、技术和合规要求:

  • Publisher 资格:您必须是经过验证的 publisher,并且拥有或控制您提交的 MCP 服务器端点。
  • 认证准备:支持批准的认证方法,并提供配置细节以供验证。
  • 包完整性:包含 MCP 包、元数据、公开文档、图标以及支持、隐私和术语链接。
  • 测试就绪性:请在提交前测试 MCP 工具,并在有相关评估证据时一并提供。

出版商资格

要提交MCP服务器认证,您必须是经过认证的发布者。 您的组织必须:

如果你是独立出版商,且不拥有底层服务,你就没有资格直接提交。 您必须与服务方合作或完成认证后才能获得认证。

发生变化的内容

更新后的认证流程对提交路径、包要求和发布表面进行了调整。

面积 更新后的指南
合作伙伴中心的优惠类型 对于新的 MCP 认证提交,请使用 适用于 M365 和 Copilot 的应用和代理。
包 所有MCP提交现在都需要清单文件、工具文件、intro.md文件和Azure 密钥保管库认证配置。
现有的已认证 MCP 通过之前流程认证的MCP不必仅仅因为流程变更而采取行动;Microsoft 将他们引导到新的路径上。
发布平台 认证的 MCP 服务器预计将可在 Microsoft Foundry 以及 Copilot Studio 中使用,并根据适用情况提供更广泛的 Microsoft 365 管理中心 发现和治理入口。
封装定义 附上Microsoft包和图标指南的链接,帮助出版商遵循正确的尺寸、品牌、安全区域、对比度和图像要求。 请参阅 准备提交到 Teams 应用商店。

认证过程

高层流程很简单:准备包,提交到合作伙伴中心,通过验证和审核,然后发布并维护认证的MCP服务器。

Step 阶段 会发生什么
1 准备您的包裹 组装MCP服务器包,包括清单、工具定义、认证细节、所需元数据、公开文档、图标及任何支持工件。
2 提交信息采集表和电子邮件 提交登记表。 Microsoft 将会联系你并提供进一步说明。
3 自动验证 Microsoft 验证包结构、必需字段、模式正确性、元数据完整性和基线策略准备性。 您必须先解决阻塞问题,审核才能继续进行。
4 功能与安全审查 Microsoft会审查MCP服务器的功能性、端点行为、认证、安全性、合规性、遥测准备度以及负责任的AI考虑因素。 评估证明有助于加快审查进程。
5 批准与出版 获得批准后,经认证的 MCP 服务器会发布到 Microsoft 支持的发现和运行时界面。 预计认证的 MCP 将在 Copilot Studio 和 Microsoft Foundry 中可被发现,并可根据情况提供 Microsoft 365 管理治理支持。
6 维护与更新 确保实现与认证包保持一致。 在引入新工具、重大元数据变更或影响认证体验的包变更时,重新提交更新。

包装定义与品牌

对于图标大小、安全区域规则、品牌呈现和对比度等包资源,请以 Microsoft 365 / Teams 包指南作为提交就绪性的参考依据。 请参阅 准备提交到 Teams 应用商店。

封装区域 面向公众的指导应包括
清单和工具定义文件 描述MCP服务器、工具、提示/资源(如适用)、端点配置和工具模式。
认证与测试配置 包括支持的认证详情、测试凭证或设置说明,以及验证所需的环境配置。
元数据与公开文档 提供显示名称、简短和长描述、分类、出版商信息、支持链接、隐私/条款链接以及介绍文档。
品牌与应用资产 请使用 Microsoft 365/Teams 规定的套件图标和图像指南,其中涵盖彩色图标、轮廓图标/默认图标、尺寸、安全区域、对比度和品牌规范。 请参阅 准备提交到 Teams 应用商店。
如有评估证据,请提供 包含具有代表性的功能和安全测试证据。 这些证据对于验证预期行为和加快审查非常有帮助,尤其是在高风险行为或AI驱动行为时。

Important

Microsoft 仅支持清单和工具定义文件中的美国信息交换标准代码 (ASCII) 标头名称和值。 非ASCII字符可能导致验证失败。

清单文件

清单文件是一个JSON文件,包含MCP服务器定义、工具定义、认证配置、元数据、公开文档及任何支持工件。 文件必须遵循所需的结构,并包含所有必要信息,以便 Microsoft 在认证过程中验证 MCP 服务器。 以下是清单文件的示例结构:

{
  "$schema": "https://developer.microsoft.com/json-schemas/teams/v1.30/MicrosoftTeams.schema.json",
  "version": "1.30",
  "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>"
}

介绍文件(可选)

创建一个 intro.md (或 Readme.md)文件来记录你的MCP服务器的功能和功能。 要查看文件示例 intro.md ,请访问 Readme.md。 你也可以查看Power Platform Connectors的GitHub仓库里的其他intro.md文件。

Tip

在您的 intro.md 文件中包含“已知问题和限制”部分 ,以便用户及时了解情况,帮助他们避免常见问题。 例如,如果你的MCP服务器存在某个特定工具或操作已知的问题,请在本节记录并提供任何变通方法。

出版与可获得性

认证批准后,Microsoft 将 MCP 服务器发布到受支持的发现和运行时界面(如 Copilot Studio)。 可用性因 Microsoft 的使用体验和身份验证方式而异。 在适用的情况下,认证的MCP还应与用于支持、部署或管理组织代理和工具的Microsoft 365管理员治理和发现经验保持一致。

发布并不完成客户组织中的设置。 管理员可能需要批准或允许MCP服务器,用户也可能需要登录服务。

认证后职责

认证后,出版商需负责维护认证体验:

  • 保持MCP实现与认证包和公开文档保持一致。
  • 保持准确的支持、隐私、条款和元数据链接。
  • 监控服务健康、遥测和运行质量,确保认证体验可靠。
  • 添加工具、更改认证元数据或进行重大行为更改时,请重新提交包更新。

FAQ

支持动态客户端注册(DCR)吗?

是的,DCR是受支持的。

Proof Key for Code Exchange(PKCE)是否被支持?

不,PKCE目前不被支持。

我该如何设置密钥保管库?

要设置与 Azure 密钥保管库 的认证,请按照以下步骤操作:

  1. 在你的 Azure 租户中使用 Azure 门户创建 Azure 密钥保管库。

  2. 将以下秘密存放在密钥保管库中:

    必备秘密:

    • ClientId
    • ClientSecret
    • TokenUrl

    可选秘密(取决于身份提供者配置):

    • AuthorizationUrl(OAuth2 身份提供程序所必需)
    • RefreshUrl
    • Scopes
    • AzureActiveDirectoryResourceId (AAD IdentityProvider 必需)
  3. 为 Microsoft 应用创建一个服务主体:

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

    将该服务主体密钥保管库秘密用户(或等效的RBAC读访问权)授予Azure 密钥保管库,使认证服务在验证时能够检索到秘密。

  4. 将 密钥保管库 的 URI 添加到 MCP 清单中:

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

    必须authorization.referenceId是 Azure 密钥保管库 的 URI。

    Example:

    "authorization": {
      "type": "AzureKeyVault",
      "referenceId": "https://contoso-mcp-kv.vault.azure.net/"
    }
    
  5. 打包并提交MCP认证包。

在认证验证过程中,服务会安全地从参考的 Azure 密钥保管库 获取 OAuth 配置。

身份提供者的要求是什么?

下表列出了每种身份提供者类型所需的 密钥保管库 秘密:

身份认证服务提供商 必需的 Azure Key Vault 机密
OAuth2 ClientId、ClientSecret、AuthorizationUrl、TokenUrl
OAuth2 + 刷新令牌 ClientId、ClientSecret、AuthorizationUrl、TokenUrl、RefreshUrl
带示波器的OAuth2 添加 Scopes
Azure AD ClientId、ClientSecret、TokenUrl、AzureActiveDirectoryResourceId

秘密名字是否区分大小写?

Yes. 机密名称区分大小写,必须完全一致:

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

authorization.referenceId 应该使用什么值?

对 authorization.referenceId 使用 密钥保管库 URI(而非机密 URI)。