云效MCP工具使用说明

远程托管（Streamable HTTP）

将 <YOUR_TOKEN> 替换为获取到的个人访问令牌：

{
  "mcpServers": {
    "yunxiao": {
      "url": "https://openapi-rdc.aliyuncs.com/ai/mcp",
      "headers": {
        "Authorization": "Bearer <YOUR_TOKEN>"
      }
    }
  }
}

若客户端不支持自定义 headers，可改用 Query String 传递 Token：https://openapi-rdc.aliyuncs.com/ai/mcp?yunxiao_access_token=<YOUR_TOKEN>。

若你的客户端支持 OAuth，也可以不填令牌，改用浏览器授权接入，详见「高级配置 → 认证方式 → OAuth 2.0 授权」。

本地运行（stdio）

{
  "mcpServers": {
    "yunxiao": {
      "command": "npx",
      "args": ["-y", "alibabacloud-devops-mcp-server"],
      "env": {
        "YUNXIAO_ACCESS_TOKEN": "<YOUR_TOKEN>"
      }
    }
  }
}

工具集筛选

云效 MCP Server 提供 194 个工具，覆盖 8 大类。工具数量较多时会占用较大的模型上下文。如果只需要其中几类，可以指定工具集，服务端仅下发对应工具（基础工具始终包含）。

• 远程托管模式：在地址后加 Query ?toolsets=...，或加请求头 X-Devops-Toolsets: ...。

• stdio 模式：加命令行参数 --toolsets=...，或环境变量 DEVOPS_TOOLSETS=...。

可选值（逗号分隔）：code-management、organization-management、project-management、pipeline-management、packages-management、application-delivery、test-management。不填则默认启用全部工具。

远程接入示例：

{
  "mcpServers": {
    "yunxiao": {
      "url": "https://openapi-rdc.aliyuncs.com/ai/mcp?toolsets=code-management,project-management",
      "headers": { "Authorization": "Bearer <YOUR_TOKEN>" }
    }
  }
}

认证方式

云效 MCP Server 支持两类认证：使用 个人访问令牌（PAT）手动传递，或对支持的客户端使用 OAuth 2.0 授权免令牌接入。

{
 "mcpServers": {
    "yunxiao": {
       "url": "https://openapi-rdc.aliyuncs.com/ai/mcp"
   }
 }
}

Region 配置（专有版）

若使用的是云效 Region 站，云效已在每个 Region 独立提供官方托管的 MCP 端点，用法与中心站一致，只需将服务地址替换为组织专属域名。

方式一：远程托管（Streamable HTTP，推荐，免安装）

• 服务地址：https://<组织专属域名>/ai/mcp，例如 https://your-org.devops.aliyuncs.com/ai/mcp（即平时访问云效的 Region 域名拼接 /ai/mcp 路径）

• 认证：Authorization: Bearer <YOUR_TOKEN>（或 X-Yunxiao-Token: <YOUR_TOKEN>）

{
  "mcpServers": {
    "yunxiao": {
      "url": "https://your-org.devops.aliyuncs.com/ai/mcp",
      "headers": { "Authorization": "Bearer <YOUR_TOKEN>" }
    }
  }
}

方式二：本地运行（stdio）

通过环境变量 YUNXIAO_API_BASE_URL 指向 Region 域名：

{
  "mcpServers": {
    "yunxiao": {
      "command": "npx",
      "args": ["-y", "alibabacloud-devops-mcp-server"],
      "env": {
        "YUNXIAO_ACCESS_TOKEN": "<YOUR_TOKEN>",
        "YUNXIAO_API_BASE_URL": "https://your-org.devops.aliyuncs.com"
      }
    }
  }
}