跳转到主要内容

Documentation Index

Fetch the complete documentation index at: https://docs.cyberun.cloud/llms.txt

Use this file to discover all available pages before exploring further.

模型上下文协议(MCP)是外部 AI 代理发现并调用 Cyberun 运行时的方式:列出工作流、提交任务、观察进度、获取结果、取消运行。Cyberun 提供一个云端 MCP 服务器,使用官方的 Streamable HTTP 传输,开箱即用地兼容所有主流 MCP 客户端。

Cloud MCP

托管在 core.cyberun.cloud/api/v1/mcp。15 个工具封装团队的完整运行时 API。用集成密钥(sk-)进行身份验证。任意位置使用。

AI 技能

一行 shell 命令(npx skills add cyberun-cloud/skills)教会 Claude Code、Cursor、Windsurf、Codex CLI 或任意支持技能的代理如何使用 Cyberun,无需你反复解释。(仅英文)

API 参考

MCP 封装的 HTTP 接口。当你需要某个 MCP 未暴露的操作,或你不在 MCP 环境中时使用。

​
何时使用 MCP

你想要……用
让 AI 工具从任意机器驱动工作流Cloud MCP
长时间会话、多次小操作Cloud MCP
不通过 MCP 客户端的程序化访问REST API

​
标准合规

该服务器实现官方的模型上下文协议规范。它使用 MCP 2025-03-26 及之后版本(包括 2025-06-18+ 所需的 MCP-Protocol-Version 请求头)定义的 Streamable HTTP,在 Authorization: Bearer … 上使用 Bearer 令牌身份验证,以 isError: true 的 CallToolResult 形式呈现工具错误,并为长时间运行的工具发出 notifications/progress。 已验证兼容的客户端:
  • Claude Code(CLI 与 IDE)
  • Claude Desktop
  • Cursor
  • Windsurf
  • VS Code 1.101 及以后(原生 HTTP MCP)
  • Codex CLI
  • 通过 mcp-remote 支持传统 stdio 路径的任意客户端

​
通过 MCP 能做什么

共同的工作流操作有:
  • 列出工作流 —— 团队发布的工作流。
  • 提交工作流 —— 带参数;收到 task_id。
  • 流式接收任务进度直到终态,沿途带 MCP notifications/progress 事件。
  • 获取结果 —— 输出元数据加签名下载 URL。
  • 取消任务 —— 尚未完成的任务。
  • 列出团队代理并查看哪些空闲。
Cloud MCP 额外暴露容器服务检查、工作流输入的文件预签名,以及按 slug 查找工作流。 完整的工具清单及输入 schema 详见 Cloud MCP → 工具。

​
身份验证(简版)

  • Cloud MCP:Authorization: Bearer sk-... —— 由 Cyberun Cloud 的访问设置签发的集成凭证。团队范围已烘焙进密钥;MCP 请求不需要 X-Team-ID 请求头。
完整的鉴权细节在该服务器的页面上。

​
下一步

连接 Cloud MCP

端点、鉴权、每个工具、各客户端的安装片段。

安装 AI 技能

一行命令教会代理 API + MCP 布局。(仅英文)

MCP 规范

关于协议本身的背景资料。