开发必读

文档说明

面向企享云合作客户、技术对接人员、业务运营人员，清晰区分API、SDK、MCP、Skills四大对接形态，帮助客户根据自身业务系统、技术架构、使用场景快速选择最优对接方案。

API/SDK 是传统系统集成基础，MCP 是面向大模型 / AI 智能体的标准化连接协议，Skills 是封装完整业务流程的 AI 可复用技能模块；MCP 与 Skills 专为AI 原生场景设计，API/SDK 偏向传统业务系统集成。

开通流程

API、SDK、MCP 三种接入方式均需先走线下商务签约流程，通过企享云开放平台注册和认证成功后，创建Appkey鉴权凭证并联系我们开通产品权限，方可发起接口正常调用；

Skills 无需走线下签约流程，用户可自行在技能市场完成安装操作，登录企享云开放平台就能自助完成权限开通，快速启用对应技能。

四种对接方式

对接方式	核心定位	底层协议/形态	方案优劣总结
API	通用HTTP接口，原子化业务能力调用	HTTP/HTTPS REST接口	通用性强、自由度极高，可自主编排业务流程；需自行处理签名、请求封装，代码量大，适配各类传统业务系统
SDK	API的语言封装包，简化代码开发	基于API封装（仅提供Java语言）	完全复用API全部能力，屏蔽网络层底层细节，开发代码精简；受编程语言约束，灵活性略低于原生API
MCP（Model Context Protocol）	大模型上下文协议，AI通用连接网关	JSON-RPC 2.0，长连接/流式连接	AI生态标准协议，可通过模型精细调度单项能力；仅适配AI载体；调用过程会产生模型token消耗，企享云不提供token服务
Skills	AI智能体可复用业务技能，全流程编排模块	基于MCP/API封装的流程单元，SkillHub分发	零代码开箱即用，内置完整业务闭环，落地速度极快；流程标准化固化，无法自定义底层调用步骤，调用过程会产生模型token消耗

选型流程

接入指引

API 接入指引
申请企享云开发者账号，获取 AppKey、AppSecret；
查阅官方 API 文档：https://www.qixiangyun.com/
按照接口规范组装请求、处理签名，调试单接口能力；
上线部署，配置异常重试、日志监控。

SDK 接入指引
查阅官方 SDK 集成文档：https://openapi.qixiangyun.com/doc-2180025
下载对应技术栈 SDK 包，引入项目；
初始化 SDK 并填入鉴权信息；
调用封装好的函数实现业务能力，无需处理 HTTP 底层逻辑。

MCP 接入指引
确认自身 AI 客户端支持 MCP 协议（Claude、Cursor、Windsurf 等均兼容）；
获取 MCP 服务地址、AppKey、Secret，在本地创建.env配置文件；
MCP 集成说明文档：https://openapi.qixiangyun.com/doc-7603877
连接 MCP 网关：https://mcp.qixiangyun.com/
选择所需 MCP 服务（登录、开票、申报等），完成调用调试。

Skills 接入指引
进入 SkillHub 技能市场：https://skillhub.cn/skills?keyword=企享云
搜索所需企享云技能（发票验真、税务申报等）；
点击安装，按引导完成 API Key 配置；
在 AI 智能体中下达自然语言指令，直接触发技能执行。

常见问题答疑

Q：已经在用 API 对接传统系统，能否切换为 MCP？
A：不建议直接切换。MCP 仅适配 AI 类载体，传统系统无 MCP 协议解析能力；若后续新增 AI 模块，可API（传统系统）+ MCP（AI 模块）双方案并行。

Q：Skills 和 MCP 必须搭配使用吗？
A：非强制。纯轻量化 AI 场景可单独使用 Skills；需要自定义 AI 流程可单独使用 MCP；中大型 AI 财税平台推荐二者组合。

Q：SDK 和 API 功能有区别吗？
A：功能完全一致，SDK 是 API 的封装，仅优化开发体验，能力无增减。

Q：开发验证和内部数字员工搭建，适合哪种方式？
A：优先选择Skills，零代码配置，依托 AI 智能体即可实现发票查验、报税、风控等自动化，无需开发。

文档说明#

开通流程#

四种对接方式#

选型流程#