连接 AI(MCP、CLI、SKill)
通过连接 AI,可以将 HAP 与外部 AI Agent 工具连接,让 AI 在授权范围内搭建和修改应用、查询和处理数据,以及开发网站、后端服务和自定义视图。
连接时会用到以下能力:
- MCP:让 AI 工具连接 HAP,直接调用应用搭建、数据读写等能力。
- CLI:通过终端命令执行操作。HAP CLI 用于操作应用与业务数据,HAP Compute CLI 用于部署和管理网站及后端服务。
- Skills:为 AI 提供操作指南和任务流程,帮助它正确使用 MCP、CLI 或 API 完成任务。
操作入口:在平台首页右上角点击【连接 AI】,选择需要的能力,复制提示词发送给 AI 助手,即可开始安装。

一、选择安装能力
支持单独选择,也可以同时安装:
- HAP 应用与数据:包含 MCP 和配套 Skills,用于搭建、修改 HAP 应用,以及读写工作表 数据。
- HAP Compute:包含 Compute CLI 和配套 Skills,用于开发前端网页、后端接口,并部署上线。
例如,只需要让 AI 查询数据、调整工作表,可以选择 HAP 应用与数据;如果希望开发一个连接 HAP 数据的Compute 网站,可以同时选择两项。
二、选择个人访问令牌
选择 HAP 应用与数据 后,需要选择个人访问令牌,让 AI 按当前用户的授权范围访问 HAP。
如果还没有令牌,点击【创建个人访问令牌】,按提示创建。创建后返回连接界面,点击【刷新令牌】,再选择对应令牌。
详细说明请参考个人访问令牌。
仅选择 HAP Compute 时,无需在此选择个人访问令牌,安装过程中按提示完成 Compute 登录和组织授权。
三、复制提示词并安装
- 点击【复制提示词(发送给 Agent 安装)】。
- 将提示词粘贴到所使用的 AI 工具对话框中发送。
- 由 AI 按提示完成安装和配置;如果需要登录、授权或重启工具,按对话提示操作。
- 安装完成后,让 AI 检查连接情况,即可开始使用。
所使用的 AI 工具需支持对应能力,例如 MCP、Skills 或本地终端命令执行。具体安装方式以工具自身的支持情况为准。
四、更多连接方式
如果需要分别配置 MCP、HAP CLI,或安装视图插件开发技能,可以点击【更多】。

HAP MCP
通过 MCP 协议连接 HAP,无需安装 HAP 本地命令行,即可让 AI 搭建、修改应用和读写工作表数据。
配置 MCP 服务
- 点击【更多】>【HAP MCP】。
- 选择个人访问令牌。
- 在配置 MCP 服务区域点击【复制提示词】,发送给 AI 工具完成配置。
也可以复制页面提供的 MCP 配置,按照 AI 工具的说明手动添加服务。
安装 MCP Skills
在安装 MCP Skills区域点击【复制提示词】,发送给 AI 工具安装。
配套技能 hap-mcp-app-builder 用于通过 MCP 服务搭建、诊断和修改 HAP 应用。
如需手动安装,可复制页面中的命令,在终端执行:
npx skills add mingdaocom/hap-skills --skill hap-mcp-app-builder
详细介绍请参考 MCP Server。
HAP CLI
HAP CLI 是用于调用 HAP 能力的命令行工具,覆盖应用、工作表、工作流、审批、通讯录、日程、群聊等场景,适合在本地终端、服务器脚本或自动化脚本中使用。
本地需安装 Python 3.10 或以上版本。CLI 访问受组织策略控制,如未开启,需由组织管理员在【组织管理】>【数据与访问】中开启 CLI 访问策略。
安装 HAP CLI
点击【更多】>【HAP CLI】,在安装 HAP CLI区域点击【复制提示词】,发送给 AI 工具,按提示完成安装和登录授权。
也可以在终端手动安装:
pip install hap-cli
安装后,按照 CLI 使用帮助完成登录。
安装配套 Skills
在**安装 CLI 配套 Skills(必装)**区域点击【复制提示词】,发送给 AI 工具安装。
配套技能包括:
- 建应用:根据需求创建应用,并配置示例数据。
- 改应用:调整 字段、视图、权限和工作流。
- 查数据:进行复杂筛选、分组和透视聚合。
如需手动安装,可执行:
npx skills add mingdaocom/hap-skills --skill hap-cli --skill hap-cli-app-creator --skill hap-cli-app-editor --skill hap-cli-data-query --skill hap-cli-environments
HAP CLI 用于操作 HAP 应用与业务数据;HAP Compute CLI 用于开发部署相关操作。开发 Compute 网站,请在连接界面选择 HAP Compute。
详细操作请参考 CLI 使用帮助。
视图插件开发
点击【更多】>【视图插件开发】,安装接口对接和视图插件开发所需的 Skills,帮助 AI:
- 在外部代码或视图插件中调用 HAP V3 HTTP 接口,读写业务数据。
- 开发看板、甘特图、地图等自定义视图。
点击【复制提示词】,发送给 AI 工具安装。也可以在终端执行:
npx skills add mingdaocom/hap-skills --skill hap-apiv3-data --skill hap-view-plugin --skill hap-api-website
安装 Skills 后,仍需根据实际开发场景完成接口鉴权等配置。
全部技能及说明请参考 HAP Skills。
五、访问凭证与权限
访问凭证用于确认外部工具调用 HAP 时使用的身份和授权范围。安装工具或 Skills 本身不会扩大用户的数据访问权限。
个人访问令牌
个人访问令牌代表当前用户身份,可以设置允许访问的组织、应用和 接口范围。
点击头像 >【授权与访问】>【个人访问令牌】,点击【添加】。也可以从连接界面点击【创建个人访问令牌】进入。
创建时需要设置:
- 名称:便于识别令牌的用途。
- 有效期:设置令牌可使用的期限。
- 组织:允许访问的组织。
- 应用范围:允许访问所有应用或指定应用;选择指定应用前,需先选择对应组织。
- 接口范围:允许调用的接口能力。
创建完成后,返回连接界面,刷新并选择该令牌。
按实际任务选择所需权限。如果令牌仅允许访问指定应用,后续新建的应用可能不在授权范围内,需要调整授权后才能继续操作。
使用个人访问令牌前,需确认组织已开启相应的个人访问令牌 API 访问策略。
个人访问令牌具有对应的访问权限。请仅在可信的工具和环境中使用,不要公开分享含有令牌的安装提示词或配置,也不要将令牌写入前端代码或公开仓库。
更多接口说明请参考个人访问令牌 API 文档。
应用授权密钥
在使用应用身份调用 API 的开发场景中,可以使用应用授权密钥。
进入应用的【API 开发文档】,在应用授权中创建和管理授权密钥,并根据实际调用方式配置鉴权。
当前连接界面中的默认安装流程和 HAP MCP 配置使用个人访问令牌。
六、连接后开始使用
安装并确认连接正常后,可以直接向 AI 描述任务。
搭建 HAP 应用:
帮我搭建一个客户管理应用,包含客户、销售机会和跟进记录。销售人员只能查看自己的客户,主管可以查看团队数据。
查询业务数据:
查询本月未付款的订单,按客户汇总订单金额。
开发 Compute 网 站:
请制作一个活动报名网站,展示活动时间、地点和介绍,支持访客填写姓名、公司、手机号和邮箱。报名信息通过 API 保存到 HAP 工作表中,完成后部署到 Compute。
不必一次提供完整的技术方案。对于会影响数据结构、访问权限或业务处理的事项,可以要求 AI 先提问或说明方案,再开始实施。实现后也可以通过对话继续调整。
Compute 的开发、发布与更新方式,请参考 Compute。
這篇文件對你有幫助嗎?