文档开发者接入

开发者接入总览与开放边界

了解第三方应用、MCP、业务 API 和应用协议的接入路径及当前状态。

按目标选择接入层

第三方应用把业务能力带入工作空间;MCP 将外部工具和资源提供给执行器;业务 API 让外部系统交换项目与任务数据;应用描述协议把已批准的数据呈现为工作应用。先确定数据方向和操作副作用,再选择协议。

接入层与开放状态
接入层当前说明使用前提
第三方连接有连接目录与供应商配置实现;按连接验证部署配置、账号授权与最小调用验收
MCP 工具有 stdio / HTTP 配置与运行实现参照兼容服务、受信任运行环境及工具授权
业务 REST API公开设计草案,未确认通用开发者服务上线另行提供服务地址、身份方案与联调环境
应用描述协议当前受约束 JSON 结构的实现参照运行时支持、数据源授权与发布流程验证
Webhook 事件投递与签名设计草案实现订阅、密钥管理与重试服务

接入前的最小资料包

准备应用名称、维护者、用途、测试账号、数据字段、读写范围、网络地址、认证方式、预计调用量和故障联系人。明确个人账号还是组织账号、数据是否进入外部模型、是否允许长期保存,以及停用后如何清理。

开发、测试与发布分开

先用脱敏数据和独立凭据完成联调,再验证允许、拒绝、撤销、超时和重试。发布需指定兼容版本、连接负责人、用量限制、监控和回退方案。开发环境通过后,还需在目标部署确认网络与真实账号权限。

协议版本和兼容性

草案在正式冻结前可能调整。已签约接入的协议版本、字段、错误、限流和升级窗口在项目文件中固定;破坏性变更使用新版本并提供迁移说明。新增字段能否忽略由具体协议决定,例如当前应用 manifest 是封闭结构,会拒绝未知字段。

授权、许可与成果归属

接入方应有权使用接口、账号、数据和依赖组件。公开协议文本不会授予第三方商标、源码或业务数据权利;SDK、示例代码及定制适配器如需分发,应明确各自许可。客户专有逻辑、通用连接能力和维护责任在实施协议中分别确认。

选择下一份接入指南

从一个只读接口或工具开始,完成一条可复现链路后再讨论写回与事件订阅。需要工程支持时,可将适配、联调与移交列入 FDE 工作范围。

返回全部文档下一篇指南

还有疑问?

查看专家支持