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服务器认证,您必须是经过认证的发布者。 您的组织必须:
- 具有已完成的业务验证的 Microsoft 合作伙伴中心 帐户。
- 注册Microsoft 365和Copilot项目。
- 拥有或控制你提交的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 密钥保管库 的认证,请按照以下步骤操作:
在你的 Azure 租户中使用 Azure 门户创建 Azure 密钥保管库。
将以下秘密存放在密钥保管库中:
必备秘密:
ClientIdClientSecretTokenUrl
可选秘密(取决于身份提供者配置):
-
AuthorizationUrl(OAuth2 身份提供程序所必需) RefreshUrlScopes-
AzureActiveDirectoryResourceId(AAD IdentityProvider 必需)
为 Microsoft 应用创建一个服务主体:
8e91e74f-afe9-41cd-8c3f-17a9562a74ea将该服务主体密钥保管库秘密用户(或等效的RBAC读访问权)授予Azure 密钥保管库,使认证服务在验证时能够检索到秘密。
将 密钥保管库 的 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/" }打包并提交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. 机密名称区分大小写,必须完全一致:
ClientIdClientSecretAuthorizationUrlTokenUrlRefreshUrlScopesAzureActiveDirectoryResourceId
authorization.referenceId 应该使用什么值?
对 authorization.referenceId 使用 密钥保管库 URI(而非机密 URI)。