跳转到主要内容

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.

Cyberun 暴露了一个 模型上下文协议（MCP）端点，使外部 AI 客户端 —— Claude Code、Cursor、Windsurf、Codex CLI、 Claude Desktop、VS Code 1.101+ —— 可以连接到你的团队并将 平台操作作为 MCP 工具调用。 本页是 Cloud 侧”作为用户我该做什么”的操作指引。 完整的参考 —— 逐客户端配置片段、完整的工具目录、错误信封 —— 位于 MCP → Cloud MCP。

​
你需要什么

  1. 一个集成凭证（sk-...），用于你希望 AI 客户端驱动的团队。 在 访问 → 集成 中创建一个 —— 见 生成 API 密钥。
  2. 一个支持 MCP 的 AI 客户端。 Claude Code、Claude Desktop、Cursor、 Windsurf、Codex CLI 和 VS Code 1.101+ 都支持 Cyberun MCP 端点所使用的 Streamable HTTP 传输。
如果 访问 → 集成 区域没有把 MCP 显示为你团队的可选项， 说明此部署没有启用基于 MCP 的集成 —— 请联系你的团队管理员。

​
端点

https://core.cyberun.cloud/api/v1/mcp
使用 sk- 密钥作为 Bearer 令牌进行身份验证。团队已与凭证绑定； 无需其他请求头。

​
配置你的 AI 客户端

具体的配置形式因客户端而异（配置文件路径、顶层键名、 传输提示）。同一个 URL 和同一个 Bearer 请求头对每个客户端都适用。 选择你的客户端并复制片段： → Cloud MCP → 连接 中提供 每个客户端的经过验证的最新片段：Claude Code（CLI）、 Claude Desktop / Code（配置文件）、Cursor、VS Code 1.101+、 Codex CLI 和 Windsurf（通过 mcp-remote 桥接）。 编辑配置后请重启客户端。Cyberun 工具会出现在工具选择器中。

​
客户端能做什么

连接后，客户端会列出 15 个工具，覆盖对你团队的读写操作：
  • 列出并查看工作流。
  • 列出团队的代理与已连接的容器服务。
  • 针对某个工作流提交任务。
  • 流式获取任务进度并拉取结果工件。
  • 取消一个运行中的任务。
那些会变更团队级资源（签发凭证、添加成员）的工具 不会通过 MCP 暴露 —— 这些操作需要通过控制台或直接 API 访问。 完整的工具参考、输入与输出位于 MCP → Cloud MCP → 工具。

​
帮助 AI 代理用好它

如果你从 AI 代理驱动 Cyberun，请安装 Cyberun skill（仅英文），这样代理无需你反复解释就能知道 API 和 MCP 的布局： 
npx skills add cyberun-cloud/skills
skill 会告诉代理有哪些工具、如何身份验证、 何时该用流式而不是轮询，以及需要避免的常见错误。

​
撤销 MCP 客户端的访问权限

当某个客户端不应再驱动你的团队时 —— 笔记本丢失、密钥怀疑泄露、 合作结束 —— 请撤销凭证：
  1. 在 Cloud 中，打开 访问 → 集成。
  2. 通过名称找到该凭证（创建后不会再显示完整的密钥值）。
  3. 点击 撤销。
MCP 连接下一次调用时会返回 401。客户端 应提示用户输入新的凭证。

​
故障排查

客户端没有列出 Cyberun 工具。 此部署没有启用 MCP —— 此时 访问 页面不会显示 MCP 入口。请联系你的团队管理员。 立即返回 401。 sk- 密钥错误、已撤销或已过期。 在 访问 → 集成 中创建一个新的。 工具列表为空。 凭证有效，但团队还没有任何工作流。 请先在 Cloud 中添加一个。 客户端在长任务上挂起。 Streamable HTTP 会逐步推送进度 事件。如果你的客户端没有渲染它们，任务仍在运行 —— 可在 app.cyberun.cloud/tasks 查看。 更多内容见 MCP → Cloud MCP。

​
相关