Skip to main content
Glama

@slorenzot/mcp-azure

MCP-Server (Model Context Protocol) für Azure DevOps. Ermöglicht die Interaktion mit Arbeitselementen (Work Items), Git-Repositories, Pull Requests, Sprints, Bereichen, Kommentaren und Anhängen von jedem kompatiblen MCP-Client aus.

Installation

npm install -g @slorenzot/mcp-azure

Oder direkt mit npx verwenden:

npx @slorenzot/mcp-azure

Konfiguration

Umgebungsvariablen

Der Server wird automatisch über die folgenden Umgebungsvariablen konfiguriert:

Variable

Alternative

Beschreibung

Erforderlich

AZURE_DEVOPS_ORG

ADO_ORG

URL der Organisation (z. B. https://dev.azure.com/meine-org)

Ja

AZURE_DEVOPS_PAT

ADO_PAT

Personal Access Token

Ja

AZURE_DEVOPS_PROJECT

ADO_PROJECT

Name des Projekts

Nein

Konfiguration in Claude Desktop

Fügen Sie die folgende Konfiguration zu Ihrer claude_desktop_config.json-Datei hinzu:

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

Konfiguration in OpenCode

OpenCode verwendet dasselbe MCP, aber die Konfiguration kann auf zwei Arten erfolgen:

Option 1: Erstkonfiguration mit Umgebungsvariablen

  1. Konfigurieren Sie die Umgebungsvariablen in Ihrem System oder in Ihrer OpenCode-Konfiguration:

    export AZURE_DEVOPS_ORG="https://dev.azure.com/tu-organizacion"
    export AZURE_DEVOPS_PAT="tu-pat-aqui"
    export AZURE_DEVOPS_PROJECT="tu-proyecto"
  2. Oder fügen Sie den MCP-Server in Ihrer OpenCode-Konfiguration hinzu:

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

Option 2: Dynamische Konfiguration mit ado_configure

OpenCode ermöglicht es, die Verbindung während der Sitzung direkt über den Befehl ado_configure zu konfigurieren:

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

Diese Option ist nützlich, um zwischen verschiedenen Organisationen oder Projekten zu wechseln, ohne die Konfigurationsdatei zu ändern.

Hinweis: Wenn Sie ado_configure verwenden, bleibt die Verbindung während der aktuellen OpenCode-Sitzung bestehen.

Personal Access Token (PAT) abrufen

  1. Gehen Sie zu Ihrer Azure DevOps-Organisation

  2. Klicken Sie auf Ihren Avatar (obere rechte Ecke)

  3. Wählen Sie Personal Access Tokens

  4. Erstellen Sie ein neues Token mit den folgenden Berechtigungen:

    • Work Items: Read & Write

    • Code: Read & Write (für Repository- und Pull Request-Operationen)

    • Project and Team: Read (optional)

Verfügbare Tools

Authentifizierung

Tool

Beschreibung

ado_configure

Konfiguriert die Verbindung mit Organisation, Projekt und PAT

Work Items

Tool

Beschreibung

ado_get_work_item

Ruft ein Work Item über seine ID ab

ado_create_work_item

Erstellt ein neues Work Item (User Story, Bug, Task, etc.)

ado_update_work_item

Aktualisiert ein bestehendes Work Item

ado_get_work_item_type_fields

Ruft die verfügbaren/erforderlichen Felder eines Typs ab

Abfragen

Tool

Beschreibung

ado_query_sprint

Fragt Work Items eines bestimmten Sprints ab

ado_query_area

Fragt Work Items eines bestimmten Bereichs ab

ado_query_wiql

Führt eine benutzerdefinierte WIQL-Abfrage aus

Projektstruktur

Tool

Beschreibung

ado_list_iterations

Listet die Iterationen/Sprints des Projekts auf

ado_list_areas

Listet die Bereiche des Projekts auf

Git-Repositories

Tool

Beschreibung

ado_list_repositories

Listet alle Git-Repositories des Projekts auf

ado_get_repository

Ruft Details eines bestimmten Repositories nach Name oder ID ab

ado_list_branches

Listet die Branches eines Repositories auf

Pull Requests

Tool

Beschreibung

ado_list_pull_requests

Listet Pull Requests mit optionalen Filtern auf (Status, Branches, Ersteller, Prüfer)

ado_get_pull_request

Ruft vollständige Details eines Pull Requests ab

ado_create_pull_request

Erstellt einen neuen Pull Request

ado_update_pull_request

Aktualisiert Eigenschaften eines Pull Requests (Titel, Beschreibung, Entwurf)

ado_complete_pull_request

Schließt (merge) einen Pull Request mit konfigurierbarer Strategie ab

ado_abandon_pull_request

Bricht einen Pull Request ab

Pull Request Reviews

Tool

Beschreibung

ado_approve_pull_request

Genehmigt einen Pull Request (Stimme: 10)

ado_reject_pull_request

Lehnt einen Pull Request ab (Stimme: -10)

ado_get_pull_request_reviewers

Ruft alle Prüfer und deren Stimmen eines Pull Requests ab

ado_add_pull_request_reviewer

Fügt einen Prüfer zu einem Pull Request hinzu

Pull Request Kommentare

Tool

Beschreibung

ado_get_pull_request_threads

Ruft alle Kommentar-Threads eines Pull Requests ab

ado_create_pull_request_thread

Erstellt einen neuen Kommentar-Thread (allgemein oder für Code)

ado_reply_to_pull_request_thread

Antwortet auf einen bestehenden Kommentar-Thread

Pull Request Info

Tool

Beschreibung

ado_get_pull_request_commits

Ruft alle Commits eines Pull Requests ab

ado_get_pull_request_work_items

Ruft die mit einem Pull Request verknüpften Work Items ab

ado_update_pull_request_thread_status

Aktualisiert den Status eines Kommentar-Threads (Fixed, WontFix, etc.)

Kommentare und Diskussionen

Tool

Beschreibung

ado_add_comment

Fügt einem Work Item einen Kommentar hinzu (unterstützt Markdown)

ado_get_comments

Ruft die Kommentare eines Work Items ab

Anhänge

Tool

Beschreibung

ado_upload_attachment

Lädt eine Datei hoch und gibt die URL des Anhangs zurück

ado_add_attachment

Fügt einem Work Item einen Anhang hinzu

ado_get_attachments

Listet die Anhänge eines Work Items auf

Anwendungsbeispiele

Eine User Story erstellen

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

Benutzerdefinierte WIQL-Abfrage

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

Kommentar mit Markdown hinzufügen

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

Datei hochladen und anhängen

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

Bestehenden Anhang verknüpfen

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

Repositories auflisten

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

Aktive Pull Requests auflisten

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

Einen Pull Request erstellen

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

Einen Pull Request genehmigen

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

Einen Pull Request abschließen (Merge)

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

Kommentar im Code erstellen

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

Verfügbare Prompts

Der Server enthält vordefinierte Prompts, um häufige Aufgaben zu erleichtern:

Prompt

Beschreibung

connect

Anleitung zur Verbindung mit Azure DevOps

analyze_sprint

Analysiert den Status eines Sprints

create_user_story

Erstellt eine strukturierte User Story

daily_standup

Generiert einen täglichen Standup-Bericht

plan_sprint

Hilft bei der Planung eines Sprints

bulk_update

Aktualisiert mehrere Work Items gleichzeitig

project_report

Generiert einen Projektbericht

report_bug

Erstellt einen strukturierten Fehlerbericht

Ressourcen

Ressource

URI

Beschreibung

Verbindungsstatus

ado://connection/status

Informationen zum aktuellen Verbindungsstatus

Entwicklung

Voraussetzungen

  • Node.js 18+

  • npm oder yarn

Lokale Installation

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

Verfügbare Skripte

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

Lizenz

MIT

Autor

Soulberto Lorenzo - @slorenzot

Version

2.4.1 - 34 Tools für Azure DevOps verfügbar (Work Items, Git-Repositories, Pull Requests, etc.)

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