Konfigurera den fjärranslutna Azure DevOps MCP-servern (förhandsversion)

Azure DevOps-tjänster

Den fjärranslutna Azure DevOps MCP-servern är en värdbaserad version av Azure DevOps MCP Server som inte kräver någon lokal installation. I stället för att köra servern på datorn ansluter du AI-assistenten direkt till den Azure DevOps-värdbaserade slutpunkten med hjälp av strömmande HTTP-transport.

Fjärrservern har samma funktioner som den lokala servern, inklusive åtkomst till arbetsobjekt, pull-begäranden, pipelines med mera, samtidigt som den lokala konfigurationskomplexiteten elimineras.

Fjärr- eller lokal MCP-server

Förutsättningar

Konfiguration av mcp.json

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

Du kan också utelämna organisationsnamnet från URL:en. Men om du utelämnar organisationsnamnet måste du ange det som kontext i varje verktygsanrop.

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

Verktygsuppsättningar

Ange verktygsuppsättningar för att begränsa de verktyg som är tillgängliga för MCP-servern. Ska inte kombineras med X-MCP-Tools.

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

Skrivskyddade verktyg

Använd X-MCP-Readonly-huvudet för att begränsa servern till skrivskyddade åtgärder. Den här begränsningen är användbar när du vill förhindra ändringar av Azure DevOps resurser.

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

Kombinera verktygsuppsättningar och skrivskyddad filtrering

{
  "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": []
}

Enskilda verktyg

X-MCP-Tools Använd rubriken om du bara vill aktivera specifika verktyg. Ska inte kombineras med X-MCP-Toolsets.

{
  "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": []
}

Insiders

När vi experimenterar och introducerar nya verktyg och uppdateringar för befintliga kan du få tidig åtkomst till dessa ändringar med hjälp X-MCP-Insiders av rubriken.

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

Tillgängliga verktyg

Kärnverktyg

Kärnverktyg är alltid tillgängliga.

Arbete

Repos

Lagringsplatsens verktyg konsolideras i grupperade dispatchers med hjälp av en action parameter, enligt samma mönster som wiki-verktygen. De tidigare enskilda verktygsnamnen fortsätter att fungera som alias. Använd repo_create_branch och repo_search_commits direkt – de konsoliderades inte.

Wit

Arbetsobjektverktygen konsolideras till grupperade dispatcher med hjälp av en action parameter, enligt samma mönster som förråds- och pipelineverktygen. De tidigare enskilda verktygsnamnen fortsätter att fungera som alias. Använd search_workitem direkt – den konsoliderades inte.

Pipelines

Pipelineverktygen konsolideras till grupperade dispatchers med hjälp av en action-parameter, enligt samma mönster som wiki- och repo-verktygen. De tidigare enskilda verktygsnamnen fortsätter att fungera som alias.

Wiki

Wiki-läsåtgärderna konsolideras till ett enda wiki verktyg. Använd parametern action för att välja åtgärden.

Testplaner

Sök

Miljötyper som stöds

Den fjärranslutna Azure DevOps MCP-servern kräver att ditt användarkonto och Azure DevOps organisation ansluter till Microsoft Entra ID.

Alla MCP-klienter stöder inte Entra-autentisering som standard. Vissa miljöer kräver extra steg för att registrera klientprogrammet.

För närvarande stöds miljöer:

• Visual Studio Code
• Visual Studio

Visual Studio Code

Så här konfigurerar du den fjärranslutna MCP-servern i Visual Studio Code:

1. Lägg till en .vscode/mcp.json-fil på lagringsplatsen med den mcp.json-konfiguration som visats tidigare.
2. Spara filen.
3. Öppna GitHub Copilot i VS Code.
4. När du uppmanas till det autentiserar du med ditt Microsoft Entra konto och väljer ditt konto.

När autentiseringen är klar visas en lista över tillgängliga verktyg.

Visual Studio (2022 och senare)

Konfigurera den fjärranslutna MCP-servern i Visual Studio genom att lägga till server-URL:en i MCP-inställningarna. Mer information finns i Använda MCP-servrar i Visual Studio.

Verifiera anslutningen

Efter installationen kontrollerar du att mcp-fjärrservern fungerar genom att ställa en fråga till AI-assistenten om dina Azure DevOps data.

Exempel:

• "Lista projekten i min Azure DevOps organisation."
• "Visa mina tilldelade arbetsobjekt."
• "Vilka pull-begäranden kräver min granskning?"

Om AI-assistenten returnerar resultat från din Azure DevOps organisation är den fjärranslutna MCP-servern korrekt konfigurerad.

Felsökning

För support kan du skapa ett problem på den lokala MCP Server-lagringsplatsen. Se till att använda mallen Fjärrproblem .

Vanliga frågor och svar

Hur är det med andra klienter som GitHub Copilot CLI, Claude Desktop, Claude Code, CodeX eller Cursor?

Ytterligare klientverktyg som CodeX, Claude Desktop, Claude Code och ChatGPT kräver dynamisk registrering av ett OAuth-klient-ID i Entra innan de kan användas med MCP-servern. Vi har ett nära samarbete med Entra-teamet för att aktivera den här funktionen. För tillfället stöds endast Visual Studio och Visual Studio Code.

Vilka tjänster kan använda Azure DevOps MCP Server?

Stöd för andra tjänster, inklusive Azure AI Foundry, Microsoft 365 Copilot och Copilot Studio, är ännu inte tillgängligt men kommer att läggas till snart.

Supporterar Azure DevOps MCP Server AgentId?

AgentId-supporten kommer snart.

Relaterat innehåll

• Azure DevOps MCP Server-översikt
• Azure DevOps MCP Server GitHub lagringsplats