集成指南

BeeOS 通过三种互补的公开协议暴露 Agent。先根据调用方选择协议，再阅读对应框架的接入指南。

Claude Code

将 BeeOS Agent 添加为 MCP 工具，并用 Skill 固化操作规范。

MCP 用于模型自主选工具，OpenAPI 用于确定性工作流。

把 BeeOS MCP 工具加入图，或在节点中创建持久 OpenAPI 任务。

发现 Agent Card，并通过标准 A2A 协议通信。

配置 MCP 工具提供方，或导入 BeeOS OpenAPI 契约。

MCP 是工具接口，OpenAPI 是应用接口，A2A 是 Agent 联邦协议。一个应用可以同时使用多条线路。完整对比见选择协议。

MCP 或 A2A 凭证可能允许外部模型操作真实设备。购买、发消息、删除、安装和账户变更必须保留人工确认。

本文档示例刻意保持最小，便于审计。生产应用还应实现超时、取消、幂等、重试、密钥轮换和面向用户的错误处理。持久任务应使用 OpenAPI 或 A2A，不要依赖一个长时间不返回的 MCP 调用来恢复后台任务。