Konfigurera fjärrservern Azure DevOps MCP

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.

Välj fjärr först

Använd den fjärranslutna MCP-servern när din miljö stöder den. Fjärrservern är det rekommenderade alternativet eftersom Azure DevOps värdar och uppdaterar den och du inte behöver installera Node.js eller hantera en lokal serverprocess.

Använd den lokala MCP-servern när klienten inte kan autentisera till fjärrservern med Microsoft Entra ID. Den här begränsningen gäller för klienter som Claude Desktop, Claude Code, Cursor och Codex. Anvisningar för lokal installation finns i Aktivera AI-hjälp med Azure DevOps 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.

Ange verktygsnamn som visas i listan över tillgängliga verktyg . För konsoliderade verktyg som wit_work_itemväljer du åtgärden med hjälp av verktygets action parameter när du anropar den.

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

Arbete

Arbetsverktygen konsolideras i grupperade dispatchers med hjälp av en action parameter.

Repos

Lagringsplatsverktygen samlas i grupperade anropshanterare med parametern action.

Wit

Arbetsobjektverktygen konsolideras i grupperade dispatchers med hjälp av en action parameter.

Pipelines

Pipelineverktygen konsolideras till grupperade dispatchers med hjälp av parametern action.

Wiki

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

Testplaner

Testplansverktygen konsolideras i grupperade dispatchers med hjälp av en action parameter.

Avancerad säkerhet

Advanced Security-verktygen konsolideras till en grupperad dispatcher som använder en action parameter.

Enterprise Live Migration (förhandsversion)

Enterprise Live Migration-verktygen använder en action parameter för att gruppera och skicka uppgifter. Läs mer om förhandsversionen av Enterprise Live Migration.

Enterprise Live Migration-verktygen är inaktiverade som standard. Eftersom ELM-stöd i den fjärranslutna MCP-servern är en förhandsversion kräver de att din organisation har åtkomst till elm-begränsad offentlig förhandsversion. Om du vill aktivera ELM-verktygen X-MCP-Toolsets använder du huvudet med värdet elm :

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

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 Microsoft Entra autentisering som standard. Vissa miljöer kräver extra steg för att registrera klientprogrammet.

Miljöer som stöds för fjärrslutpunkten, när Microsoft Entra autentisering är tillgänglig, inkluderar:

• Visual Studio med GitHub Copilot
• Visual Studio
• Microsoft Foundry
• Microsoft Copilot Studio
• GitHub Copilot CLI
• GitHub-Copilot-appen

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.

Använda AI för att verifiera och felsöka mcp-fjärrkonfiguration

Följande exempelprompter för Copilot Chat hjälper dig att välja rätt MCP-metod, konfigurera och validera fjärrkonfigurationen, förbättra prompter för den dagliga användningen och felsöka problem vid behov. Kopiera och klistra in dessa frågor i Copilot Chat och ersätt platshållarna med din faktiska organisation, klient och felinformation.

Copilot drivs av AI, så överraskningar och misstag är möjliga. För mer information, se Vanliga frågor om allmänt bruk av Copilot.

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 Claude Desktop, Claude Code, Codex eller Cursor?

Claude Desktop, Claude Code, Codex och Cursor kräver dynamisk registrering av ett OAuth-klient-ID i Microsoft Entra ID innan de kan använda den fjärranslutna MCP-servern. Microsoft Entra ID stöder för närvarande inte det dynamiska klientregistreringsflöde som dessa klienter kräver. Använd den lokala MCP-servern med dessa klienter.

Relaterat innehåll

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