> ## 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 连接工具

> 让 Claude Code、Cursor、Windsurf 或任意 MCP 客户端驱动团队的 Cyberun 工作流。

Cyberun 暴露了一个 **模型上下文协议**（MCP）端点，使外部
AI 客户端 —— Claude Code、Cursor、Windsurf、Codex CLI、
Claude Desktop、VS Code 1.101+ —— 可以连接到你的团队并将
平台操作作为 MCP 工具调用。

本页是 Cloud 侧"作为用户我该做什么"的操作指引。
完整的参考 —— 逐客户端配置片段、完整的工具目录、错误信封 ——
位于 **[MCP → Cloud MCP](/zh/mcp/cloud)**。

## 你需要什么

1. **一个集成凭证**（`sk-...`），用于你希望 AI 客户端驱动的团队。
   在 **访问 → 集成** 中创建一个 ——
   见 [生成 API 密钥](/zh/cloud/guides/api-key)。
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 → 连接](/zh/mcp/cloud#连接)** 中提供
每个客户端的经过验证的最新片段：Claude Code（CLI）、
Claude Desktop / Code（配置文件）、Cursor、VS Code 1.101+、
Codex CLI 和 Windsurf（通过 `mcp-remote` 桥接）。

编辑配置后请重启客户端。Cyberun 工具会出现在工具选择器中。

## 客户端能做什么

连接后，客户端会列出 15 个工具，覆盖对你团队的读写操作：

* 列出并查看工作流。
* 列出团队的代理与已连接的容器服务。
* 针对某个工作流提交任务。
* 流式获取任务进度并拉取结果工件。
* 取消一个运行中的任务。

那些会变更团队级资源（签发凭证、添加成员）的工具
不会通过 MCP 暴露 —— 这些操作需要通过控制台或直接 API 访问。

完整的工具参考、输入与输出位于
**[MCP → Cloud MCP → 工具](/zh/mcp/cloud#工具)**。

## 帮助 AI 代理用好它

如果你从 AI 代理驱动 Cyberun，请安装
[Cyberun skill](/skill)（仅英文），这样代理无需你反复解释就能知道 API 和 MCP 的布局：

```bash theme={null}
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](/zh/mcp/cloud)。

## 相关

* [凭证](/zh/cloud/concepts/credentials) —— `sk-` 系列。
* [生成 API 密钥](/zh/cloud/guides/api-key) —— 如何创建一个。
* [MCP → Cloud MCP](/zh/mcp/cloud) —— 完整参考、全部客户端、全部
  工具。
* [Cyberun skill](/skill)(仅英文)—— 安装代理侧的速查手册。