在代理中为 MCP 和 API 插件配置身份验证

提示

受到推崇的: 从 Work IQ 开发工具 开始,用于受支持的专业代码声明代理和插件方案。 请参阅 WIQD 快速入门。 基于工具包的说明仍然可用于需要它们的现有项目和工作流。 在选择工具之前,请检查 功能和目标体验支持 : WIQD 不面向自定义引擎代理。

智能 智能 Microsoft 365 Copilot 副驾驶® 副驾驶®中的声明性代理通过 API 或 MCP 插件连接到后端服务。 这些操作集成将代理连接到模型上下文协议 (MCP) 服务器或 OpenAPI 文档描述的 API。 配置身份验证,以便智能 智能 Microsoft 365 Copilot 副驾驶® 副驾驶®可以代表登录用户获取并发送正确的凭据。

注意

本文在 API 或 MCP 插件清单中为声明式代理配置身份验证。 它不配置外部可安装包。 请参阅清单关系的 插件和声明式代理操作 。

身份验证演练使用 MCP 插件作为默认示例。 MCP 插件是代理与远程服务器的集成,而不是服务器本身。 相同的配置步骤适用于从 OpenAPI 文档生成的 API 插件,除非每篇文章另有说明。

支持的身份验证方案

选择与 MCP 服务器或 API 保护其终结点的方式相匹配的身份验证方案:

身份验证方案 MCP 插件 API 插件 文章
Microsoft Entra单一登录 (SSO) 支持 支持 配置 Microsoft Entra SSO 身份验证
动态客户端注册 (DCR) 支持 不支持 配置动态客户端注册
OAuth 2.0 授权代码流 支持 支持 配置 OAuth 2.0 身份验证
API 密钥 不支持 支持 配置 API 密钥身份验证
匿名) (不进行身份验证 支持 支持 不配置匿名) (身份验证

注意

下表介绍了用作声明性代理操作的 MCP 和 API 插件。 通过 agentConnectors Microsoft 365 应用清单中引用远程 MCP 服务器的插件使用不同的授权配置。 该架构包括 ApiKeyPluginVault,而用作声明性代理操作的 MCP 插件不支持 API 密钥。 有关配置和主机要求,请参阅为 智能 智能 Microsoft 365 Copilot 副驾驶® 副驾驶® 插件配置远程 MCP 服务器。

插件身份验证的工作原理

对于需要凭据的方案, 身份验证配置 (身份验证配置) 是存储在 Microsoft Enterprise 令牌存储中的记录,用于保存向 MCP 服务器或 API 进行身份验证所需的凭据或客户端详细信息。 匿名访问不需要身份验证配置。为项目选择支持的配置路径:

  • 建议使用 Work IQ Dev Tools () 在添加 OpenAPI 或远程 MCP 操作时 wiqd agent add action配置身份验证。 若要在现有插件清单中配置受支持的身份验证类型,请使用 wiqd agent add auth. 请按照下面特定于方案的 WIQD 指南获取正确的选项,然后为你的环境完成代理的预配工作流。
  • Microsoft 365 Agents Toolkit 会创建身份验证配置,并在生成代理时自动更新插件清单。
  • 声明式代理开发人员技能仅 (MCP 插件) 根据自然语言说明创建身份验证配置并更新清单。
  • Microsoft Teams 开发人员门户 允许您手动创建身份验证配置,或管理 Agents Toolkit 或技能创建的身份验证配置。

对于经过身份验证的方案,插件清单通过 其在运行时身份验证对象中的 ID 引用身份验证配置。 在运行时,智能 智能 Microsoft 365 Copilot 副驾驶® 副驾驶® 使用身份验证配置从令牌存储获取令牌或 API 密钥,并在插件调用 MCP 服务器或 API 时包含它。

从所选身份验证方案的 WIQD 部分开始。 相同的文章保留工具包、开发人员技能、门户和手动替代方案(如果支持)。

注意

对于将 Cowork 连接到远程 MCP 服务器的插件包,请按照应用清单中的身份验证进行操作。 共享凭据注册步骤不会使该配置可与代理的 MCP 插件清单配置互换。 如果 OAuth 提供程序使用 Microsoft 标识平台,并且连接需要自动令牌刷新,请在 OAuth 配置的“范围”字段中包含offline_access任何特定于 API 的委派范围。