> ## Documentation Index
> Fetch the complete documentation index at: https://docs.xkat.space/llms.txt
> Use this file to discover all available pages before exploring further.

# MCP AI 智能体集成

> 通过 Claude、Cursor、Antigravity 等 AI 智能体即时生成实操指南并导入账户。

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

## 核心工作流

<Steps>
  <Step title="获取个人访问令牌并连接">
    在 [设置 → AI 令牌](https://xkat.space/zh/settings/ai-tokens) 中发放访问令牌，然后在智能体配置文件中注册远程 MCP 端点（`https://mcp.xkat.space/mcp`）。
  </Step>

  <Step title="向 AI 智能体发送提示">
    像平时一样提问：*“为 QEMU 创建一个 Debian 12 安装实操指南。”*
  </Step>

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

  <Step title="即时导入与获取播放器链接">
    智能体调用 `import_draft_guide` 将课程直接保存为账户下的私有草稿，并返回播放器直达链接（`https://xkat.space/zh/player/<id>`）。
  </Step>
</Steps>

## 客户端配置

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

<Tabs>
  <Tab title="Claude Code (.mcp.json)">
    ```json theme={null}
    {
      "mcpServers": {
        "xkat": {
          "type": "http",
          "url": "https://mcp.xkat.space/mcp",
          "headers": {
            "Authorization": "Bearer <YOUR_TOKEN>"
          }
        }
      }
    }
    ```
  </Tab>

  <Tab title="Cursor (.cursor/mcp.json)">
    ```json theme={null}
    {
      "mcpServers": {
        "xkat": {
          "url": "https://mcp.xkat.space/mcp",
          "headers": {
            "Authorization": "Bearer <YOUR_TOKEN>"
          }
        }
      }
    }
    ```
  </Tab>

  <Tab title="Antigravity (mcp_config.json)">
    ```json theme={null}
    {
      "mcpServers": {
        "xkat": {
          "serverUrl": "https://mcp.xkat.space/mcp",
          "headers": {
            "Authorization": "Bearer <YOUR_TOKEN>"
          }
        }
      }
    }
    ```
  </Tab>
</Tabs>

## 可用 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** — 无限制。

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


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.