开发者接入总览与开放边界
了解第三方应用、MCP、业务 API 和应用协议的接入路径及当前状态。
按目标选择接入层
第三方应用把业务能力带入工作空间;MCP 将外部工具和资源提供给执行器;业务 API 让外部系统交换项目与任务数据;应用描述协议把已批准的数据呈现为工作应用。先确定数据方向和操作副作用,再选择协议。
| 接入层 | 当前说明 | 使用前提 |
|---|---|---|
| 第三方连接 | 有连接目录与供应商配置实现;按连接验证 | 部署配置、账号授权与最小调用验收 |
| MCP 工具 | 有 stdio / HTTP 配置与运行实现参照 | 兼容服务、受信任运行环境及工具授权 |
| 业务 REST API | 公开设计草案,未确认通用开发者服务上线 | 另行提供服务地址、身份方案与联调环境 |
| 应用描述协议 | 当前受约束 JSON 结构的实现参照 | 运行时支持、数据源授权与发布流程验证 |
| Webhook 事件 | 投递与签名设计草案 | 实现订阅、密钥管理与重试服务 |
接入前的最小资料包
准备应用名称、维护者、用途、测试账号、数据字段、读写范围、网络地址、认证方式、预计调用量和故障联系人。明确个人账号还是组织账号、数据是否进入外部模型、是否允许长期保存,以及停用后如何清理。
开发、测试与发布分开
先用脱敏数据和独立凭据完成联调,再验证允许、拒绝、撤销、超时和重试。发布需指定兼容版本、连接负责人、用量限制、监控和回退方案。开发环境通过后,还需在目标部署确认网络与真实账号权限。
协议版本和兼容性
草案在正式冻结前可能调整。已签约接入的协议版本、字段、错误、限流和升级窗口在项目文件中固定;破坏性变更使用新版本并提供迁移说明。新增字段能否忽略由具体协议决定,例如当前应用 manifest 是封闭结构,会拒绝未知字段。
授权、许可与成果归属
接入方应有权使用接口、账号、数据和依赖组件。公开协议文本不会授予第三方商标、源码或业务数据权利;SDK、示例代码及定制适配器如需分发,应明确各自许可。客户专有逻辑、通用连接能力和维护责任在实施协议中分别确认。
选择下一份接入指南
从一个只读接口或工具开始,完成一条可复现链路后再讨论写回与事件订阅。需要工程支持时,可将适配、联调与移交列入 FDE 工作范围。