连接器管理

选择该方式时，平台会在内部自动下载并启动MCP服务，无需用户自行部署。您只需填写启动命令和参数即可。

1. 在左侧导航栏，选择“智能体·技能·连接器”，在右侧区域选择“连接器>我的连接器”页签，单击界面右上角的“自定义添加”，如图1所示。
   图1 自定义添加连接器
   

2. 在弹出的“添加MCP连接器”的对话框中，选择MCP的“传输类型”为“Stdio”，配置如下参数。

   表2 添加Stdio传输类型的MCP连接器

   参数	说明	示例
   服务器名称	输入MCP连接器的名称，用于在连接器列表中标识该连接器。 命名规则： 命名要求：仅支持以中文或英文字母开头。 支持字符：中文、英文、数字、中划线（-）、下划线（_）。 长度限制：2~64个字符	Fetch网页抓取
   描述	可选参数。MCP连接器的简要说明，帮助用户理解服务功能，最多1000个字符。	用于抓取指定URL的网页内容，获取网页的HTML或纯文本，供智能体读取和分析网页信息。
   图标	系统默认提供MCP连接器图标。用户也可以自定义图标，自定义图标步骤如下： 鼠标移动至系统默认图标上，单击鼠标左键。 上传已准备好的应用图标。 支持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 目录。
   参数	可选参数。在启动命令需要额外命令行参数才能运行时配置。 输入启动命令的参数，一行一个参数，每个参数作为独立数组元素。	要执行npx -y @modelcontextprotocol/server-filesystem /tmp，参数应分行填写： -y @modelcontextprotocol/server-filesystem /tmp
   环境变量	可选参数。当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连接器。

   如果界面显示连接失败，您可以通过AI诊断失败原因，具体请参见AI诊断MCP连接器。

选择该方式时，MCP服务运行在外部环境中（如用户自建服务器、第三方MCP厂商提供的接口等），平台作为客户端通过网络地址发起连接。您只需提供MCP服务的接口地址即可接入，无需关心服务端的部署和运维。Streamable HTTP是MCP协议推荐的远程连接方式。

1. 在左侧导航栏，选择“智能体·技能·连接器”，在右侧区域选择“连接器>我的连接器”页签，单击界面右上角的“自定义添加”，如图2所示。
   图2 自定义添加连接器
   

2. 在弹出的“添加MCP连接器”的对话框中，选择MCP的“传输类型”为“Streamable HTTP”，配置如下参数。

   表3 添加Streamable HTTP传输类型的MCP连接器

   参数	说明	示例
   服务器名称	输入MCP连接器的名称，用于在连接器列表中标识该连接器。 命名规则： 命名要求：仅支持以中文或英文字母开头。 支持字符：中文、英文、数字、中划线（-）、下划线（_）。 长度限制：2~64个字符	天眼查
   描述	可选参数。MCP连接器的简要说明，帮助用户理解服务功能，最多1000个字符。	天眼查连接器为大模型提供可信的商业信息。提供公司信息、老板信息、招投标信息、司法风险信息的查询能力。
   图标	系统默认提供MCP连接器图标。用户也可以自定义图标，自定义图标步骤如下： 鼠标移动至系统默认图标上，单击鼠标左键。 上传已准备好的应用图标。 支持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连接器。

选择该方式时，与Streamable HTTP类似，MCP服务同样运行在外部环境中，您同样只需提供接口地址即可接入。SSE是较早期的远程连接方式，主要适用于已有的老服务兼容接入，新接入的远程服务建议优先选择Streamable HTTP。

1. 在左侧导航栏，选择“智能体·技能·连接器”，在右侧区域选择“连接器>我的连接器”页签，单击界面右上角的“自定义添加”，如图3所示。
   图3 自定义添加连接器
   

2. 在弹出的“添加MCP连接器”的对话框中，选择MCP的“传输类型”为SSE，配置如下参数。

   表4 添加SSE传输类型的MCP连接器

   参数	说明
   服务器名称	输入MCP连接器的名称，用于在连接器列表中标识该连接器。 命名规则： 命名要求：仅支持以中文或英文字母开头。 支持字符：中文、英文、数字、中划线（-）、下划线（_）。 长度限制：2~64个字符
   描述	可选参数。MCP连接器的简要说明，帮助用户理解服务功能，最多1000个字符。
   图标	系统默认提供MCP连接器图标。用户也可以自定义图标，自定义图标步骤如下： 鼠标移动至系统默认图标上，单击鼠标左键。 上传已准备好的应用图标。 支持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连接器。