连接 AI（MCP、CLI、SKill）

---

连接 AI 用于将 HAP 与外部 AI Agent 工具连接，使 AI 工具可以在授权范围内理解和调用 HAP 能力，辅助完成应用搭建、数据查询、自动化配置、接口开发等操作。

在 HAP 中，可通过【连接 AI】入口安装和配置 MCP、CLI、Skills。

连接类型

目前支持三种连接类型：

• MCP：将 HAP 作为 MCP Server 连接到 AI Agent 工具中。
• CLI：通过终端命令调用 HAP 能力，覆盖应用、工作表、工作流、审批、通讯录、日程、群聊等更多场景，适用于在本地终端、服务器脚本或自动化脚本中使用。
• Skills：安装 HAP 相关技能，让 AI 真正掌握操作 HAP 的能力，覆盖 CLI 命令、MCP 服务、API 接口三种使用方式，从建应用、改数据到二次开发全流程支持。

操作入口：在【平台首页】右上角点击【连接 AI】，打开配置界面。

MCP

连接支持 MCP 的 AI Agent 工具后，AI 工具可在授权范围内访问 HAP，并调用相关能力完成数据查询、应用配置、流程处理等操作。

连接步骤：

• 1. 选择安装方式：MCP 支持对话安装和手动安装。建议优先使用对话安装。

• 2. 选择连接工具：选择需要连接的 AI Agent 工具。系统会根据所选工具生成对应的安装内容。若列表中没有对应工具，可选择【其他】。

• 3. 选择权限范围：MCP 支持按个人或应用权限连接 HAP。

  • 选择【个人】时，AI 工具按当前用户权限访问和操作 HAP 数据，需要选择个人访问令牌；
  • 选择【应用】时，AI 工具按指定应用授权范围访问和操作 HAP 数据，需要选择应用和授权密钥。

  个人访问令牌和应用授权密钥的创建、管理方式，请参考访问令牌。

• 4. 安装配套 Skills：根据需要可勾选【同时安装配套 Skills】。Skills 可以帮助 AI 工具更准确地理解 HAP 的产品概念和操作方式。

• 5. 完成安装：系统会根据前面的选择生成对应安装内容。

  • 选择【对话安装】时，点击【安装】打开目标 AI 工具并自动填入安装提示词，确认并执行安装。也可以复制页面中提供的安装提示词到 AI 工具的对话框中，并按提示完成安装。
  • 选择【手动安装】时，复制页面中提供的安装命令到终端中运行，并按终端提示完成安装。

📖 详细了解 MCP 协议原理、演进对比及使用场景，请参考 MCP Server 详解

CLI

CLI 是 HAP 提供的命令行工具，可通过终端命令直接调用 HAP 能力，适合在本地终端、服务器脚本或自动化脚本中进行批量、可重复的操作。

相比 MCP 的对话式实时操作，CLI 更适合开发者或自动化场景使用。CLI 可覆盖应用、工作表、工作流、审批、通讯录、日程、群聊等多类场景。

前置条件：CLI 访问受组织级策略控制。若该功能未开启，需由组织管理员在【组织管理】>【数据与访问】中开启 CLI 访问策略后方可使用。

连接步骤：

• 1. 选择安装方式：CLI 支持对话安装和手动安装。

• 2. 选择连接工具：选择需要连接的 AI Agent 工具。系统会根据所选工具生成对应的安装内容。若列表中没有对应工具，可选择【其他】。

• 3. 确认是否同时安装配套Skills

• 4. 完成安装：系统会根据前面的选择生成对应安装内容。

  • 选择【对话安装】时，点击【安装】打开目标 AI 工具并自动填入安装提示词，确认并执行安装。也可以复制页面中提供的安装提示词到 AI 工具的对话框中，并按提示完成安装。
  • 选择【手动安装】时，复制页面中提供的安装命令到终端中运行，并按终端提示完成安装。

使用 CLI：安装完成后，可直接在终端中使用命令调用 HAP 能力，也可以配合 Skills，由 AI Agent 通过自然语言驱动 CLI 完成任务。

📖 完整 CLI 安装、登录、命令参考及示例，请参考 CLI 使用帮助

Skills

Skills 是为 AI 提供的“操作 HAP 的专业技能”。安装后，AI 可以更准确地理解如何调用 HAP，包括该使用哪个能力、参数如何传递，以及在删除、修改等高风险操作前如何确认，从而更精准、更可靠地完成建应用、改应用、查数据等任务。

支持的 Skills：

• MCP 技能（智能搭建应用）：基于 MCP 服务，让 AI Agent 可以直接操作 HAP。适用于智能搭建应用、配置 MCP 服务等场景。使用前需先完成 MCP 服务配置。安装完成后，用户可以在本地 AI 客户端实现和线上 Mingo 应用搭建完全一致的整个搭建流程。

• CLI 技能（命令行操作）：基于 HAP CLI，让 AI 可以在终端或脚本中直接操作 HAP。适用于建应用、改应用、查数据、多环境管理等场景。使用前需先安装并登录 CLI。

• API 技能（接口开发）：基于 HAP V3 API，适合面向应用的二次开发。适用于 API 数据开发、视图插件开发、前端项目搭建等场景。使用前需先完成 API 鉴权配置。

安装方式：

进入【连接 AI】>【Skills】，选择需要安装的 Skills，点击【安装】，并按页面提示完成安装。手动安装模式，直接复制命令到终端执行安装。

如果在 MCP 或 CLI 安装时已勾选【同时安装配套 Skills】，通常无需重复安装。

全部的 HAP 的 Skills 集合。请参考HAP-SKills

访问凭证

访问凭证用于确认外部 AI 工具连接 HAP 时使用的身份和权限范围。根据权限范围不同，可使用个人访问令牌或应用授权密钥。

个人访问令牌

个人访问令牌代表当前用户身份，适合按个人权限连接 HAP。

前置条件：使用个人访问令牌或应用授权密钥前，需确认组织管理中分别开启了API 访问策略-个人访问令牌

操作入口：点击头像 >【管理我的账户】>【个人访问令牌】，点击【添加】按钮。

创建个人访问令牌时，需要设置名称、有效期、组织、应用范围和接口范围。

如果需要选择指定应用，需先选择应用所在的组织

创建完成后，即可在 MCP 配置的【个人】权限中选择该令牌。

更多接口说明，请参考 PAT 接口文档。

应用授权密钥

应用授权密钥代表应用授权身份，适合按应用范围连接 HAP。

操作入口：进入应用的API开发文档页面，在【应用授权】中点击【新建授权密钥】。

创建应用授权密钥后，即可在 MCP 配置的【应用】权限中选择对应应用和授权密钥。