OfficeAce搭配华为连接器：添加、调试到对话调用

先说结论

果办 OfficeAce 自带的对话和技能，适合写材料、做研究和整理本地文件。一旦任务要碰到外部系统——查网页、调企业接口、访问华为云资源——就需要连接器。连接器不是另一套聊天机器人，而是让专家按统一协议调用外部工具的桥梁。今天这篇只讲一件事：怎么在 OfficeAce 里把华为侧的连接能力接上、调通，再放进日常对话里用。

下面的路径以华为云帮助中心《果办 OfficeAce 进阶指南》中的连接器章节为准。客户端版本不同时，按钮文案可能略有差异，以你本机界面为准。

连接器到底是什么

官方定义很直接：连接器就是 MCP 连接器。MCP（Model Context Protocol，模型上下文协议）给模型和外部工具定了一套沟通规则。你在 OfficeAce 里添加的每一个连接器，本质上都对应一个独立的服务端，用指定的传输方式跟专家通信。

它和技能不是一回事。技能更像专家已经会的做法；连接器是专家临时伸出去的手。手伸到哪里，由你授权的那一个服务决定。所以添加之前先想清楚三件事：这个服务只读还是会写入、凭证放在哪里、失败了能不能断开。

入口在哪里

登录客户端后，左侧进入「专家 · 技能 · 连接器」，打开「连接器」页签。右上角的「我的连接器」里能看到两类来源：

• 平台精选：系统内置。没连上的可以配置并连接；已经连上的可以配置、断开，也可以「试用一下」。
• 我添加的：从广场装的，或自己手动加的。这类可以配置，也可以删除。

列表支持按名称或描述搜索。点进某个已连接成功的连接器，能看到它暴露的工具列表。不常用的工具可以先停用，减少后续对话里的 Token 消耗。停用不影响单独调试，确认可用后再打开。

三条添加路径，按熟悉程度选

1. 从连接器广场添加。适合大多数办公场景。在广场里搜到目标连接器，点「连接」。认证通常是三种之一：填 API Key 或 Token；用对应 App 扫码；跳到第三方网站登录后授权。凭证要从服务提供方自己的控制台获取，不要把别人截图里的密钥抄过来。配完点「确认并连接」，成功后会出现在「我的连接器」。鼠标悬停还可以「试用一下」，客户端会新开一轮对话，你可以用默认提示词，也可以改成自己的任务。

2. JSON 配置，一次加多个。右上角「我的连接器」里点「自定义添加」，把 MCP 服务文档里的 JSON 贴进去。适合已经有现成配置、想批量接入的人。文档写明一次最多识别 10 个。界面列出识别结果后，勾选真正要连的，再点确定并连接。如果名字和已有连接器重复，会添加失败，改名后重试即可。

3. 表单配置，一次加一个。不熟悉 JSON 时用这个，不容易写错语法。传输类型有三种，别一上来就全试。

三种传输类型怎么选

帮助中心把差异写得很清楚，选型可以记成一句话：远程服务优先 Streamable HTTP，本机没有公网地址再用 Stdio，SSE 只为兼容旧服务。

• Stdio：OfficeAce 在你电脑上启动服务，双方本地通信。适合本地调试，或工具没有公网地址。你要填启动命令和参数。命令可以是已经在环境变量里的 npx、uvx、node，也可以是可执行文件的绝对路径。参数一行一个，不要挤在同一行。
• Streamable HTTP：服务跑在别处，你只提供 URL。这是远程连接的推荐方式，第三方 SaaS 和自建 MCP 都走它。需要认证时在 Headers 里加，例如 Authorization。不需要认证就留空。
• SSE：早期的远程方式。老服务还在用 SSE 时再选，新接入不要默认用它。

名称要遵守规则：中文或英文字母开头，可用中文、英文、数字、中划线和一个下划线，长度 2 到 64。描述可选，最多 1000 字。图标可以用默认的，也可以换成不超过 200KB 的 png 或 jpg。

和华为云账号怎么配

这是「搭配华为连接器」里最容易配错的一段。表单里有一项「华为云 IAM 鉴权」，当前仅 Windows 支持。打开之后，客户端用你已经登录的华为云账号签发临时凭证，完成 IAM 签名，不需要你在表单里手填 AK/SK。

如果本地连接器的环境变量里需要这些凭证，使用占位符，而不是把长期密钥写死：

• {ACCESS_KEY} 运行时换成临时 AK
• {SECRET_KEY} 换成临时 SK
• {SECURITY_TOKEN} 换成临时 SecurityToken
• {PROJECT_ID} 换成当前项目 ID

这样做的好处是密钥不落在聊天记录和截图里。前提仍是：你登录 OfficeAce 用的华为账号或 IAM 用户，本身要有调用目标云服务的权限。连接器不会替你绕过 IAM。macOS 和 HarmonyOS 目前没有这一项，这两端要按服务文档使用它自己的认证方式，不要假设 IAM 开关也在。

超时时间覆盖建连、拉工具列表、调用工具三步，范围 1 到 120 秒，留空默认 60 秒。华为云接口如果偶发慢，可以适当加大，但不要为了掩盖配置错误把超时拉到顶。

连上之后，先调试再交给对话

连接成功不等于任务能跑完。官方提供了两种验证，用途不同：

• 工具调试：在连接器详情的工具行上点「调试」，填写入参后点「运行」。它直接打 MCP 接口，不经过对话，用来确认这个工具本身通不通、返回长什么样。只有已连接成功的连接器才有这个按钮。调试结果关窗口就丢，不会写进对话记录。
• 试用一下：新开对话，由专家决定怎么调用工具，验证的是整条使用链路，而不是某一个接口。

有一个必须记住的限制：调试是真实调用。创建文件、发消息、改云资源这类写入工具，点运行就会在目标系统里留下真实结果。先用只读查询把参数跑通，确认无误再测写入。

日常使用时，在对话框左下角打开连接器入口，对需要的连接器点「连接」。之后专家会在你已经接上的连接器里挑选合适的工具。不要把广场里所有连接器都挂进同一轮对话，工具越多，选错和多耗 Token 的概率越高。

一个可以照着做的办公例子

假设你要写一份云资源周报：既要引用华为云项目里的真实信息，又要核对公开文档里的概念。可以按这个顺序，而不是一上来就让专家「帮我搞定」：

1. 在广场或自定义入口添加一个只读的资料连接器，远程服务选 Streamable HTTP。
2. 如果这个连接器要访问你账号下的华为云接口，并且你在 Windows 上，打开 IAM 鉴权，环境变量里只放占位符。
3. 连接成功后，打开详情，停用用不到的写入类工具。
4. 对一个查询类工具做调试，确认返回里有你要的字段，而不是鉴权错误。
5. 回到对话，只挂上这一个连接器，把任务说具体：要哪个项目、哪段时间、输出成什么结构。不要把 AK、SK、Token 写进提示词。
6. 专家给出草稿后，用它引用的字段回查一次。连接器扩展的是手，不是事实审核员。

连不上时怎么排

在「我的连接器」里，把鼠标放到失败的连接器上，点「AI 诊断」。客户端会跳到任务对话，由专家根据失败信息给修复建议。你按建议改完配置，再点「连接」重试。

常见情况和文档里的处理方式对应如下：

• 名称冲突：和已有连接器重名，改名。
• 认证失败：Key、Token 或 Header 来自服务方控制台，注意有没有多空格、有没有过期。
• 远程地址不对：Streamable HTTP 和 SSE 不要混用。新服务优先 HTTP。
• Stdio 起不来：命令是否在环境变量里，参数是否一行一个，本机有没有对应运行时。
• IAM 不生效：确认系统是 Windows，并且当前登录账号对该云服务有权限。
• 超时：先看是地址不通还是服务慢，再考虑把 60 秒调高，不要只改超时。

暂时不用时，悬停后点「断开」，不必立刻删除。配置错了用「配置」修改；确认不再使用，再在「我的连接器」里删除。

使用时的几条边界

• 密钥放在连接器的环境变量或 Header 里，并勾选敏感，不要贴进博客、截图和提示词。
• 写入类工具默认先停用，调试前再单独打开。
• 同一轮对话只挂当前任务需要的连接器。
• IAM 临时凭证只解决「怎么签」，不解决「有没有权限」。
• 步骤和按钮以帮助中心及你安装的客户端版本为准。本文依据的是连接器使用指南与连接器常见问题，更新时间可在文档页核对。

参考

• 连接器使用指南：https://support.huaweicloud.cn/usermanual-officeace/officeace_02_0016.html
• 连接器常见问题：https://support.huaweicloud.cn/usermanual-officeace/officeace_02_0064.html
• 果办 OfficeAce 产品页：https://www.huaweicloud.cn/product/officeace.html