Skip to main content
Glama

@slorenzot/mcp-azure

Azure DevOps用のMCP(Model Context Protocol)サーバー。互換性のあるMCPクライアントから、作業項目(Work Items)、Gitリポジトリ、プルリクエスト、スプリント、エリア、コメント、添付ファイルを操作できます。

インストール

npm install -g @slorenzot/mcp-azure

またはnpxで直接使用する場合:

npx @slorenzot/mcp-azure

設定

環境変数

サーバーは以下の環境変数を使用して自動的に設定されます:

変数

代替

説明

必須

AZURE_DEVOPS_ORG

ADO_ORG

組織のURL (例: https://dev.azure.com/mi-org)

はい

AZURE_DEVOPS_PAT

ADO_PAT

パーソナルアクセストークン

はい

AZURE_DEVOPS_PROJECT

ADO_PROJECT

プロジェクト名

いいえ

Claude Desktopでの設定

claude_desktop_config.jsonファイルに以下の設定を追加してください:

{
  "mcpServers": {
    "azure-devops": {
      "command": "npx",
      "args": ["-y", "@slorenzot/mcp-azure"],
      "env": {
        "AZURE_DEVOPS_ORG": "https://dev.azure.com/tu-organizacion",
        "AZURE_DEVOPS_PAT": "tu-pat-aqui",
        "AZURE_DEVOPS_PROJECT": "tu-proyecto"
      }
    }
  }
}

OpenCodeでの設定

OpenCodeは同じMCPを使用しますが、設定は2つの方法で行えます:

オプション1:環境変数による初期設定

  1. システムまたはOpenCodeの設定で環境変数を設定します:

    export AZURE_DEVOPS_ORG="https://dev.azure.com/tu-organizacion"
    export AZURE_DEVOPS_PAT="tu-pat-aqui"
    export AZURE_DEVOPS_PROJECT="tu-proyecto"
  2. または、OpenCodeの設定にMCPサーバーを追加します:

    {
      "mcpServers": {
        "azure-devops": {
          "command": "npx",
          "args": ["-y", "@slorenzot/mcp-azure"],
          "env": {
            "AZURE_DEVOPS_ORG": "https://dev.azure.com/tu-organizacion",
            "AZURE_DEVOPS_PAT": "tu-pat-aqui",
            "AZURE_DEVOPS_PROJECT": "tu-proyecto"
          }
        }
      }
    }

オプション2:ado_configureによる動的設定

OpenCodeでは、ado_configureコマンドを使用してセッション中に直接接続を設定できます:

{
  "organization": "https://dev.azure.com/tu-organizacion",
  "project": "tu-proyecto",
  "pat": "tu-pat-aqui"
}

このオプションは、設定ファイルを変更せずに異なる組織やプロジェクトを切り替える場合に便利です。

注意: ado_configureを使用すると、接続は現在のOpenCodeセッション中のみ保持されます。

パーソナルアクセストークン (PAT) の取得

  1. Azure DevOpsの組織にアクセスします

  2. アバター(右上隅)をクリックします

  3. Personal Access Tokensを選択します

  4. 以下の権限を持つ新しいトークンを作成します:

    • Work Items: Read & Write

    • Code: Read & Write (リポジトリおよびプルリクエスト操作用)

    • Project and Team: Read (オプション)

利用可能なツール

認証

ツール

説明

ado_configure

組織、プロジェクト、PATで接続を設定する

作業項目 (Work Items)

ツール

説明

ado_get_work_item

IDで作業項目を取得する

ado_create_work_item

新しい作業項目(ユーザーストーリー、バグ、タスクなど)を作成する

ado_update_work_item

既存の作業項目を更新する

ado_get_work_item_type_fields

型の利用可能/必須フィールドを取得する

クエリ

ツール

説明

ado_query_sprint

特定のスプリントの作業項目をクエリする

ado_query_area

特定のエリアの作業項目をクエリする

ado_query_wiql

カスタムWIQLクエリを実行する

プロジェクト構造

ツール

説明

ado_list_iterations

プロジェクトのイテレーション/スプリントを一覧表示する

ado_list_areas

プロジェクトのエリアを一覧表示する

Gitリポジトリ

ツール

説明

ado_list_repositories

プロジェクトのすべてのGitリポジトリを一覧表示する

ado_get_repository

名前またはIDで特定のリポジトリの詳細を取得する

ado_list_branches

リポジトリのブランチを一覧表示する

プルリクエスト

ツール

説明

ado_list_pull_requests

オプションのフィルター(ステータス、ブランチ、作成者、レビュアー)でプルリクエストを一覧表示する

ado_get_pull_request

プルリクエストの詳細を取得する

ado_create_pull_request

新しいプルリクエストを作成する

ado_update_pull_request

プルリクエストのプロパティ(タイトル、説明、ドラフト)を更新する

ado_complete_pull_request

設定可能な戦略でプルリクエストを完了(マージ)する

ado_abandon_pull_request

プルリクエストを破棄する

プルリクエストレビュー

ツール

説明

ado_approve_pull_request

プルリクエストを承認する (投票: 10)

ado_reject_pull_request

プルリクエストを却下する (投票: -10)

ado_get_pull_request_reviewers

プルリクエストのすべてのレビュアーと投票を取得する

ado_add_pull_request_reviewer

プルリクエストにレビュアーを追加する

プルリクエストコメント

ツール

説明

ado_get_pull_request_threads

プルリクエストのすべてのコメントスレッドを取得する

ado_create_pull_request_thread

新しいコメントスレッド(一般またはコード)を作成する

ado_reply_to_pull_request_thread

既存のコメントスレッドに返信する

プルリクエスト情報

ツール

説明

ado_get_pull_request_commits

プルリクエストのすべてのコミットを取得する

ado_get_pull_request_work_items

プルリクエストにリンクされた作業項目を取得する

ado_update_pull_request_thread_status

コメントスレッドのステータス(Fixed, WontFixなど)を更新する

コメントとディスカッション

ツール

説明

ado_add_comment

作業項目にコメントを追加する(Markdown対応)

ado_get_comments

作業項目のコメントを取得する

添付ファイル

ツール

説明

ado_upload_attachment

ファイルをアップロードし、添付ファイルのURLを返す

ado_add_attachment

作業項目に添付ファイルを追加する

ado_get_attachments

作業項目の添付ファイルを一覧表示する

使用例

ユーザーストーリーの作成

{
  "title": "Implementar login con OAuth",
  "type": "User Story",
  "description": "Como usuario quiero poder iniciar sesión con mi cuenta de Google",
  "areaPath": "MiProyecto\\Backend",
  "iterationPath": "MiProyecto\\Sprint 5",
  "fields": {
    "Custom.OKR": "Seguridad",
    "Custom.Prioridad": "Alta"
  }
}

カスタムWIQLクエリ

{
  "wiql": "SELECT [System.Id], [System.Title] FROM WorkItems WHERE [System.State] = 'Active' AND [System.AssignedTo] = @Me ORDER BY [System.CreatedDate] DESC",
  "getDetails": true
}

Markdownでのコメント追加

{
  "id": 12345,
  "comment": "## Análisis completado\n\n- Revisado el código\n- Identificados 3 issues\n\n**Próximo paso:** Corregir validaciones"
}

ファイルのアップロードと添付

{
  "workItemId": 12345,
  "filePath": "/ruta/al/archivo.pdf",
  "comment": "Documento de especificaciones",
  "name": "Especificaciones Funcionales v2.0"
}

既存の添付ファイルのリンク

{
  "workItemId": 12345,
  "attachmentUrl": "https://dev.azure.com/org/proj/_apis/wit/attachments/abc123",
  "comment": "Diseño de arquitectura",
  "name": "Arquitectura del Sistema"
}

リポジトリの一覧表示

{
  "includeHidden": false,
  "top": 50
}

アクティブなプルリクエストの一覧表示

{
  "status": "Active",
  "top": 20
}

プルリクエストの作成

{
  "repositoryId": "mi-repo",
  "sourceRefName": "refs/heads/feature-login",
  "targetRefName": "refs/heads/main",
  "title": "Implementar login con OAuth",
  "description": "Esta PR agrega soporte para login con Google OAuth",
  "reviewerIds": ["12345678-1234-1234-1234-1234567890ab"],
  "isDraft": false
}

プルリクエストの承認

{
  "pullRequestId": 12345,
  "repositoryId": "mi-repo"
}

プルリクエストの完了(マージ)

{
  "pullRequestId": 12345,
  "repositoryId": "mi-repo",
  "mergeStrategy": "Squash",
  "deleteSourceBranch": true,
  "mergeCommitMessage": "Merge de feature-login"
}

コードへのコメント作成

{
  "pullRequestId": 12345,
  "repositoryId": "mi-repo",
  "content": "Por favor extraer esto en una función separada",
  "filePath": "/src/components/Login.tsx",
  "startLine": 45,
  "endLine": 52
}

利用可能なプロンプト

サーバーには、一般的なタスクを容易にするための定義済みプロンプトが含まれています:

プロンプト

説明

connect

Azure DevOpsへの接続ガイド

analyze_sprint

スプリントの状態を分析する

create_user_story

構造化されたユーザーストーリーを作成する

daily_standup

デイリースタンドアップレポートを生成する

plan_sprint

スプリントの計画を支援する

bulk_update

複数の作業項目を更新する

project_report

プロジェクトレポートを生成する

report_bug

構造化されたバグ報告を作成する

リソース

リソース

URI

説明

接続状態

ado://connection/status

現在の接続状態情報

開発

要件

  • Node.js 18+

  • npm または yarn

ローカルインストール

git clone https://github.com/slorenzot/mcp-azure.git
cd mcp-azure
npm install
npm run build

利用可能なスクリプト

npm run build    # Compila TypeScript
npm run start    # Inicia el servidor
npm run dev      # Modo desarrollo con watch

ライセンス

MIT

作者

Soulberto Lorenzo - @slorenzot

バージョン

2.4.1 - Azure DevOps用の34のツールが利用可能(作業項目、Gitリポジトリ、プルリクエストなど)

Install Server
A
security – no known vulnerabilities
A
license - permissive license
A
quality - A tier

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/soulberto/mcp-azure'

If you have feedback or need assistance with the MCP directory API, please join our Discord server