AI Agent/MCP

太一云 v0.12.0 起内置了 AI 能力支持，提供两种使用方式：AI 助理（直接在平台内通过对话管理云资源）和 MCP 服务（让 Claude Code、Cursor 等外部 AI Agent 直接连接并控制平台）。

AI 助理

AI 助理是太一云平台内置的对话式运维工具，启用后可通过自然语言指令完成建机、启停、扩容、迁移、快照、镜像与 ISO 管理、监控查询等全部日常运维操作，无需登录控制台手动操作。

配置 AI 助理

进入「系统设置」>「AI 助理」，填写以下信息并保存：

• 启用 AI 助理：开启开关
• 供应商：选择 AI 提供商（推荐 DeepSeek，性价比高，支持思考模式）
• Base URL（可选）：如需使用中转站，填写自定义接口地址
• API Key：填写对应供应商的 API 密钥
• 默认模型：推荐 deepseek-v4-pro 或 deepseek-v4-flash

填写完成后，点击「测试连接」验证配置，确认无误后点击「保存」。

使用 AI 助理

配置完成后，点击顶部导航栏的「AI 助理」进入对话界面。AI 助理已自动连接平台 MCP，无需额外配置，可直接发送指令，例如：

• 目前云主机运行情况如何
• 帮我在默认资源池里开一台 4 核 8G 的 Ubuntu 云主机
• 删除昨天创建并且不在运行中的云主机

---

MCP 服务

太一云内置 MCP（Model Context Protocol）服务，让 Claude Code、Cursor、Claude Desktop、OpenClaw、Hermes 等支持 MCP 的 AI Agent 直接连接本平台，通过自然语言指令完成全部日常运维操作。

无需安装 npm 包，获取一个访问令牌即可完成标准配置。

步骤 1：申请访问令牌

进入管理门户：「账号管理」>「访问令牌」，新建一个访问令牌。

令牌形如 tyat_xxxxxxxxxxxxxxxx，仅在签发时显示一次，请妥善保存。

步骤 2：连接到你的 AI Agent

将下方配置中的 <TOKEN_STRING> 替换为步骤 1 获取的令牌，<主控节点IP> 替换为实际地址。

Claude Code（推荐）

在终端执行以下命令，Claude Code 会自动写入配置，之后在任意项目里直接对话即可调用平台工具：

claude mcp add --transport http taiyi-cloud http://<主控节点IP>:5851/api/v1/mcp/ \
  --header "Authorization: Bearer <TOKEN_STRING>"

Cursor、Claude Desktop 等基于配置文件的客户端

将以下 JSON 片段加入对应客户端的 MCP 配置中并重启客户端：

{
  "mcpServers": {
    "taiyi-cloud": {
      "type": "streamable-http",
      "url": "http://<主控节点IP>:5851/api/v1/mcp/",
      "headers": {
        "Authorization": "Bearer <TOKEN_STRING>"
      }
    }
  }
}

Cursor：「Settings → MCP」中新增服务器，粘贴上方 JSON 即可。

Claude Desktop：编辑配置文件后重启 App。

• macOS / Linux：~/.config/Claude/claude_desktop_config.json
• Windows：%APPDATA%\Claude\claude_desktop_config.json

步骤 3：验证连接

配置成功后，主流 Agent 均能自动识别并列出可用的 Resource 和 Tool。

常用 Prompt 示例

主流大模型都具备自动选择和组合 MCP 工具的能力，以下是一些常用指令，可用于检验适配情况：

• 基于 CentOS 7 的镜像，克隆一个 2 核 2GB 内存 20G 磁盘的云主机
• 使用云主机 abc 创建磁盘镜像
• 删除昨天创建并且不在运行中的云主机
• 目前云主机运行情况如何

---

服务能力

MCP 服务当前支持以下能力：

Resource

• 磁盘镜像、光盘镜像、系统模板列表
• 云主机、资源节点、计算资源池、存储池列表
• 系统告警、日志、运行任务列表
• 集群、资源池、节点实时资源用量

Tool

• 云主机：创建、删除、起停、详情、快照、镜像与克隆、媒体操作、磁盘与网卡管理、资源实时用量和历史统计；条件搜索、完整列表
• 磁盘镜像 / 光盘镜像：详情、列表、删除、条件搜索
• 系统模板：详情、列表、条件搜索
• 资源节点、资源池、存储池：详情、列表
• 任务：查询、详情、清除

---