Alibaba Cloud DevOps:Alibaba Cloud DevOps MCP Server

リモートホスティング (ストリーミング HTTP)

<YOUR_TOKEN> をご自身のパーソナルアクセストークンに置き換えてください：

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

クライアントがカスタム headers をサポートしていない場合は、代わりにクエリ文字列を使用してトークンを渡すことができます： 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>"
      }
    }
  }
}

ツールセットのフィルタリング

Alibaba Cloud DevOps MCP Server は、8 つのカテゴリをカバーする 194 のツール を提供します。ツールが多すぎると、モデルのコンテキストを大幅に消費する可能性があります。特定のカテゴリのみが必要な場合は、ツールセット を指定することで、サーバーは対応するツールのみを提供します (基本的なツールは常に含まれます)。

• リモートホスティングモード： URL に ?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>" }
    }
  }
}

認証方式

Alibaba Cloud DevOps MCP Server は、パーソナルアクセストークン (PAT) を手動で渡す方法と、サポートされているクライアントがトークンなしで接続するための OAuth 2.0 認可 を使用する方法の 2 種類の認証をサポートしています。

パーソナルアクセストークン (PAT) の使用

パーソナルアクセストークンを渡すには、推奨度の高い順に、以下の 3 つの方式があります：

stdio モードでは、YUNXIAO_ACCESS_TOKEN 環境変数を使用してトークンを渡します。上記の設定は不要です。

OAuth 2.0 認可

Qoder/QoderCLI や Claude Code など、OAuth をサポートする MCP クライアント の場合、事前にパーソナルアクセストークンを作成する必要はありません。リモートホスティングモードでは、サービス URL を入力すると、クライアントが自動的に OAuth 2.0 認可コード + PKCE フローを開始し、ブラウザーを開いてログインと認可を促し、その後自動的にトークンを取得して更新します。これは、リモートホスティング (ストリーミング HTTP) アクセスに適用されます。

設定時には、Authorization ヘッダーなしでサービス URL のみを入力します：

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

• サービス URL： 中央サイト https://openapi-rdc.aliyuncs.com/ai/mcp、リージョンサイト https://<organization-specific-domain>/ai/mcp。

• エンドポイントの検出、クライアントの登録、PKCE は、すべてクライアントが自動的に処理します。手動で client_id を申請したり、client_secret を設定したりする必要はありません (プラットフォームはパブリッククライアントを使用します)。

• 認可後に発行されるアクセストークンは 24 時間、リフレッシュトークンは 90 日間有効です。クライアントは自動的にトークンを更新します。リフレッシュトークンの有効期限が切れた後は、再認可が必要です。

リージョン設定 (Dedicated Edition)

Alibaba Cloud DevOps のリージョンサイトを使用している場合、各リージョンは公式にホストされた MCP エンドポイントを独立して提供します。使用方法は中央サイトと同じで、サービスアドレスを組織固有のドメインに置き換えるだけです。

方式 1： リモートホスティング (ストリーミング HTTP、推奨、インストール不要)

• サービスアドレス： https://<organization-specific-domain>/ai/mcp、例： https://your-org.devops.aliyuncs.com/ai/mcp (通常の Alibaba Cloud DevOps リージョンドメインに /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>" }
    }
  }
}

方式 2： ローカル (stdio)

YUNXIAO_API_BASE_URL 環境変数を使用して、リージョンドメインを指定します：

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