跳至主要内容

连接 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 登录和组织授权。

三、复制提示词并安装​

  1. 点击【复制提示词(发送给 Agent 安装)】。
  2. 将提示词粘贴到所使用的 AI 工具对话框中发送。
  3. 由 AI 按提示完成安装和配置;如果需要登录、授权或重启工具,按对话提示操作。
  4. 安装完成后,让 AI 检查连接情况,即可开始使用。
工具支持

所使用的 AI 工具需支持对应能力,例如 MCP、Skills 或本地终端命令执行。具体安装方式以工具自身的支持情况为准。

四、更多连接方式​

如果需要分别配置 MCP、HAP CLI,或安装视图插件开发技能,可以点击【更多】。

HAP MCP​

通过 MCP 协议连接 HAP,无需安装 HAP 本地命令行,即可让 AI 搭建、修改应用和读写工作表数据。

配置 MCP 服务​

  1. 点击【更多】>【HAP MCP】。
  2. 选择个人访问令牌。
  3. 在配置 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
两种 CLI 的区别

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。

這篇文件對你有幫助嗎?