@slorenzot/mcp-azure
@slorenzot/mcp-azure
Azure DevOps用のMCP(Model Context Protocol)サーバー。互換性のあるMCPクライアントから、作業項目(Work Items)、Gitリポジトリ、プルリクエスト、スプリント、エリア、コメント、添付ファイルを操作できます。
インストール
npm install -g @slorenzot/mcp-azureまたはnpxで直接使用する場合:
npx @slorenzot/mcp-azureRelated MCP server: devops-wrangler
設定
環境変数
サーバーは以下の環境変数を使用して自動的に設定されます:
変数 | 代替 | 説明 | 必須 |
|
| 組織のURL (例: | はい |
|
| パーソナルアクセストークン | はい |
|
| プロジェクト名 | いいえ |
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:環境変数による初期設定
システムまたはOpenCodeの設定で環境変数を設定します:
export AZURE_DEVOPS_ORG="https://dev.azure.com/tu-organizacion" export AZURE_DEVOPS_PAT="tu-pat-aqui" export AZURE_DEVOPS_PROJECT="tu-proyecto"または、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) の取得
Azure DevOpsの組織にアクセスします
アバター(右上隅)をクリックします
Personal Access Tokensを選択します
以下の権限を持つ新しいトークンを作成します:
Work Items: Read & Write
Code: Read & Write (リポジトリおよびプルリクエスト操作用)
Project and Team: Read (オプション)
利用可能なツール
認証
ツール | 説明 |
| 組織、プロジェクト、PATで接続を設定する |
作業項目 (Work Items)
ツール | 説明 |
| IDで作業項目を取得する |
| 新しい作業項目(ユーザーストーリー、バグ、タスクなど)を作成する |
| 既存の作業項目を更新する |
| 型の利用可能/必須フィールドを取得する |
クエリ
ツール | 説明 |
| 特定のスプリントの作業項目をクエリする |
| 特定のエリアの作業項目をクエリする |
| カスタムWIQLクエリを実行する |
プロジェクト構造
ツール | 説明 |
| プロジェクトのイテレーション/スプリントを一覧表示する |
| プロジェクトのエリアを一覧表示する |
Gitリポジトリ
ツール | 説明 |
| プロジェクトのすべてのGitリポジトリを一覧表示する |
| 名前またはIDで特定のリポジトリの詳細を取得する |
| リポジトリのブランチを一覧表示する |
プルリクエスト
ツール | 説明 |
| オプションのフィルター(ステータス、ブランチ、作成者、レビュアー)でプルリクエストを一覧表示する |
| プルリクエストの詳細を取得する |
| 新しいプルリクエストを作成する |
| プルリクエストのプロパティ(タイトル、説明、ドラフト)を更新する |
| 設定可能な戦略でプルリクエストを完了(マージ)する |
| プルリクエストを破棄する |
プルリクエストレビュー
ツール | 説明 |
| プルリクエストを承認する (投票: 10) |
| プルリクエストを却下する (投票: -10) |
| プルリクエストのすべてのレビュアーと投票を取得する |
| プルリクエストにレビュアーを追加する |
プルリクエストコメント
ツール | 説明 |
| プルリクエストのすべてのコメントスレッドを取得する |
| 新しいコメントスレッド(一般またはコード)を作成する |
| 既存のコメントスレッドに返信する |
プルリクエスト情報
ツール | 説明 |
| プルリクエストのすべてのコミットを取得する |
| プルリクエストにリンクされた作業項目を取得する |
| コメントスレッドのステータス(Fixed, WontFixなど)を更新する |
コメントとディスカッション
ツール | 説明 |
| 作業項目にコメントを追加する(Markdown対応) |
| 作業項目のコメントを取得する |
添付ファイル
ツール | 説明 |
| ファイルをアップロードし、添付ファイルのURLを返す |
| 作業項目に添付ファイルを追加する |
| 作業項目の添付ファイルを一覧表示する |
使用例
ユーザーストーリーの作成
{
"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
}利用可能なプロンプト
サーバーには、一般的なタスクを容易にするための定義済みプロンプトが含まれています:
プロンプト | 説明 |
| Azure DevOpsへの接続ガイド |
| スプリントの状態を分析する |
| 構造化されたユーザーストーリーを作成する |
| デイリースタンドアップレポートを生成する |
| スプリントの計画を支援する |
| 複数の作業項目を更新する |
| プロジェクトレポートを生成する |
| 構造化されたバグ報告を作成する |
リソース
リソース | URI | 説明 |
接続状態 |
| 現在の接続状態情報 |
開発
要件
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リポジトリ、プルリクエストなど)
Available Tools
36 toolsado_abandon_pull_requestC
Abandona un Pull Request (cambia estado a Abandoned).
Inputs: pullRequestId (required), repositoryId.
ado_add_attachmentB
Agrega un adjunto a un Work Item existente. Maneja automáticamente concurrencia cuando múltiples adjuntos se agregan al mismo WI.
Inputs: workItemId (required), name, comment, filePath, +1 more.
ado_add_commentB
Agrega un comentario/entrada de discusión a un Work Item. Soporta formato Markdown.
Inputs: id (required), comment (required).
ado_add_pull_request_reviewerB
Agrega un revisor a un Pull Request.
Inputs: reviewerId (required), pullRequestId (required), vote, repositoryId.
ado_approve_pull_requestB
Aprueba un Pull Request (voto: 10).
Inputs: pullRequestId (required), reviewerId, repositoryId.
ado_complete_pull_requestC
Completa (merge) un Pull Request.
Inputs: pullRequestId (required), repositoryId, mergeStrategy, deleteSourceBranch, +2 more.
ado_configureB
Configura la conexión a Azure DevOps con token de acceso personal (PAT).
Inputs: pat (required), project (required), organization (required).
ado_create_pull_requestC
Crea un nuevo Pull Request.
Inputs: title (required), repositoryId (required), sourceRefName (required), targetRefName (required), +3 more.
ado_create_pull_request_threadB
Crea un nuevo hilo de comentarios (comentario general o comentario de código).
Inputs: content (required), pullRequestId (required), endLine, filePath, +2 more.
ado_create_work_itemA
Crea un nuevo Work Item en Azure DevOps. Usa ado_get_work_item_type_fields para ver campos requeridos.
Inputs: type (required), title (required), fields, areaPath, +3 more.
ado_delete_attachmentB
Elimina un adjunto de un Work Item removiendo su relación. Maneja automáticamente concurrencia cuando múltiples cambios afectan el mismo WI.
Inputs: workItemId (required), comment, attachmentUrl, attachmentName.
ado_delete_work_itemA
Elimina un Work Item en Azure DevOps. Por defecto realiza borrado lógico; usa destroy=true solo para eliminación permanente.
Inputs: id (required), confirm (required), destroy, expectedType.
ado_get_attachmentsB
Obtiene la lista de adjuntos de un Work Item
Inputs: id (required).
ado_get_commentsB
Obtiene los comentarios/historial de discusión de un Work Item
Inputs: id (required), top.
ado_get_pull_requestC
Obtiene detalles completos de un Pull Request.
Inputs: pullRequestId (required), repositoryId, includeCommits, includeWorkItems.
ado_get_pull_request_commitsC
Obtiene todos los commits de un Pull Request.
Inputs: pullRequestId (required), top, repositoryId.
ado_get_pull_request_reviewersA
Obtiene todos los revisores y sus votos de un Pull Request.
Inputs: pullRequestId (required), repositoryId.
ado_get_pull_request_threadsB
Obtiene todos los hilos de comentarios de un Pull Request.
Inputs: pullRequestId (required), repositoryId.
ado_get_pull_request_work_itemsB
Obtiene los work items vinculados a un Pull Request.
Inputs: pullRequestId (required), repositoryId.
ado_get_repositoryB
Obtiene detalles de un repositorio específico por nombre o ID.
Inputs: repositoryId (required).
ado_get_work_itemB
Obtiene un Work Item de Azure DevOps por su ID
Inputs: id (required), full.
ado_get_work_item_type_fieldsB
Obtiene los campos disponibles y requeridos para un tipo de Work Item
Inputs: workItemType (required).
ado_list_areasA
Lista las áreas disponibles en el proyecto
Inputs: no named parameters.
ado_list_branchesB
Lista las ramas (branches) de un repositorio.
Inputs: repositoryId (required), filter, includeStatuses.
ado_list_iterationsA
Lista las iteraciones/sprints disponibles en el proyecto
Inputs: no named parameters.
ado_list_pull_requestsA
Lista Pull Requests con filtros opcionales. Busca por repositorio o en todo el proyecto.
Inputs: top, status, creatorId, reviewerId, +3 more.
ado_list_repositoriesA
Lista todos los repositorios Git del proyecto.
Inputs: top, includeHidden.
ado_query_areaC
Consulta User Stories de un área específica en Azure DevOps
Inputs: areaPath (required), workItemType.
ado_query_sprintA
Consulta User Stories de un sprint específico en Azure DevOps
Inputs: iterationPath (required), state.
ado_query_wiqlC
Ejecuta una consulta WIQL personalizada en Azure DevOps
Inputs: wiql (required), getDetails.
ado_reject_pull_requestC
Rechaza un Pull Request (voto: -10).
Inputs: pullRequestId (required), reviewerId, repositoryId.
ado_reply_to_pull_request_threadC
Responde a un hilo de comentarios existente.
Inputs: content (required), threadId (required), pullRequestId (required), repositoryId.
ado_update_pull_requestC
Actualiza propiedades de un Pull Request (título, descripción, estado de borrador).
Inputs: pullRequestId (required), title, isDraft, description, +1 more.
ado_update_pull_request_thread_statusC
Actualiza el estado de un hilo de comentarios (ej: marcar como Fixed, WontFix, etc.).
Inputs: status (required), threadId (required), pullRequestId (required), repositoryId.
ado_update_work_itemC
Actualiza un Work Item existente en Azure DevOps
Inputs: id (required), state, title, fields, +2 more.
ado_upload_attachmentC
Sube un archivo como adjunto a Azure DevOps y devuelve la URL del adjunto
Inputs: filePath (required), fileName.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 36 tools
Each tool targets a distinct action and resource (e.g., create vs update vs delete work items, add vs upload attachments). No two tools have ambiguous purposes, ensuring clear agent selection.
All tools follow the consistent pattern 'ado_verb_noun' (e.g., ado_create_work_item, ado_list_repositories). The prefix and verb-noun structure are uniform, making it easy to predict tool names.
36 tools is slightly above the typical range, but the Azure DevOps domain is broad. Each tool covers a necessary operation (work items, PRs, repositories, queries, etc.), so the count feels justified rather than bloated.
The tool surface covers the main workflows: CRUD for work items and pull requests, attachments, comments, threads, repositories, and queries. Minor gaps exist (e.g., no create/delete branch or build pipeline tools), but core operations are present.
Maintenance
Related MCP Connectors
The MCP server for Azure DevOps, bringing the power of Azure DevOps directly to your agents.
Devopness MCP server for DevOps happiness! Empower AI Agents to deploy apps and infra, to any cloud.
MCP server for building and testing AI agents with multi-model experimentation and insights.
One MCP server for the services your AI needs: memory, files, Microsoft 365, kanban and more.
Related MCP Servers
- AlicenseNot gradedqualityCmaintenanceMCP server that enables AI assistants to manage Azure DevOps resources including Work Items, Git repositories, pipelines, and user identities.20 npmMIT
- AlicenseAqualityDmaintenanceAn MCP server for Azure DevOps work item management that enables AI assistants to create, query, update, and manage work items, sprints, and more.129 npmISC
- AlicenseNot gradedqualityDmaintenanceMCP server for Azure DevOps Server 2022 (on-premises) that enables AI assistants to interact with work items, repositories, builds, and sprints through 29 tools.33 npmMIT
- AlicenseNot gradedqualityDmaintenanceA focused MCP server for Azure DevOps work item administration, enabling AI agents to create, update, query, and manage work items with full CRUD operations and advanced WIQL querying.MIT