Problembehandlung für den Remote-Azure DevOps MCP-Server

Azure DevOps Services

In diesem Artikel können Sie häufige Probleme mit dem remote Azure DevOps MCP Server diagnostizieren und beheben. Informationen zu lokalen MCP-Serverproblemen finden Sie im Handbuch zur Problembehandlung für den lokalen MCP-Server.

Verbindungsfehler

Server nicht gefunden oder URL-Fehler

Symptom: Ihr KI-Assistent kann keine Verbindung mit dem REMOTE-MCP-Server herstellen, oder es werden URL-bezogene Fehler angezeigt.

Auflösung:

1. Überprüfen Sie das Server-URL-Format in Ihrem mcp.json:

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

2. Überprüfen Sie Folgendes:

   • Verwenden Sie https://mcp.dev.azure.com/{organization} — ersetzen Sie {organization} durch Ihren tatsächlichen Organisationsnamen.
   • Verwenden Sie nur den Organisationsnamen (z. B. contoso), nicht die vollständige Azure DevOps-URL.
   • Dies type darf "http"nicht "stdio"sein.

3. Wenn Sie den Organisationsnamen aus der URL (https://mcp.dev.azure.com/) weglassen, müssen Sie den Organisationsnamen in jedem Toolaufruf als Kontext angeben.

Netzwerk- oder Firewallblockierungen

Symptom: Bei der Verbindung tritt eine Zeitüberschreitung auf oder sie wird zurückgewiesen, aber die URL ist korrekt.

Auflösung:

• Stellen Sie sicher, dass Ihr Netzwerk ausgehenden HTTPS-Datenverkehr zu mcp.dev.azure.com zulässt.
• Wenn Sie sich hinter einem Unternehmensproxy oder einer Firewall befinden, überprüfen Sie, ob mcp.dev.azure.com nicht blockiert wird. Wenden Sie sich an Ihren Netzwerkadministrator, um diesen Endpunkt auflisten zu können.
• VPN-Konfigurationen können die Verbindung beeinträchtigen. Versuchen Sie, eine Verbindung ohne VPN herzustellen, um das Problem zu isolieren.

Verfügbarkeit der Vorschau

Symptom: Es wird ein Fehler angezeigt, der angibt, dass der Dienst nicht verfügbar ist.

Auflösung:

Der MCP-Remoteserver befindet sich in der öffentlichen Vorschau und wird schrittweise eingeführt. Wenn Sie keine Verbindung herstellen können:

• Überprüfen Sie, ob Ihre Organisation mit Microsoft Entra ID verbunden ist.
• Schauen Sie später wieder vorbei, da die Vorschau weiter erweitert wird.
• Bestätigen Sie mit Ihrem Organisationsadministrator, dass keine Richtlinien Vorschaufeatures blockieren.

Authentifizierungsfehler

Der MCP-Remoteserver verwendet Microsoft Entra ID (OAuth) für die Authentifizierung. Persönliche Zugriffstoken (PATs) werden für den Remoteserver nicht unterstützt.

Anmeldeaufforderung schlägt fehl oder wird nicht angezeigt

Symptom: Die OAuth-Anmeldeaufforderung wird nicht angezeigt, oder die Authentifizierung schlägt fehl, bevor Sie sich anmelden können.

Auflösung:

1. Überprüfen Sie, ob Ihr Konto mit Microsoft Entra ID verbunden ist. Für den Remote-MCP-Server ist eine Microsoft Entra gesicherte Identität erforderlich.
2. Überprüfen Sie, ob Ihr Browser für den OAuth-Fluss geöffnet werden kann. Wenn Sie VS Code in einer Remote- oder Headless-Umgebung verwenden, funktioniert die OAuth-Umleitung möglicherweise nicht ordnungsgemäß.
3. Zwischengespeicherte Anmeldeinformationen löschen:
   • Öffnen Sie in VS Code die Befehlspalette (STRG+UMSCHALT+P) und starten Sie Konten: Abmelden. Versuchen Sie dann erneut, die Verbindung herzustellen.
   • Wenn das Problem weiterhin besteht, laden Sie das VS-Codefenster neu (Entwickler: Fenster neu laden).

Autorisierungsfehler nach der Anmeldung

Symptom: Sie melden sich erfolgreich an, erhalten jedoch beim Versuch, auf Ihre Organisation oder Ihr Projekt zuzugreifen, einen Autorisierungsfehler.

Auflösung:

• Vergewissern Sie sich, dass Sie die richtige Access-Ebene in der Azure DevOps Organisation haben.
• Überprüfen Sie, ob Sie Mitglied des Projekts sind, auf das Sie zugreifen möchten.
• Überprüfen Sie, ob Ihre Azure DevOps Berechtigungen den Zugriff auf die ressourcen umfassen, die Sie abfragen (z. B. Arbeitsaufgaben, Repositorys oder Pipelines).

Richtlinien für bedingten Zugriff blockieren den Zugriff

Symptom: Eine Microsoft Entra Conditional Access-Richtlinie blockiert Ihre Anmeldung.

Auflösung:

Richtlinien für bedingten Zugriff gelten für den Remote-MCP-Server auf die gleiche Weise wie für Azure DevOps. Wenn Ihr Mandant Richtlinien wie standortbasierte oder gerätebasierte Einschränkungen erzwingt:

• Stellen Sie sicher, dass Sie sich von einem konformen Gerät und einem konformen Netzwerkstandort aus anmelden.
• Wenn Ihr Mandant standortbasierte Conditional Access-Richtlinien verwendet, muss Ihr Microsoft Entra ID-Administrator die IP-Adressen des Remote-MCP-Servers möglicherweise auf die Zulassungsliste setzen: 20.125.155.22 und 40.74.28.81.
• Wenden Sie sich an Ihren Microsoft Entra ID-Administrator, um bestimmte Richtlinienanforderungen zu erfüllen.

Fehler beim Gastzugriff (B2B)

Symptom: Ein Gastbenutzer im Microsoft Entra Mandanten kann nicht auf den Remote-MCP-Server zugreifen.

Auflösung:

Damit der Gastzugriff funktioniert, muss der Benutzer folgendes sein:

1. Wird dem Microsoft Entra-Mandanten als Gastbenutzer hinzugefügt.
2. Der Azure DevOps-Organisation mit entsprechenden Berechtigungen hinzugefügt.
3. Gewährten Zugriff auf die spezifischen Projekte und Ressourcen, die sie benötigen.
4. Verwenden der organisationsspezifischen URL (https://mcp.dev.azure.com/{organization}). Gastbenutzer können die Stamm-URL (https://mcp.dev.azure.com/) nicht verwenden . Sie müssen den Organisationsnamen in die URL einschließen.

Wenn eines dieser Schritte fehlt, schlägt der Zugriff fehl. Behandeln Sie dieses Problem wie ein standardmäßiges Problem mit dem Azure DevOps-Gastzugriff.

AADSTS Fehlercodes

Symptom: Es wird ein Fehlercode angezeigt, AADSTSder mit AADSTS50076 (z. B. , AADSTS700016) beginnt.

Auflösung:

AADSTS Fehler sind Microsoft Entra ID Authentifizierungsfehler, nicht MCP-spezifische Probleme. Zu den gängigen Codes gehören:

Eine vollständige Liste der Fehlercodes finden Sie unter Microsoft Entra Authentifizierungs- und Autorisierungsfehlercodes.

Serverkonfigurationsprobleme

Falsche mcp.json Konfiguration

Symptom: Der Remote-MCP-Server stellt zwar eine Verbindung her, aber die Tools werden nicht geladen, oder es kommt zu unerwartetem Verhalten.

Auflösung:

Vergewissern Sie sich, dass Ihr mcp.json das richtige Format für den Remote-Server verwendet:

• Remoteserver verwendet "type": "http" und "url".
• Lokaler Server verwendet "type": "stdio", "command"und "args".

Mischen Sie keine Remote- und lokalen Konfigurationsformate. Führen Sie nicht beide Server gleichzeitig aus – wählen Sie eine aus:

• Remote server – Wird für Visual Studio Code und Visual Studio verwendet. Keine lokale Installation erforderlich.
• Local-Server – Wird für Nicht-Microsoft-Clients (Claude Desktop, Claude Code, Cursor, Codex) verwendet, die Microsoft Entra Authentifizierung nicht unterstützen.

Toolset- oder Toolfilterung funktioniert nicht

Symptom: Sie konfigurieren X-MCP-Toolsets oder X-MCP-Tools Kopfzeilen, aber die Toolliste stimmt nicht mit den Erwartungen überein.

Auflösung:

• Kombinieren Sie X-MCP-Toolsets- und X-MCP-Tools-Kopfzeilen nicht – sie schließen sich gegenseitig aus.
• Überprüfen Sie, ob die Toolsetnamen korrekt sind: repos, wit, , wiki, pipelines, work. testplan
• Geben Sie bei Verwendung X-MCP-Toolsgenaue Toolnamen durch Kommas getrennt an.
• Prüfen Sie Header-Namen auf Tippfehler – bei Headern wird zwischen Groß- und Kleinschreibung unterschieden.

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

Die vollständige Liste der verfügbaren Toolsets und Tools finden Sie unter "Verfügbare Tools".

Nur-Lese-Modus schränkt Schreibzugriffe nicht ein

Symptom: Sie setzen X-MCP-Readonly, aber Schreibvorgänge sind weiterhin möglich.

Auflösung:

Überprüfen Sie, ob der Headerwert die Zeichenfolge "true"ist:

"headers": {
  "X-MCP-Readonly": "true"
}

Fehler bei der Tool-Auflösung

Tools, die nicht im KI-Assistenten angezeigt werden

Symptom: Nachdem Sie den MCP-Remoteserver verbunden haben, werden keine Azure DevOps Tools in Ihrem KI-Assistenten angezeigt.

Auflösung:

1. Vergewissern Sie sich, dass der Serverstatus in Ihrer IDE als verbunden angezeigt wird.
   • In VS Code, Überprüfen Sie den MCP-Serverstatus im Ausgabebereich (View>Output> wählen Sie GitHub Copilot oder MCP aus der Dropdownliste aus).
2. Laden Sie das VS Code-Fenster neu (STRG+UMSCHALT+P>Entwickler: Fenster neu laden).
3. Vergewissern Sie sich, dass Sie sich im agentmodus befinden in GitHub Copilot– MCP-Tools werden nur im Agentmodus und nicht im Chatmodus angezeigt.
4. Überprüfen Sie, ob Sie den Grenzwert von 128 Tools nicht überschreiten. Wenn sie mehrere MCP-Server konfiguriert haben, kann die Kombinierte Toolanzahl diesen Grenzwert überschreiten.

Fehler aufgrund fehlender erforderlicher Parameter

Symptom: Toolaufrufe schlagen mit fehlern "fehlender erforderlicher Parameter" fehl, in der Regel für den Projektnamen.

Auflösung:

Dieser Fehler ist der am häufigsten gemeldete Fehler und wird erwartet. Viele Tools erfordern einen Projektnamen oder einen anderen Kontext:

• Fügen Sie den Projektnamen in die Eingabeaufforderung ein: "Arbeitsaufgaben im Contoso-Projekt auflisten".
• Wenn Sie die Organisation aus Ihrer URL weggelassen haben, schließen Sie auch die Organisation in Ihre Eingabeaufforderung ein.
• Für einige Tools sind bestimmte Parameter erforderlich. Überprüfen Sie die Dokumentation der verfügbaren Tools auf erforderliche Parameter.

Toolaufruf schlägt mit Serverfehler fehl

Symptom: Ein Toolaufruf gibt einen Serverfehler zurück, nachdem er ordnungsgemäß aufgerufen wurde.

Auflösung:

• Überprüfen Sie, ob die Ressource, die Sie abfragen, vorhanden ist (z. B. die Arbeitsaufgaben-ID, der Repositoryname oder die Pipeline-ID ist korrekt).
• Bestätigen Sie, dass Sie über Berechtigungen für den Zugriff auf die Ressource verfügen.
• Wenn der Fehler weiterhin besteht, erstellen Sie ein Problem mithilfe der Remote MCP Server-Problemvorlage.

Probleme bei der Copilot-Integration

DER KI-Assistent verwendet keine MCP-Tools.

Symptom: GitHub Copilot antwortet auf Ihre Frage, verwendet jedoch nicht Azure DevOps MCP-Tools zum Abrufen von Daten.

Auflösung:

1. Stellen Sie sicher, dass Sie agentmodus in GitHub Copilot verwenden. MCP-Tools sind im Standardchatmodus nicht verfügbar.
2. Geben Sie in Ihrer Aufforderung explizit an, welche Azure DevOps Daten Sie benötigen. Versuchen Sie z. B. anstelle von "Was ist mein Sprintstatus?", "Verwenden Sie Azure DevOps, um meine aktuellen Sprintaufgaben abzurufen.".
3. Überprüfen Sie, ob der MCP-Server als mit einem grünen Statusindikator verbunden angezeigt wird.

Veraltete oder zwischengespeicherte Daten, die zurückgegeben werden

Symptom: Der KI-Assistent gibt veraltete Azure DevOps Daten zurück.

Auflösung:

Fügen Sie Ihrer Eingabeaufforderung "Zuvor abgerufene Daten nicht verwenden" hinzu, um eine neue Abfrage zu erzwingen. KI-Assistenten können Toolergebnisse innerhalb einer Unterhaltungssitzung zwischenspeichern.

Agent schlägt vor dem Toolaufruf fehl

Symptom: Der KI-Assistent schlägt fehl oder gibt einen Fehler aus, bevor ein MCP-Tool aufgerufen wird.

Auflösung:

Dieses Problem liegt außerhalb der Azure DevOps MCP-Grenze. Der Fehler tritt in der Orchestrierungsebene des KI-Assistenten auf:

• Informationen zu GitHub Copilot Problemen finden Sie in der Dokumentation GitHub Copilot.
• Starten Sie den KI-Assistenten neu, und versuchen Sie es erneut.
• Wenn das Problem weiterhin besteht, melden Sie es Ihrem KI-Assistentenanbieter.

Nicht unterstützte Clientfehler

Nicht Microsoft Clients können sich nicht authentifizieren

Symptom: Clients wie Claude Desktop, Claude Code, Cursor oder Codex können den OAuth-Handshake nicht mit dem Remote-MCP-Server abschließen.

Auflösung:

Nicht Microsoft Clients können sich nicht mit dem Remote-MCP-Server authentifizieren, da Microsoft Entra ID derzeit keine dynamische Clientregistrierung unterstützt, die diese Clients erfordern.

Derzeit unterstützte Clients:

• Visual Studio Code
• Visual Studio (2022 und höher)

Verwenden Sie für Nicht-Microsoft Clients stattdessen den local Azure DevOps MCP Server mit PAT oder Azure CLI Authentifizierung. Führen Sie sowohl die Remote- als auch die lokalen Server nicht gleichzeitig aus – wählen Sie die Server aus, die Ihrem Client entsprechen.

Diagnosetipps

Aktivieren der Debugprotokollierung in VS Code

So erfassen Sie bei der Problembehandlung weitere Details:

1. Öffnen Sie den Ausgabebereich in VS Code (Ausgabe anzeigen>).
2. Wählen Sie GitHub Copilot oder MCP aus der Dropdownliste des Ausgabekanals aus.
3. Suchen Sie nach Verbindungsstatus, Authentifizierungsflussdetails und Fehlermeldungen.

Die Verbindung prüfen

Testen Sie nach dem Setup den MCP-Remoteserver mit einer einfachen Abfrage:

• "Listen Sie die Projekte in meiner Azure DevOps-Organisation auf."
• "Meine zugewiesenen Arbeitsaufgaben anzeigen."
• Welche Pull Requests müssen von mir überprüft werden?

Wenn diese Abfragen korrekte Daten zurückgeben, funktioniert der Server ordnungsgemäß.

Häufig gestellte Fragen

Kann ich den MCP-Remoteserver mit einem persönlichen Microsoft-Konto verwenden?

Nein Der Remote-MCP-Server erfordert, dass Ihre Azure DevOps Organisation mit Microsoft Entra ID verbunden ist. Persönliche Microsoft-Konten (MSA) werden nicht unterstützt.

Sollte ich den Remote- oder lokalen MCP-Server verwenden?

Verwenden Sie den Remoteserver, wenn Ihr Client ihn unterstützt (Visual Studio Code oder Visual Studio). Verwenden Sie den lokalen Server nur, wenn Sie einen Nicht-Microsoft-Client wie Claude Desktop, Claude Code, Cursor oder Codex verwenden. Führen Sie nicht beide Server gleichzeitig aus.

Warum werden verschiedene Tools mit dem Remoteserver und dem lokalen Server angezeigt?

Die Remote- und lokalen Server befinden sich möglicherweise in unterschiedlichen Versionen. Der Remoteserver wird unabhängig vom lokalen npm-Paket aktualisiert. Verwenden Sie den X-MCP-Insiders Header, um auf die neuesten Remotetools zuzugreifen. Aktualisieren Sie für den lokalen Server das npm-Paket auf die neueste Version.

Funktioniert der MCP-Server mit Azure DevOps Server (lokal)?

Nein Weder der Remoteserver noch der lokale MCP-Server unterstützt Azure DevOps Server (lokal). Für beide Server sind Azure DevOps Services (Cloud) erforderlich.

Auf welche Daten greift der MCP-Remoteserver zu?

Der Remote-Server greift auf dieselben Azure-DevOps-Daten wie die REST-API zu, entsprechend Ihren Berechtigungen. Sie greift nicht auf Daten zu, die nicht über die Berechtigungen Ihrer Microsoft Entra Identität hinausgehen.

Wie kann ich ein Problem mit dem MCP-Remoteserver melden?

Erstellen Sie ein Problem mithilfe der Problemvorlage Remote MCP Server im Azure DevOps MCP Server GitHub Repository.

Verwandte Inhalte

• Einrichten des MCP-Remoteservers von Azure DevOps (Vorschau)
• Übersicht über azure DevOps MCP Server
• Azure DevOps MCP Server GitHub Repository