MCP AI 智能体集成

将外部 AI 智能体（Claude Code、Cursor、Antigravity 及其他支持 Model Context Protocol 的工具）连接到 xkat。仅需一句自然语言提示，AI 智能体即可发现可用的实验环境，依照特定领域规范编写实操指南，并直接作为私有草稿导入您的账户。

核心工作流

获取个人访问令牌并连接

在设置 → AI 令牌中发放访问令牌，然后在智能体配置文件中注册远程 MCP 端点（https://mcp.xkat.space/mcp）。

向 AI 智能体发送提示

像平时一样提问：“为 QEMU 创建一个 Debian 12 安装实操指南。”

环境发现与指南生成

智能体调用 list_lab_profiles 与 get_guide_spec 查询支持的环境（debian_qemu）与编写规范（单卡单命令、Mermaid 图表、隐藏平台底层管道），并生成指南。

即时导入与获取播放器链接

智能体调用 import_draft_guide 将课程直接保存为账户下的私有草稿，并返回播放器直达链接（https://xkat.space/zh/player/<id>）。

客户端配置

在常用 AI 工具的配置文件中添加 xkat MCP 服务器：

Claude Code (.mcp.json)
Cursor (.cursor/mcp.json)
Antigravity (mcp_config.json)

{
  "mcpServers": {
    "xkat": {
      "type": "http",
      "url": "https://mcp.xkat.space/mcp",
      "headers": {
        "Authorization": "Bearer <YOUR_TOKEN>"
      }
    }
  }
}

{
  "mcpServers": {
    "xkat": {
      "url": "https://mcp.xkat.space/mcp",
      "headers": {
        "Authorization": "Bearer <YOUR_TOKEN>"
      }
    }
  }
}

{
  "mcpServers": {
    "xkat": {
      "serverUrl": "https://mcp.xkat.space/mcp",
      "headers": {
        "Authorization": "Bearer <YOUR_TOKEN>"
      }
    }
  }
}

可用 MCP 工具

工具	说明
`import_draft_guide`	验证并将指南（XML/YAML/JSON）作为私有草稿直接保存到账户中，返回播放器链接。
`get_guide_spec`	返回操作系统安装（`os-install`）、Linux CLI（`linux-cli`）等领域的编写规范。
`list_plugins`	查询可用的查看器插件列表（`desktop-viewer`、`linux-wasix` 等）。
`list_lab_profiles`	查询支持的实验运行环境（`debian_qemu`、`ubuntu_qemu` 等）。
`validate_course`	验证课程结构与 XML Schema，不写入数据库。
`build_course`	验证课程内容并返回规范化 XML，不写入数据库。

公开资源

资源 URI	说明
`catalog://plugins`	查看器插件及运行功能目录。
`catalog://lab-profiles`	可用实验环境及虚拟机/容器目录。
`spec://os-install`	客户机系统安装指南规范及操作徽章规则。
`schema://course`	描述有效课程文件的 JSON Schema。
`template://sample-course`	供智能体学习参考的 YAML 示例课程模板。

导入限额与说明

通过 import_draft_guide 导入会消耗您会员等级的月度导入限额：

Free — 不支持 MCP 导入（仍可进行验证与构建）。
Basic — 每月 5 次。
Pro — 每月 10 次。
Creator — 无限制。

通过 MCP 导入的指南默认保存为 isPublished: false（私有草稿），在您于 Studio 中审核并正式发布前不会对外公开。

工作室基础

用 AI 创作

设计与验证

发布与盈利

MCP AI 智能体集成

核心工作流

客户端配置

可用 MCP 工具

公开资源

导入限额与说明

​核心工作流

​客户端配置

​可用 MCP 工具

​公开资源

​导入限额与说明

核心工作流

客户端配置

可用 MCP 工具

公开资源

导入限额与说明