> ## 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

> Cloud MCP 服务器让任意 AI 客户端端到端驱动 Cyberun。

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

<CardGroup cols={2}>
  <Card title="Cloud MCP" icon="cloud" href="/zh/mcp/cloud">
    托管在 `core.cyberun.cloud/api/v1/mcp`。15 个工具封装团队的完整运行时 API。用集成密钥(`sk-`)进行身份验证。任意位置使用。
  </Card>

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

  <Card title="API 参考" icon="terminal" href="/zh/api-reference/introduction">
    MCP 封装的 HTTP 接口。当你需要某个 MCP 未暴露的操作,或你不在 MCP 环境中时使用。
  </Card>
</CardGroup>

## 何时使用 MCP

| 你想要……             | 用                                          |
| ----------------- | ------------------------------------------ |
| 让 AI 工具从任意机器驱动工作流 | [Cloud MCP](/zh/mcp/cloud)                 |
| 长时间会话、多次小操作       | [Cloud MCP](/zh/mcp/cloud)                 |
| 不通过 MCP 客户端的程序化访问 | [REST API](/zh/api-reference/introduction) |

## 标准合规

该服务器实现官方的模型上下文协议规范。它使用 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`](https://www.npmjs.com/package/mcp-remote) 支持传统 stdio 路径的任意客户端

## 通过 MCP 能做什么

共同的工作流操作有:

* **列出工作流** —— 团队发布的工作流。
* **提交工作流** —— 带参数;收到 `task_id`。
* **流式接收任务进度**直到终态,沿途带 MCP `notifications/progress` 事件。
* **获取结果** —— 输出元数据加签名下载 URL。
* **取消任务** —— 尚未完成的任务。
* **列出团队代理**并查看哪些空闲。

Cloud MCP 额外暴露容器服务检查、工作流输入的文件预签名,以及按 slug 查找工作流。

完整的工具清单及输入 schema 详见 [Cloud MCP → 工具](/zh/mcp/cloud#工具)。

## 身份验证(简版)

* **Cloud MCP**:`Authorization: Bearer sk-...` —— 由 Cyberun Cloud 的访问设置签发的集成凭证。团队范围已烘焙进密钥;MCP 请求不需要 `X-Team-ID` 请求头。

完整的鉴权细节在该服务器的页面上。

## 下一步

<CardGroup cols={2}>
  <Card title="连接 Cloud MCP" icon="cloud" href="/zh/mcp/cloud">
    端点、鉴权、每个工具、各客户端的安装片段。
  </Card>

  <Card title="安装 AI 技能" icon="sparkles" href="/skill">
    一行命令教会代理 API + MCP 布局。(仅英文)
  </Card>

  <Card title="MCP 规范" icon="book" href="https://modelcontextprotocol.io">
    关于协议本身的背景资料。
  </Card>
</CardGroup>