Alibaba Cloud DevOps:Alibaba Cloud DevOps MCP Server

Remote hosting (Streamable HTTP)

Ganti <YOUR_TOKEN> dengan personal access token Anda:

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

Jika client Anda tidak mendukung headers kustom, Anda dapat menggunakan Query String untuk meneruskan token sebagai gantinya: https://openapi-rdc.aliyuncs.com/ai/mcp?yunxiao_access_token=<YOUR_TOKEN>.

Jika client Anda mendukung OAuth, Anda dapat melewati token dan menggunakan otorisasi berbasis browser sebagai gantinya. Untuk detailnya, lihat “Konfigurasi lanjutan > Metode autentikasi > Otorisasi OAuth 2.0” di bawah.

Local (stdio)

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

Filtering toolset

Alibaba Cloud DevOps MCP Server menyediakan 194 tool yang mencakup 8 kategori. Terlalu banyak tool dapat menghabiskan konteks model secara signifikan. Jika Anda hanya memerlukan kategori tertentu, Anda dapat menentukan toolsets agar server hanya mengirimkan tool yang sesuai (tool dasar selalu disertakan).

• Mode Remote Hosting: Tambahkan ?toolsets=... ke URL, atau tambahkan header permintaan X-Devops-Toolsets: ....

• Mode stdio: Tambahkan argumen command-line --toolsets=..., atau atur variabel lingkungan DEVOPS_TOOLSETS=....

Nilai yang tersedia (dipisahkan koma): code-management, organization-management, project-management, pipeline-management, packages-management, application-delivery, test-management. Jika tidak ditentukan, semua tool diaktifkan secara default.

Contoh akses remote:

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

Metode autentikasi

Alibaba Cloud DevOps MCP Server mendukung dua jenis autentikasi: meneruskan Personal Access Token (PAT) secara manual, atau menggunakan Otorisasi OAuth 2.0 agar client yang didukung dapat terhubung tanpa token.

Menggunakan Personal Access Token (PAT)

Tiga metode berikut tersedia untuk meneruskan personal access token, diurutkan berdasarkan prioritas yang direkomendasikan:

Dalam mode stdio, teruskan token melalui variabel lingkungan YUNXIAO_ACCESS_TOKEN. Konfigurasi di atas tidak diperlukan.

Otorisasi OAuth 2.0

Untuk client MCP yang mendukung OAuth, seperti Qoder/QoderCLI dan Claude Code, Anda tidak perlu membuat personal access token terlebih dahulu. Dalam mode Remote Hosting, setelah memasukkan URL layanan, client akan secara otomatis memulai alur otorisasi OAuth 2.0 authorization code + PKCE, membuka browser untuk memandu Anda melalui proses login dan otorisasi, lalu secara otomatis memperoleh dan merefresh token. Ini berlaku untuk akses Remote Hosting (Streamable HTTP).

Saat mengonfigurasi, masukkan hanya URL layanan tanpa header Authorization:

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

• URL layanan: Stasiun pusat https://openapi-rdc.aliyuncs.com/ai/mcp; Stasiun Wilayah https://<organization-specific-domain>/ai/mcp.

• Endpoint discovery, pendaftaran client, dan PKCE semuanya ditangani secara otomatis oleh client. Anda tidak perlu mengajukan client_id atau mengonfigurasi client_secret secara manual (platform menggunakan public client).

• Token akses yang dikeluarkan setelah otorisasi berlaku selama 24 jam, dan token penyegaran berlaku selama 90 hari. Client secara otomatis merefresh token. Otorisasi ulang diperlukan setelah token penyegaran kedaluwarsa.

Konfigurasi Wilayah (Edisi Dedicated)

Jika Anda menggunakan stasiun Wilayah Alibaba Cloud DevOps, setiap Wilayah secara independen menyediakan endpoint MCP yang di-host resmi. Penggunaannya sama dengan stasiun pusat—cukup ganti alamat layanan dengan domain khusus organisasi Anda.

Metode 1: Remote Hosting (Streamable HTTP, direkomendasikan, tidak perlu instalasi)

• Alamat layanan: https://<organization-specific-domain>/ai/mcp, misalnya https://your-org.devops.aliyuncs.com/ai/mcp (domain Wilayah Alibaba Cloud DevOps reguler Anda dengan /ai/mcp ditambahkan)

• Autentikasi: Authorization: Bearer <YOUR_TOKEN> (atau X-Yunxiao-Token: <YOUR_TOKEN>). Jika client Anda mendukung OAuth, Anda dapat melewati token dan menggunakan otorisasi berbasis browser sebagai gantinya. Untuk detailnya, lihat “Konfigurasi lanjutan > Metode autentikasi > Otorisasi OAuth 2.0” di atas.

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

Metode 2: Local (stdio)

Gunakan variabel lingkungan YUNXIAO_API_BASE_URL untuk mengarahkan ke domain Wilayah Anda:

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