连接 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 工具的说明手动添加服务。