Claude Code 通过 MCP 连接 BeeOS。Skill 是可选的行为说明层:它告诉 Claude 何时、如何使用 BeeOS 工具,但不承载网络流量,也不替代 MCP 鉴权。
添加 MCP Server
在远程 Streamable HTTP 地址中使用 BeeOS Agent ID:
在 Claude Code 中运行 /mcp 并完成浏览器 OAuth。CI 或非交互环境可使用受限 API Key:
Shell 展开可能把真实 Key 写入 Claude Code 配置。开发机优先使用 OAuth,自动化环境应通过密钥管理器注入。
验证连接:
随后先执行低风险任务,例如:“使用 BeeOS 设备工具读取电池状态。”Claude 会通过 tools/list 发现工具,再通过 tools/call 调用。
添加 Skill
项目 Skill 可以固化安全与验证规则:
Skill 控制模型行为;MCP Server 仍负责工具 schema、执行和结果。不要把凭证放进 SKILL.md。
团队配置
只有整个项目团队都应看到该 Server 定义时才使用 project scope:
Claude Code 会写入 .mcp.json,并要求每位用户批准。只提交 endpoint,每位用户使用自己的 BeeOS 身份授权。
参见 MCP 鉴权和 Claude Code MCP 官方文档。