一、业务痛点
- 系统对接难度高：AI 智能体对接 ERP 时，协议适配复杂，技术门槛高，落地受阻；
- 开发工作繁琐：调用业务接口做系统集成，需要反复调试代码、调整签名算法，耗时耗力，开发效率低下；
- 缺乏标准工具：想要实现研发流水线自动化，暂无官方标准化工具支撑，流程难以落地。
二、功能介绍
吉客开放平台推出MCP 服务 + CLI 命令行工具两款配套产品，专门面向企业开发者、AI 智能化应用场景打造，直击上述痛点，简化业务集成流程，实现高效开发与落地。
（一）MCP 服务：面向 AI 智能体，实现与吉客云业务快速对接、即插即用
- 采用标准化协议+ 安全 Token 授权机制，对接规范、安全性强；
- 支持主流 AI 平台适配，兼容性广；
- 提供业务工具订阅能力，按需订阅即可使用；
- 能力覆盖吉客云订单、库存、采购、基础档案等全核心业务，可让各类 AI 智能体无缝直连业务系统。
（二）CLI 命令行工具：面向研发运维场景，提升接口调用、流水线自动化效率
- 跨平台适配：全面支持 Windows、Mac、Linux 系统；
- 轻量化部署：单文件形式、无依赖、免安装，使用便捷；
- 内置自动签名能力，省去手动调整、反复调试签名的操作；
- 支持多种入参模式，适配本地调试、接口批量调用等场景；
- 兼容 CI/CD 自动化流水线，为研发自动化提供标准支撑。
三、操作步骤
（一）吉客云MCP-SERVER 客户端配置说明（以Dify为例）
1. 前置条件准备
在开始配置吉客云MCP服务前，请确保已准备好以下内容：
- 吉客云MCP服务的Token
- AI工具客户端
- MCP服务访问地址：https://mcp.open.jackyun.com/mcp/messages
2. 授权MCP服务
首先登录吉客云开放平台官网进入控制台界面，在左侧导航栏选择MCP授权管理
选择需要授权的应用点击授权MCP，弹窗确认后点击查看授权详情，获取吉客云MCP服务的token
3. 订阅工具
进入MCP服务页面，点击工具列表，进入工具清单界面，选择需要的工具订阅工具按钮
支持批量订阅
订阅工具完成后即可在AI客户端中使用吉客云的MCP服务
4. 在Dify中添加MCP服务器
在工作空间点击工具，然后选择MCP
点击添加 MCP 服务器 (HTTP)：
注:请求头值中不需要添加Bearer，直接填入吉客云开放平台token即可
- 服务端点URL：MCP 服务器的地址(https://mcp.open.jackyun.com/mcp/messages)
- 名称和图标：命名一个名称
- 服务器标识符：唯一标识符（小写字母、数字、下划线、连字符，最多 24 个字符）
- 请求头：名称为Authorization，值为吉客云MCP服务的token
添加完成后点击保存
5. 在Dify中授权工具列表
服务器配置好后点击授权工具列表 即可使用开放平台授权的工具
进入工作室中，选择创建空白应用
创建好应用后，配置好对应模型，在工具中添加吉客云开放平台的工具
添加后即可通过Agent调用吉客云开放平台MCP服务
（二）吉客云CLI
1. 安装与配置
（1）下载CLI文件：访问吉客云开放平台，下载对应操作系统（Windows / Mac / Linux）的二进制文件。
以Windows为例：将下载的文件重命名“jky-cli.exe”，并放入系统 PATH 目录（右击“此电脑” → 属性 → 高级系统设置 → 环境变量）。
（2）配置凭证：打开命令行终端，执行命令（./jky-cli configure）
根据提示依次输入您的 Appkey 和 AppSecret（凭证将存入系统安全存储)。
（3）验证安装：（./jky-cli --version）若正确显示版本信息，说明安装配置成功。
2. 调用开放平台API（通用模式）
使用 api call 命令调用任意接口，自动完成签名。
示例：查询商品信息 （./jky-cli api call --method erp-goods.goods.getforqimen --json '{"goodsCode":"100","pageIndex":0,"pageSize":10}'）
--method：接口方法名
--json：业务参数（JSON字符串）
3. 使用业务命令（以货品查询为例）
CLI提供了更直观的业务命令，无需记忆方法名和JSON格式。
示例：查询货品（./jky-cli goods search --goodsno 100）
参数说明：--goodsno 为货品编号，可按需修改。
按照以上三步，您即可快速完成吉客云CLI的安装配置，可集成到AI智能体。如有任何问题，可查阅对应命令的 --help 帮助信息。
