Alibaba Cloud DevOps：雲效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>）。若你的用戶端支援 OAuth，也可以不填令牌，改用瀏覽器授權接入，詳見「進階配置 → 認證方式 → OAuth 2.0 授權」。

{
  "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"
      }
    }
  }
}