# 连接器 在使用果办OfficeAce执行任务时，果办OfficeAce可能需要与外部工具或数据源进行交互，例如访问本地文件系统、调用远程API等。MCP连接器作为专家与外部资源之间的桥梁，使专家能够扩展能力范围。通过连接器功能，用户可以[自定义添加连接器]，满足不同业务场景的集成需求。 #### 相关概念 **MCP连接器**：基于Model Context Protocol协议的连接器，用于将外部工具或数据源接入专家，使专家能够调用外部能力完成任务。每个连接器对应一个独立的服务端程序，通过指定的传输类型与专家进行通信。 #### 从连接器广场添加连接器 1. 在左侧导航栏，选择"专家·技能·连接器"，选择"连接器"页签，如[图1]所示。 图1连接器广场 ![](https://support.huaweicloud.com/usermanual-officeace/zh-cn_image_0000002753895995.png "点击放大") 2. 在连接器广场的顶部，您可以通过关键字搜索连接器。 3. 找到目标连接器后，单击"连接"，在弹出的对话框中按照界面提示完成连接配置。不同类型连接器的认证方式如下： - **密钥认证**：输入API Key或Token等认证信息。 - **扫码授权**：使用对应App扫描二维码完成连接。 - **第三方授权** ：跳转至第三方网站，注册并登录后直接授权连接。 ![](https://support.huaweicloud.com/usermanual-officeace/public_sys-resources/note_3.0-zh-cn.png) 连接器的认证信息，请从对应的第三方网站获取。 4. 配置完成后，单击"确认并连接"。界面显示连接成功，表示已成功添加MCP连接器。 连接器连接成功后，您可以在"我的连接器"列表查看到该连接器。 5. 添加完成后，您可以试用连接器。 1. 鼠标悬浮至该连接器，单击"试用一下"。 2. 果办OfficeAce将新建对话，您可以在对话框中输入提示词或使用默认的提示词，单击![](https://support.huaweicloud.com/usermanual-officeace/zh-cn_image_0000002724296308.png)可以试用该连接器。 #### 自定义添加连接器 连接器广场中的连接器不满足您的需求时，可以自定义添加连接器，支持添加**Stdio** 、**Streamable HTTP** 和**SSE**三种传输类型的MCP连接器。 不同传输类型的适用场景不同，请根据实际需求选择。 表1三种传输类型对比 | 维度 | **Stdio** | **Streamable HTTP** | **SSE** | |:---|:---|:---|:---| | 适用场景 | 本地开发调试、无公网地址的工具。 | 生产环境远程调用、第三方SaaS服务接入。 | 兼容已有的老版本MCP服务。 | | 部署方式 | 平台自动下载启动。 | 自行部署或使用第三方URL。 | 用户提供SSE接口地址。 | | 推荐度 | ★★★ | ★★★★★（远程连接推荐） | ★★（仅兼容用） | | 操作文档 | [添加Stdio传输类型的连接器] | [添加Streamable HTTP传输类型的连接器] | [添加SSE传输类型的连接器] | - [添加Stdio传输类型的连接器] 选择该方式时，平台会在内部自动下载并启动MCP服务，无需用户自行部署。您只需填写启动命令和参数即可。 1. 在左侧导航栏，选择"专家·技能·连接器"，选择"连接器"页签，在界面右上角单击"我的"，单击"自定义添加"。 2. 在弹出的"添加MCP连接器"的对话框中，选择MCP的"传输类型"为"**STDIO** "，如[图2]所示，配置参数说明如[表2]所示。 图2添加**Stdio** 传输类型的MCP连接器 ![](https://support.huaweicloud.com/usermanual-officeace/zh-cn_image_0000002753895999.png "点击放大") 表2添加**Stdio** 传输类型的MCP连接器 | 参数 | 说明 | 示例 | |:---|:---|:---| | 服务器名称 | 输入MCP连接器的名称，用于在连接器列表中标识该连接器。 命名规则： - 命名要求：仅支持以**中文** 或**英文字** **母**开头。 - 支持字符：中文、英文、数字、中划线（-）、下划线（_）。 - 长度限制：2\~64个字符 | Fetch网页抓取 | | 描述 | 可选参数。MCP连接器的简要说明，帮助用户理解服务功能，最多1000个字符。 | 用于抓取指定URL的网页内容，获取网页的HTML或纯文本，供专家读取和分析网页信息。 | | 图标 | 系统默认提供MCP连接器图标。用户也可以自定义图标，自定义图标步骤如下： 1. 鼠标移动至系统默认图标上，单击鼠标左键。 2. 上传已准备好的应用图标。 支持png、jpeg、jpg格式图片，且图片大小不大于200KB。 | 使用默认图标 | | 命令 | 用于指定启动MCP连接器服务端程序所使用的可执行命令。 两种填写方式： - **可执行文件名**：直接填写系统环境变量中已注册的命令，如npx、uvx、python、node、docker等。系统会在环境变量路径中自动查找并执行。例如填npx，即通过Node.js的npx工具来运行连接器包。 - **绝对路径**：填写可执行文件在系统中的完整路径，如/usr/local/bin/node或C:\\Program Files\\nodejs\\node.exe。适用于可执行文件未加入环境变量，或需要指定特定版本的场景。 **示例：** 假设添加一个文件系统连接器，命令填npx，参数填： ``` -y @modelcontextprotocol/server-filesystem /tmp ``` 系统实际执行的等效命令为：npx -y @modelcontextprotocol/server-filesystem /tmp，即通过npx下载并运行MCP文件系统服务，使其可访问 /tmp目录。 | uvx | | 参数 | 可选参数。在启动命令需要额外命令行参数才能运行时配置。 输入启动命令的参数，一行一个参数，每个参数作为独立数组元素。 **示例：** 要执行npx -y @modelcontextprotocol/server-filesystem /tmp，参数应分行填写： ``` -y @modelcontextprotocol/server-filesystem /tmp ``` | mcp-server-fetch | | 环境变量 | 可选参数。当MCP服务运行时需要用到**敏感信息或配置参数**时，就需要填环境变量。 单击"添加变量"添加连接器运行时可传递的环境变量键值对。 - Key：环境变量的键名。 - Value：环境变量的值。 - 敏感：勾选后，该环境变量值将被标记为敏感信息，界面中以密文显示，存储时加密保护。 - 删除：单击"删除"可移除该条环境变量。 **常见场景：** - 需要API密钥：连接OpenAI、高德地图等第三方服务时，需填入API_KEY=sk-\*\*\*\*\*\*\*\*。 - 需要数据库连接串：连接MySQL、PostgreSQL时，需填入DATABASE_URL=mysql://...。 - 需要指定服务地址：连接内部系统时，需填入ENDPOINT=https://internal-api.example.com。 - 需要认证凭证：需要用户名密码时，如USERNAME=admin、PASSWORD=xxx。 - 需要控制运行行为：如LOG_LEVEL=debug、TIMEOUT=30。 **简单判断**：如果MCP服务的文档中要求你配置API Key、Token、连接地址等，就需要在环境变量中添加对应的键值对。如果服务不需要这些，留空即可。 | 留空 | | 超时时间 | 可选参数。设置果办OfficeAce与外部平台交互时的等待上限，覆盖建立连接、获取工具列表、调用工具三个环节。若超过该时间未收到响应，则判定为超时失败。取值范围1\~120秒，留空则使用默认值60秒。 | 60 | 3. 配置完成后，单击"确认并连接"。界面显示连接成功，表示已成功添加MCP连接器。 您可以在"我的连接器"列表，查看该连接器。 - [添加Streamable HTTP传输类型的连接器] 选择该方式时，MCP服务运行在外部环境中（如用户自建服务器、第三方MCP厂商提供的接口等），平台作为客户端通过网络地址发起连接。您只需提供MCP服务的接口地址即可接入，无需关心服务端的部署和运维。Streamable HTTP是MCP协议推荐的远程连接方式。 1. 在左侧导航栏，选择"专家·技能·连接器"，选择"连接器"页签，在界面右上角单击"我的"，单击"自定义添加"。 2. 在弹出的"添加MCP连接器"的对话框中，选择MCP的"传输类型"为"**Streamable HTTP** "，如[图3]所示，配置参数说明如[表3]所示。 图3添加**Streamable HTTP** 传输类型的MCP连接器 ![](https://support.huaweicloud.com/usermanual-officeace/zh-cn_image_0000002730094196.png "点击放大") 表3添加**Streamable HTTP** 传输类型的MCP连接器 | 参数 | 说明 | 示例 | |:---|:---|:---| | 服务器名称 | 输入MCP连接器的名称，用于在连接器列表中标识该连接器。 命名规则： - 命名要求：仅支持以**中文** 或**英文字** **母**开头。 - 支持字符：中文、英文、数字、中划线（-）、下划线（_）。 - 长度限制：2\~64个字符 | 天眼查 | | 描述 | 可选参数。MCP连接器的简要说明，帮助用户理解服务功能，最多1000个字符。 | 天眼查连接器为大模型提供可信的商业信息。提供公司信息、老板信息、招投标信息、司法风险信息的查询能力。 | | 图标 | 系统默认提供MCP连接器图标。用户也可以自定义图标，自定义图标步骤如下： 1. 鼠标移动至系统默认图标上，单击鼠标左键。 2. 上传已准备好的应用图标。 支持png、jpeg、jpg格式图片，且图片大小不大于200KB。 | 使用默认图标 | | 服务器地址 | MCP服务的接口地址，输入采用Streamable HTTP传输类型的服务端URL。 格式示例：https://mcp.example.com/api/mcp | https://mcp.tianyancha.com/v1 | | Headers | 可选参数。Headers（请求头）是连接器访问远程服务时附带的额外身份或配置信息，如果MCP服务没有要求携带任何认证或特殊信息，留空即可。 **常见场景：** - 需要身份认证：添加Authorization: Bearer sk-\*\*\*\*\*\*\*\*，告诉对方你有访问权限 - 需要指定数据格式：添加Content-Type: application/json，告诉对方你要JSON格式返回 - 需要自定义标识：添加X-API-Key: abc123，某些第三方服务要求携带专属密钥。 单击"添加Header"添加**连接器请求时携带的键值对**。 - Key：请求头的键名。 - Value：请求头的值。 - 敏感：勾选后，该Header值将被标记为敏感信息，界面中以密文显示，存储时加密保护。 - 删除：单击"删除"可移除该条Header。 | 例如接入一个第三方MCP服务，该MCP服务提供了一个 API Key为mcpk2_Eai\*\*\*\*\*\*KoIbMQ，要求请求时携带认证信息，那么在Headers中添加： - 键：Authorization - 值：mcpk2_Eai\*\*\*\*\*\*KoIbMQ | | 超时时间 | 可选参数。设置果办OfficeAce与外部平台交互时的等待上限，覆盖建立连接、获取工具列表、调用工具三个环节。若超过该时间未收到响应，则判定为超时失败。取值范围1\~120秒，留空则使用默认值60秒。 | 60 | 3. 配置完成后，单击"确认并连接"。界面显示连接成功，表示已成功添加MCP连接器。 如果界面显示连接失败，您可以通过AI诊断失败原因，具体请参见[AI诊断MCP连接器]。 - [添加SSE传输类型的连接器] 选择该方式时，与Streamable HTTP类似，MCP服务同样运行在外部环境中，您同样只需提供接口地址即可接入。SSE是较早期的远程连接方式，主要适用于已有的老服务兼容接入，新接入的远程服务建议优先选择Streamable HTTP。 1. 在左侧导航栏，选择"专家·技能·连接器"，选择"连接器"页签，在界面右上角单击"我的"，单击"自定义添加"。 2. 在弹出的"添加MCP连接器"的对话框中，选择MCP的"传输类型"为**SSE** ，配置如下参数。 表4添加**SSE** 传输类型的MCP连接器 | 参数 | 说明 | |:---|:---| | 服务器名称 | 输入MCP连接器的名称，用于在连接器列表中标识该连接器。 命名规则： - 命名要求：仅支持以**中文** 或**英文字** **母**开头。 - 支持字符：中文、英文、数字、中划线（-）、下划线（_）。 - 长度限制：2\~64个字符 | | 描述 | 可选参数。MCP连接器的简要说明，帮助用户理解服务功能，最多1000个字符。 | | 图标 | 系统默认提供MCP连接器图标。用户也可以自定义图标，自定义图标步骤如下： 1. 鼠标移动至系统默认图标上，单击鼠标左键。 2. 上传已准备好的应用图标。 支持png、jpeg、jpg格式图片，且图片大小不大于200KB。 | | 服务器地址 | MCP服务的接口地址，输入采用SSE传输类型的服务端URL。 格式示例：https://mcp.example.com/api/mcp | | Headers | 可选参数。Headers（请求头）是连接器访问远程服务时附带的额外身份或配置信息，如果MCP服务没有要求携带任何认证或特殊信息，留空即可。 单击"添加Header"添加连接器请求时携带的键值对。 - Key：请求头的键名。 - Value：请求头的值。 - 敏感：勾选后，该Header值将被标记为敏感信息，界面中以密文显示，存储时加密保护。 - 删除：单击"删除"可移除该条Header。 **常见场景：** - 需要身份认证：添加Authorization: Bearer sk-\*\*\*\*\*\*\*\*，告诉对方你有访问权限。 - 需要指定数据格式：添加Content-Type: application/json，告诉对方你要JSON格式返回。 - 需要自定义标识：添加X-API-Key: abc123，某些第三方服务要求携带专属密钥。 **示例：**例如接入一个第三方MCP服务，该MCP服务提供了一个API Key为mcpk2_Eai\*\*\*\*\*\*KoIbMQ，要求请求时携带认证信息，那么在Headers中添加： - 键：Authorization - 值：mcpk2_Eai\*\*\*\*\*\*KoIbMQ | | 超时时间 | 可选参数。设置果办OfficeAce与外部平台交互时的等待上限，覆盖建立连接、获取工具列表、调用工具三个环节。若超过该时间未收到响应，则判定为超时失败。取值范围1\~120秒，留空则使用默认值60秒。 | 3. 配置完成后，单击"确认并连接"。界面显示连接成功，表示已成功添加MCP连接器。 如果界面显示连接失败，您可以通过AI诊断失败原因，具体请参见[AI诊断MCP连接器]。 #### AI诊断MCP连接器 如果MCP连接器显示连接失败，您可以通过AI诊断连接失败原因。 1. 在左侧导航栏，选择"专家·技能·连接器"，选择"连接器"页签，单击页面右上角"我的"。 2. 将鼠标悬浮在连接失败的MCP连接器上，单击"AI诊断"。 图4AI诊断MCP连接器 ![](https://support.huaweicloud.com/usermanual-officeace/zh-cn_image_0000002754016093.png) 3. 界面跳转至任务对话界面，发送后，AI将自动诊断失败原因。 4. 请根据果办OfficeAce给出的修复方案执行操作后，单击"连接"可重新连接MCP连接器。 界面显示连接成功，表示已成功添加MCP连接器。 #### 使用连接器 单击对话框左下角的![](https://support.huaweicloud.com/usermanual-officeace/zh-cn_image_0000002754016095.png)，选择"连接器"，单击需要添加的连接器右边的"连接"，对话框左下角将显示已添加的连接器。 后续和果办OfficeAce对话时，专家将会在已添加的连接器中找到最合适的连接器。 图5使用连接器 ![](https://support.huaweicloud.com/usermanual-officeace/zh-cn_image_0000002724456268.png "点击放大") #### 更多操作 MCP连接器添加后，还可以进行如下操作。 表5更多操作 | 任务名称 | 操作说明 | |:---|:---| | 断开连接器 | 对于从连接器广场添加的连接器，如果不想使用该连接器时，可以断连该连接器。 在"我的连接器"列表，鼠标悬浮至该MCP连接器，单击"断开"，可断开与该MCP连接器的连接。 | | 重连连接器 | 在"我的连接器"列表或"连接器广场"界面，鼠标悬浮至MCP连接器，单击"重连"，可重新连接MCP连接器。 | | 配置连接器 | 在"我的连接器"列表或"连接器广场"界面，鼠标悬浮至MCP连接器，单击"配置"，可修改MCP连接器的配置信息。 | | 删除连接器 | 在"我的连接器"列表界面，鼠标悬浮至MCP连接器，单击"删除"，可删除MCP连接器。 |