Einrichten des Remote-Azure DevOps MCP-Servers

Azure DevOps Services

Der Remote-Azure DevOps MCP-Server ist eine gehostete Version des Azure DevOps MCP-Servers für die keine lokale Installation erforderlich ist. Anstatt den Server auf Ihrem Computer auszuführen, verbinden Sie Ihren KI-Assistenten direkt mit dem vom Azure DevOps gehosteten Endpunkt mithilfe des streambaren HTTP-Transports.

Wählen Sie zuerst „Remote“ aus

Verwenden Sie den MCP-Remoteserver , wenn Ihre Umgebung ihn unterstützt. Der Remote-Server ist die empfohlene Option, da er von Azure DevOps gehostet und aktualisiert wird und Sie Node.js nicht installieren oder einen lokalen Serverprozess verwalten müssen.

Verwenden Sie den lokalen MCP-Server, wenn ihr Client sich nicht mit Microsoft Entra ID beim Remoteserver authentifizieren kann. Diese Einschränkung gilt derzeit für Clients wie Claude Desktop und Codex. Cursor und Claude Code erfordern eine benutzerdefinierte Microsoft Entra App-Registrierung zur Authentifizierung. Anweisungen zum lokalen Setup finden Sie unter Aktivieren der KI-Unterstützung für den Azure DevOps MCP-Server.

Voraussetzungen

mcp.json Konfiguration

{
  "servers": {
    "ado-remote-mcp": {
      "url": "https://mcp.dev.azure.com/{organization}",
      "type": "http"
    }
  },
  "inputs": []
}

Sie können den Organisationsnamen auch aus der URL weglassen. Wenn Sie den Organisationsnamen jedoch weglassen, müssen Sie ihn in jedem Toolaufruf als Kontext angeben.

{
  "servers": {
    "ado-remote-mcp": {
      "url": "https://mcp.dev.azure.com/",
      "type": "http"
    }
  },
  "inputs": []
}

Toolsets

Geben Sie Toolsets an, um die für den MCP-Server verfügbaren Tools einzuschränken. Sollte nicht mit X-MCP-Tools kombiniert werden.

{
  "servers": {
    "ado-remote-mcp": {
      "url": "https://mcp.dev.azure.com/{organization}",
      "type": "http",
      "headers": {
        "X-MCP-Toolsets": "repos,wiki,wit"
      }
    }
  },
  "inputs": []
}

Schreibgeschützte Tools

Verwenden Sie den X-MCP-Readonly Header, um den Server auf schreibgeschützte Vorgänge zu beschränken. Diese Einschränkung ist nützlich, wenn Sie Änderungen an Azure DevOps Ressourcen verhindern möchten.

{
  "servers": {
    "ado-remote-mcp": {
      "url": "https://mcp.dev.azure.com/{organization}",
      "type": "http",
      "headers": {
        "X-MCP-Readonly": "true"
      }
    }
  },
  "inputs": []
}

Kombinieren von Toolsets und schreibgeschützter Filterung

{
  "servers": {
    "ado-remote-mcp": {
      "url": "https://mcp.dev.azure.com/{organization}",
      "type": "http",
      "headers": {
        "X-MCP-Toolsets": "repos,wiki,wit",
        "X-MCP-Readonly": "true"
      }
    }
  },
  "inputs": []
}

Einzelne Werkzeuge

Verwenden Sie die X-MCP-Tools Kopfzeile, um nur bestimmte Tools zu aktivieren. Sollte nicht mit X-MCP-Toolsets kombiniert werden.

Geben Sie Die Toolnamen an, die in der Liste der verfügbaren Tools angezeigt werden. Wählen Sie bei konsolidierten Tools wie wit_work_item den Vorgang über den action-Parameter des Tools aus, wenn Sie es aufrufen.

{
  "servers": {
    "ado-remote-mcp": {
      "url": "https://mcp.dev.azure.com/{organization}",
      "type": "http",
      "headers": {
        "X-MCP-Tools": "core_list_projects, wit_work_item"
      }
    }
  },
  "inputs": []
}

Insider

Wenn wir neue Tools testen und Aktualisierungen zu bestehenden hinzufügen, können Sie mithilfe des X-MCP-Insiders Headers frühzeitig auf diese Änderungen zugreifen.

{
  "servers": {
    "ado-remote-mcp": {
      "url": "https://mcp.dev.azure.com/{organization}",
      "type": "http",
      "headers": {
        "X-MCP-Insiders": "true"
      }
    }
  },
  "inputs": []
}

Verfügbare Tools

Kerntools

Kerntools sind immer verfügbar, sofern nicht anders angegeben.

Arbeit

Die Arbeitstools werden mithilfe eines action-Parameters in gruppierte Verteiler konsolidiert.

Repos

Die Repository-Tools werden mithilfe des Parameters action zu gruppierten Dispatchern zusammengefasst.

Wit

Die Arbeitsaufgabentools werden mithilfe eines action-Parameters in gruppierte Verteiler konsolidiert.

Pipelines

Die Pipeline-Tools werden mithilfe des Parameters action zu gruppierten Dispatchern zusammengefasst.

Wiki

Die Wiki-Lesevorgänge werden in einem einzigen wiki Tool konsolidiert. Verwenden Sie den action Parameter, um den Vorgang auszuwählen.

Pläne testen

Die Testplantools werden mithilfe eines action-Parameters in gruppierte Verteiler konsolidiert.

Erweiterte Sicherheit

Die Advanced Security-Tools werden in einem gruppierten Dispatcher konsolidiert, der einen action Parameter verwendet.

Enterprise Live Migration (Vorschau)

Die Enterprise Live-Migrationstools verwenden einen action Parameter zum Gruppieren und Verteilen von Aufgaben. Erfahren Sie mehr über die Enterprise Live Migration Preview.

Um nur die Enterprise-Live-Migrationstools bereitzustellen, verwenden Sie den Header X-MCP-Toolsets mit dem Wert elm:

{
  "servers": {
    "ado-remote-mcp": {
      "url": "https://mcp.dev.azure.com/{organization}",
      "type": "http",
      "headers": {
        "X-MCP-Toolsets": "elm"
      }
    }
  },
  "inputs": []
}

Unterstützte Umgebungen

Der Remote-Azure DevOps MCP-Server erfordert Ihr Benutzerkonto und die Azure DevOps Organisation, um die Verbindung mit Microsoft Entra ID herzustellen.

Nicht alle MCP-Clients unterstützen standardmäßig Microsoft Entra Authentifizierung. Einige Umgebungen erfordern zusätzliche Schritte zum Registrieren der Clientanwendung.

Unterstützte Umgebungen für den Remoteendpunkt, wenn Microsoft Entra Authentifizierung verfügbar ist, umfassen:

• Visual Studio mit GitHub Copilot
• Visual Studio
• Microsoft Foundry
• Microsoft Copilot Studio
• GitHub Copilot-CLI
• GitHub Copilot App
• Cursor Desktop, Cursor Cloud Agents oder Claude Code mit einer benutzerdefinierten Microsoft Entra App-Registrierung

Visual Studio Code

So konfigurieren Sie den McP-Remoteserver in Visual Studio Code:

1. Fügen Sie Ihrem Repository eine .vscode/mcp.json Datei mit der zuvor gezeigten mcp.json Konfiguration hinzu.
2. Speichern Sie die Datei.
3. Öffnen Sie GitHub Copilot in VS Code.
4. Wenn Sie dazu aufgefordert werden, authentifizieren Sie sich mit Ihrem Microsoft Entra Konto, und wählen Sie Ihr Konto aus.

Nach Abschluss der Authentifizierung wird eine Liste der verfügbaren Tools angezeigt.

Visual Studio (2022 und höher)

Konfigurieren Sie den MCP-Remoteserver in Visual Studio, indem Sie die Server-URL zu Ihren MCP-Einstellungen hinzufügen. Weitere Informationen finden Sie unter Use MCP servers in Visual Studio.

Auswählen von OAuth-Bereichen für benutzerdefinierte Clients

Wenn Sie einen benutzerdefinierten MCP-Client registrieren, erteilen Sie nur die delegierten Berechtigungen, die für die vom Client ausgeführten Azure DevOps Vorgänge erforderlich sind. OAuth-Bereiche bestimmen, auf welche Azure DevOps Ressourcen und Vorgänge der Client zugreifen kann. Das Aktivieren eines MCP-Tools oder eines Toolsets verleiht keine zusätzlichen Berechtigungen.

Folgen Sie dem Prinzip der geringsten Rechte:

• Gewähren Sie Leseberechtigungen, wenn der Client nur MCP-Tools mit Lesezugriff verwendet.
• Erteilen Sie Schreib- oder Verwaltungsberechtigungen nur, wenn der Client die entsprechenden Schreibvorgänge benötigt.
• Überprüfen Sie geerbte Bereiche, um redundante Berechtigungen zu vermeiden.

Die verfügbaren Bereiche und ihre Beziehungen finden Sie unter OAuth-Bereiche.

OAuth-Bereiche überschreiben nicht die Berechtigungen des angemeldeten Benutzers. Ein MCP-Vorgang ist nur erfolgreich, wenn sowohl der Anwendungsbereich als auch die Azure DevOps Berechtigungen des Benutzers dies zulassen.

Cursor

Cursor erfordert eine benutzerdefinierte Microsoft Entra App-Registrierung für den Zugriff auf den Remote-Azure DevOps MCP-Server.

Registrieren der Anwendung für Cursordesktop

1. Vergewissern Sie sich, dass die Azure DevOps MCP-Unternehmensanwendung in Ihrem Mandanten bereitgestellt wird. Wenn Sie diese nicht finden können, lesen Sie Die Azure DevOps MCP-Unternehmensanwendung im Mandanten kann nicht gefunden werden.
2. Wechseln Sie im Microsoft Entra Admin Center zu App-Registrierungen, und erstellen Sie dann eine App-Registrierung.
3. Wählen Sie in der App-Registrierung die Option "Authentifizierung (Vorschau)>Umleitungs-URI>Mobile- und Desktopanwendungen hinzufügen" aus.
4. Geben Sie http://localhost:8787/callback als Umleitungs-URI ein, und speichern Sie die Änderungen.
5. Wählen Sie auf der Seite "Authentifizierung (Vorschau) " die Registerkarte "Einstellungen " aus, und aktivieren Sie dann " Öffentliche Clientflüsse zulassen".
6. Wählen Sie auf der Seite "API-Berechtigungen" die Option "Berechtigungs-APIs >hinzufügen" aus, die meine Organisation verwendet.
7. Suchen Sie nach Azure DevOps MCP oder der Anwendungs-ID2a72489c-aab2-4b65-b93a-a91edccf33b8, und wählen Sie dann die Anwendung aus.
8. Wählen Sie die delegierten Berechtigungen aus, die Ihr Client benötigt, und wählen Sie dann den OAuth-Bereichsleitfaden aus, und wählen Sie dann "Berechtigungen hinzufügen" aus.
9. Wählen Sie Administratoreinwilligung erteilen aus. Je nach Ihrer Rolle muss ein Mandantenadministrator diesen Schritt möglicherweise ausführen.

Kopieren Sie die Anwendungs-ID (Client-ID) aus der App-Registrierung. Sie benötigen diesen Wert, um den Cursor zu konfigurieren.

Konfigurieren des Cursordesktops

1. Öffnen Sie in Cursor Einstellungen>Tools & MCP.

2. Wählen Sie "Neuer MCP-Server" aus.

3. Fügen Sie die folgende Konfiguration hinzu, und ersetzen Sie dabei {client-id} durch die Anwendungs-ID (Client-ID), die Sie kopiert haben:

   {
     "mcpServers": {
       "ado": {
         "url": "https://mcp.dev.azure.com",
         "type": "http",
         "auth": {
           "CLIENT_ID": "{client-id}"
         }
       }
     }
   }
   

4. Speichern Sie die Konfiguration, und kehren Sie dann zu "Einstellungentools>" und "MCP" zurück.

5. Suchen Sie den ado-Server , und wählen Sie dann "Authentifizieren" aus.

Konfigurieren von Cursor-Cloud-Agents

Cursor Cloud Agents erfordern zusätzlich zur benutzerdefinierten Microsoft Entra App-Registrierung einen Webumleitungs-URI und einen geheimen Clientschlüssel.

1. Öffnen Sie im Microsoft Entra Admin Center die App-Registrierung, die Sie für Cursor erstellt haben.

2. Wählen Sie Authentifizierung (Vorschau)>Umleitungs-URI hinzufügen>Web aus.

3. Geben Sie https://www.cursor.com/agents/mcp/oauth/callback als Umleitungs-URI ein, und speichern Sie die Änderungen.

4. Wählen Sie Zertifikate und Geheimnisse>Clientgeheimnisse>Neues Clientgeheimnis aus.

5. Geben Sie eine Beschreibung ein, wählen Sie einen Ablaufzeitraum aus, und wählen Sie dann "Hinzufügen" aus.

6. Kopieren Sie den Wert des Clientgeheimnisses. Der Wert wird nur einmal angezeigt.

7. Öffnen Sie im Cursor die McP-Serverkonfiguration für Cloud-Agents, und fügen Sie den benutzerdefinierten MCP-Server hinzu oder bearbeiten Sie sie.

8. Legen Sie die Server-URL auf https://mcp.dev.azure.com.

9. Geben Sie die Anwendungs-ID (Client-ID) aus Ihrer App-Registrierung in client-ID und den Wert des geheimen Clientschlüssels in den geheimen Clientschlüssel ein.

   Alternativ können Sie die JSON-Konfiguration bearbeiten und die Platzhalter durch Ihre App-Registrierungswerte ersetzen:

   {
     "mcpServers": {
       "ado": {
         "url": "https://mcp.dev.azure.com",
         "type": "http",
         "auth": {
           "CLIENT_ID": "{client-id}",
           "CLIENT_SECRET": "{client-secret}"
         }
       }
     }
   }
   

10. Speichern Sie die Konfiguration, und wählen Sie dann "BeiCursor Cloud Agents anmelden" aus, um Microsoft Entra Authentifizierung abzuschließen.

Wenn Microsoft Entra Fehler AADSTS50011 zurückgibt, vergewissern Sie sich, dass die Webumleitungs-URI exakt mit https://www.cursor.com/agents/mcp/oauth/callback übereinstimmt. Wenn der Tokenaustausch mit einem Fehler AADSTS7000218fehlschlägt, stellen Sie sicher, dass der aktuelle geheime Clientschlüsselwert in Cursor Cloud Agents konfiguriert ist.

Claude Code

Claude Code erfordert eine benutzerdefinierte Microsoft Entra App-Registrierung, um auf den Remote-Azure DevOps MCP-Server zuzugreifen.

Registrieren der Anwendung

1. Vergewissern Sie sich, dass die Azure DevOps MCP-Unternehmensanwendung in Ihrem Mandanten bereitgestellt wird. Wenn Sie diese nicht finden können, lesen Sie Die Azure DevOps MCP-Unternehmensanwendung im Mandanten kann nicht gefunden werden.
2. Wechseln Sie im Microsoft Entra Admin Center zu App-Registrierungen, und erstellen Sie dann eine App-Registrierung.
3. Wählen Sie in der App-Registrierung die Option "Authentifizierung (Vorschau)>Umleitungs-URI>Mobile- und Desktopanwendungen hinzufügen" aus.
4. Geben Sie http://localhost:3118/callback als Umleitungs-URI ein, und speichern Sie die Änderungen.
5. Wählen Sie auf der Seite "Authentifizierung (Vorschau) " die Registerkarte "Einstellungen " aus, und aktivieren Sie dann " Öffentliche Clientflüsse zulassen".
6. Wählen Sie auf der Seite "API-Berechtigungen" die Option "Berechtigungs-APIs >hinzufügen" aus, die meine Organisation verwendet.
7. Suchen Sie nach Azure DevOps MCP oder der Anwendungs-ID2a72489c-aab2-4b65-b93a-a91edccf33b8, und wählen Sie dann die Anwendung aus.
8. Wählen Sie die delegierten Berechtigungen aus, die Ihr Client benötigt, und wählen Sie dann den OAuth-Bereichsleitfaden aus, und wählen Sie dann "Berechtigungen hinzufügen" aus.
9. Wählen Sie Administratoreinwilligung erteilen aus. Je nach Ihrer Rolle muss ein Mandantenadministrator diesen Schritt möglicherweise ausführen.

Kopieren Sie die Anwendungs-ID (Client-ID) aus der App-Registrierung. Sie benötigen diesen Wert, um Claude Code zu konfigurieren.

Konfigurieren von Claude Code

1. Führen Sie den folgenden Befehl aus, und ersetzen {client-id} Sie dabei durch die Anwendungs-ID (Client-ID), die Sie kopiert haben, und {organization} durch den Namen Ihrer Azure DevOps Organisation:

   claude mcp add --transport http ado https://mcp.dev.azure.com/{organization} \
     --client-id {client-id} --callback-port 3118
   

   Alternativ können Sie eine .mcp.json Datei im Stammverzeichnis Ihres Repositorys mit der folgenden Konfiguration erstellen:

   {
     "mcpServers": {
       "ado": {
         "type": "http",
         "url": "https://mcp.dev.azure.com/{organization}",
         "oauth": {
           "clientId": "{client-id}",
           "callbackPort": 3118
         }
       }
     }
   }
   

2. Starten Sie Claude Code, indem Sie ausführen claude.

3. Führen Sie /mcp aus, und folgen Sie anschließend dem Anmeldeablauf im Browser, um sich mit Ihrem Microsoft Entra-Konto anzumelden.

Weitere Informationen zu diesen Optionen finden Sie unter Verbinden von Claude Code mit Tools über MCP.

Überprüfen der Verbindung

Überprüfen Sie nach dem Setup, ob der MCP-Remoteserver funktioniert, indem Sie Ihrem KI-Assistenten eine Frage zu Ihren Azure DevOps Daten stellen.

Beispiele:

• "Listen Sie die Projekte in meiner Azure DevOps Organisation auf."
• "Meine zugewiesenen Arbeitsaufgaben anzeigen."
• "Welche Pull-Anforderungen erfordern meine Überprüfung?"

Wenn der KI-Assistent Ergebnisse aus Ihrer Azure DevOps Organisation zurückgibt, ist der MCP-Remoteserver ordnungsgemäß konfiguriert.

Verwenden von KI zum Überprüfen und Beheben von Remote-MCP-Setups

Die folgenden Beispiel-Prompts für Copilot Chat helfen Ihnen dabei, den richtigen MCP-Ansatz auszuwählen, die Remotekonfiguration einzurichten und zu validieren, Prompts für die tägliche Nutzung zu verbessern und bei Bedarf Fehler zu beheben. Kopieren Und einfügen Sie diese Eingabeaufforderungen in Copilot Chat, und ersetzen Sie Platzhalter durch Ihre tatsächliche Organisation, Ihren Client und Fehlerdetails.

Copilot wird von KI unterstützt. Daher sind Überraschungen und Fehler möglich. Weitere Informationen finden Sie in den häufig gestellten Fragen zur allgemeinen Verwendung von Copilot.

Problembehandlung

Zur Unterstützung können Sie ein Problem im lokalen MCP Server-Repository erstellen. Achten Sie darauf, die Remote-Problemvorlage zu verwenden.

Häufig gestellte Fragen

Was ist mit anderen Clients wie Claude Desktop oder Codex?

Claude Desktop und Codex erfordern eine dynamische Registrierung einer OAuth-Client-ID in Microsoft Entra ID, bevor sie den Remote-MCP-Server verwenden können. Microsoft Entra ID unterstützt derzeit nicht den dynamischen Clientregistrierungsfluss, den diese Clients benötigen. Verwenden Sie den lokalen MCP-Server mit diesen Clients.

Verwandte Inhalte

• übersicht über Azure DevOps MCP Server
• Azure DevOps MCP Server GitHub Repository