Einrichten des Remote-Azure DevOps MCP-Servers (Vorschau)

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.

Der Remoteserver bietet die gleichen Funktionen wie der lokale Server, einschließlich des Zugriffs auf Arbeitsaufgaben, Pullanforderungen, Pipelines und vieles mehr, während die Komplexität des lokalen Setups beseitigt wird.

Remote- und lokaler 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.

{
  "servers": {
    "ado-remote-mcp": {
      "url": "https://mcp.dev.azure.com/{organization}",
      "type": "http",
      "headers": {
        "X-MCP-Tools": "core_list_projects, wit_my_work_items, wit_get_work_items_batch_by_ids"
      }
    }
  },
  "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.

Arbeit

Repos

Die Repositorytools werden mithilfe eines action Parameters in gruppierte Verteiler konsolidiert, wobei dasselbe Muster wie die Wiki-Tools folgt. Die vorherigen Einzelnen Toolnamen funktionieren weiterhin als Aliase. Verwenden Sie repo_create_branch und repo_search_commits direkt — sie wurden nicht konsolidiert.

Witz

Pipelines

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

Suchen

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 die Entra-Authentifizierung. Einige Umgebungen erfordern zusätzliche Schritte zum Registrieren der Clientanwendung.

Derzeit unterstützte Umgebungen umfassen:

• Visual Studio Code
• Visual Studio

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.

Ü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.

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 GitHub Copilot CLI, Claude Desktop, Claude Code, CodeX oder Cursor?

Zusätzliche Clienttools wie CodeX, Claude Desktop, Claude Code und ChatGPT erfordern eine dynamische Registrierung einer OAuth-Client-ID in Entra, bevor sie mit dem MCP-Server verwendet werden können. Wir arbeiten eng mit dem Entra-Team zusammen, um diese Funktion zu ermöglichen. Derzeit werden nur Visual Studio und Visual Studio Code unterstützt.

Welche Dienste können Azure DevOps MCP-Server verwenden?

Unterstützung für andere Dienste, einschließlich Azure AI Foundry , Microsoft 365 Copilot und Copilot Studio, ist noch nicht verfügbar, wird aber in Kürze hinzugefügt.

Unterstützt der Azure DevOps MCP Server AgentId?

Der AgentId-Support wird in Kürze verfügbar sein.

Verwandte Inhalte

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