将代理连接到现有的模型上下文协议（MCP）服务器

2025-10-25

如果已设置模型上下文协议（MCP）服务器，可以将 MCP 服务器连接到代理。

可通过两种方法将智能体连接到 Copilot Studio 中的 MCP 服务器：

使用 MCP 载入向导 在 Copilot Studio 中添加 MCP 服务器（建议）
通过 Power Apps 创建服务器的自定义连接器

如果尚未设置 MCP 服务器，请参阅 “创建新的 MCP 服务器 ”，了解如何开始作。

支持的传输

在 MCP 中，传输是客户端与服务器通信的基础。传输处理发送和接收消息的机制。目前，Copilot Studio 支持可流式传输传输类型。

注释

鉴于 SSE 传输已弃用，Copilot Studio 在 2025 年 8 月之后不再支持 SSE for MCP。

选项 1：使用 MCP 载入向导（建议）

最简单方法的是使用 MCP 加入向导直接在 Copilot Studio 中连接到现有 MCP 服务器。

此方法有两个部分：

配置基本 MCP 服务器详细信息
使用 MCP 服务器配置身份验证

配置基本服务器信息

转到代理的 “工具” 页。
选择 “添加工具”。
选择 “新建”工具。
选择 模型上下文协议。 MCP 入门向导出现。
填写必填字段服务器名称、服务器说明和服务器 URL。务必编写一个简短但清晰的说明，说明 MCP 服务器的作用。代理协调器使用此信息来确定是否在运行时调用您的服务器。
选择 MCP 服务器的身份验证类型（如果适用）。有三个选项：
- 没有
- API 密钥：配置 API 密钥身份验证
- OAuth 2.0：配置 OAuth 2.0 身份验证
如果选择“ 无”，请选择“ 创建”。此时会显示 “添加工具 ”对话框。跳到创建新连接并将 MCP 服务器添加到代理。

使用 MCP 服务器配置身份验证

如果服务器需要身份验证，有两个选项：

API 密钥：如果 MCP 服务器需要 API 密钥进行身份验证，选择此选项。仅当应用程序（代理）需要向服务器进行身份验证时，API 密钥是一个简单的选项。
OAuth 2.0：如果 MCP 服务器使用 OAuth 2.0 进行身份验证，选择此选项。 OAuth 2.0 允许单个用户使用服务器进行身份验证，并向应用程序（代理）授予权限，而无需共享其凭据。

如果选择使用身份验证，则需要配置身份验证详细信息。这些步骤取决于所选的身份验证类型。

配置 API 密钥身份验证

选择 API 密钥 作为身份验证类型。将显示更多字段以配置 API 密钥。
选择要使用的 API 密钥类型。可以使用两个选项：
- 标头：如果 MCP 服务器要求在请求标头中发送 API 密钥，请选择此选项。
- 查询：如果 MCP 服务器要求将 API 密钥作为 URL 中的查询参数发送，请选择此选项。
输入 API 密钥的相应标头或查询字符串。
选择创建。此时会显示 “添加工具 ”对话框。跳到创建新连接并将 MCP 服务器添加到代理。

配置 OAuth 2.0 身份验证

选择 OAuth 2.0 作为身份验证类型。
选择要使用的 OAuth 2.0 身份验证类型。有三个选项：
- 动态发现：如果 MCP 服务器支持具有发现机制的 OAuth 2.0 动态客户端注册（DCR），请选择此选项。客户端可以使用发现终结点自动发现必要的终结点，并将自身注册到标识提供者。
- 动态：如果 MCP 服务器支持动态 OAuth 2.0 DCR，但不支持动态发现机制，请选择此选项。客户端仍可向标识提供者注册自身，但需要手动提供所需的终结点。
- 手动：如果 MCP 服务器需要手动配置 OAuth 2.0 设置，请选择此选项。

动态发现

如果 MCP 服务器支持 OAuth 2.0 动态客户端注册（DCR）机制，则可以使用动态发现选项。如果受支持，使用发现的 DCR 是使用 Copilot Studio 中的 MCP 服务器配置 OAuth 2.0 身份验证的最简单方法。

MCP 载入向导的屏幕截图，其中选择了 OAuth 2.0 的动态发现

选择 “动态发现 ”作为 OAuth 2.0 身份验证类型。
选择 “创建 ”以添加服务器。客户端使用发现终结点自动查找所需的终结点，并将自身注册到标识提供者。
选择“下一步”继续操作。此时会显示 “添加工具 ”对话框。
继续创建新的连接，并将 MCP 服务器添加到代理。

动态

选择 “动态 ”作为 OAuth 2.0 身份验证类型。
填写必填字段：
- 授权 URL：可以访问客户端注册和授权终结点的标识提供者服务器的 URL。
- 令牌 URL 模板：代理将授权代码（或刷新令牌）交换到 访问令牌 和 刷新令牌的终结点。访问令牌允许代理代表用户使用 MCP 服务器。刷新令牌允许代理在以前的访问令牌过期时从刷新终结点获取新的访问权限和刷新令牌。
选择 “创建 ”以添加服务器。根据配置，可能会显示 回调 URL 。回调 URL 是在用户登录并授予代理权限后，标识提供者使用授权代码进行响应的位置。
如果看到回调 URL，请复制该 URL，并将其添加到您的应用程序中，以便在身份提供者中进行注册。
选择“下一步”继续操作。此时会显示 “添加工具 ”对话框。
继续创建新的连接，并将 MCP 服务器添加到代理。

Manual

选择 “手动 ”作为 OAuth 2.0 类型。将显示更多字段以配置 OAuth 2.0 设置。
填写必填字段：
- 客户端 ID：标识提供者在您注册应用时颁发的客户端标识符。客户端 ID 允许标识提供者知道正在发出请求的应用。
- 客户端密码：注册应用时由身份提供者发放的客户端密码。代理将客户端密码以及客户端 ID 一起发送，以证明代理有权请求 MCP 服务器的访问令牌。
- 授权 URL：代理将用户重定向到登录的标识提供者终结点，并向代理授予权限（代理聊天中显示的同意卡）。用户在此处进行身份验证，然后标识提供者使用授权代码在回调 URL 上响应代理。
- 令牌 URL 模板：代理在此端点交换授权代码（或刷新令牌）以获得 访问令牌 和 刷新令牌。访问令牌允许代理代表用户使用 MCP 服务器。刷新令牌允许代理在以前的访问令牌过期时从刷新终结点获取新的访问权限和刷新令牌。
- 刷新 URL：使用刷新令牌请求新的访问令牌的终结点（以便用户不必在令牌过期时再次登录）。
- 范围（可选）：应用请求的权限，作为空格分隔的列表。
选择 “创建 ”以添加服务器。此时会显示 回调 URL 。回调 URL 是在用户登录并授予代理权限后，标识提供者使用授权代码进行响应的位置。
复制回调 URL，添加到应用程序在身份提供者上的注册信息中。
选择“下一步”继续操作。此时会显示 “添加工具 ”对话框。
继续创建新的连接，并将 MCP 服务器添加到代理。

创建新的连接并将 MCP 服务器添加到代理

在 “添加工具 ”对话框中，选择“为 MCP 服务器 创建新连接 ”或使用现有连接。
选择 “添加到代理 ”以完成将 MCP 服务器添加到代理。

选项 2：在 Power Apps 中创建自定义 MCP 连接器

可以在 Power Apps 中手动创建自定义连接器，以配置与服务器的连接。

若要执行此过程，需要 MCP 服务器的架构文件。架构文件是一个 OpenAPI 规范 YAML 文件，描述 MCP 服务器的 API。

有关规范文件的外观的指导，请查看提供的一些 MCP 服务器架构示例。

转到代理的 “工具” 页。
选择 “添加工具”。
选择 “新建”工具。
选择 “自定义连接器”。您将进入 Power Apps 来创建新的自定义连接器。
选择新建自定义连接器。
选择导入 OpenAPI 文件。
导航至模式文件，选择导入以导入文件。
选择 “继续 ”以在 Power Apps 中完成设置。有关设置流程的更多信息，请参阅 Power Apps 文档的导入 OpenAPI 定义。

MCP 服务器架构示例

下面是使用虚构数据（采用 YAML 格式）的 MCP 服务器的示例 OpenAPI 架构文件。您需要填写自己的 MCP 服务器的详细信息。此示例使用可流式传输传输类型。

swagger: '2.0'
info:
  title: Contoso
  description: MCP Test Specification, YAML for streamable MCP support in Copilot Studio
  version: 1.0.0
host: contoso.com
basePath: /
schemes:
  - https
paths:
  /mcp:
    post:
      summary: Contoso Lead Management Server
      x-ms-agentic-protocol: mcp-streamable-1.0
      operationId: InvokeMCP
      responses:
        '200':
          description: Success

编辑 MCP 连接

编辑 MCP 连接器或添加自定义参数：

转到 Power Apps 或 Power Automate 门户并选择 “自定义连接器”。
在连接器列表中找到连接器文件，并使用其中一种可用方法进行必要的更新。

反馈

此页面是否有帮助？