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 distansarbete i första hand

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 närvarande för klienter som Claude Desktop och Codex. Cursor och Claude Code kräver en anpassad Microsoft Entra-appregistrering för autentisering. 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.

Om du endast vill göra Enterprise Live Migration-verktygen tillgängliga använder du headern X-MCP-Toolsets 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
• Cursor-datorapp, Cursor Cloud Agents eller Claude Code med en anpassad Microsoft Entra-appregistrering

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.

Välj OAuth-omfång för anpassade klienter

När du registrerar en anpassad MCP-klient beviljar du endast de delegerade behörigheter som krävs för de Azure DevOps åtgärder som klienten utför. OAuth-omfång avgör vilka Azure DevOps resurser och åtgärder som klienten kan komma åt. Att aktivera ett MCP-verktyg eller en verktygsuppsättning ger inte ytterligare behörigheter.

Följ principen om lägsta behörighet:

• Bevilja läsbehörigheter när klienten endast använder MCP-verktyg med endast läsåtkomst.
• Bevilja endast skriv- eller hanteringsbehörigheter när klienten behöver motsvarande skrivåtgärder.
• Granska ärvda omfång för att undvika att bevilja redundanta behörigheter.

Information om tillgängliga behörigheter och relationerna mellan dem finns i OAuth-behörigheter.

OAuth-omfång åsidosätter inte behörigheterna för den inloggade användaren. En MCP-åtgärd lyckas bara när både programmets omfång och användarens Azure DevOps behörigheter tillåter det.

Cursor

Cursor kräver en anpassad appregistrering i Microsoft Entra för att få åtkomst till den fjärranslutna Azure DevOps MCP-servern.

Registrera programmet för Cursor Desktop

1. Bekräfta att det Azure DevOps MCP-företagsprogrammet har etablerats i din klientorganisation. Om du inte hittar det, se Det går inte att hitta Azure DevOps MCP-företagsappen i klienten.
2. I Microsoft Entra administrationscenter går du till App registrations och skapar sedan en appregistrering.
3. I appregistreringen väljer du Autentisering (förhandsversion)>Lägg till omdirigerings-URI>Mobile- och skrivbordsprogram.
4. Ange http://localhost:8787/callback som omdirigerings-URI och spara sedan ändringarna.
5. På sidan Autentisering (förhandsversion) väljer du fliken Inställningar och aktiverar sedan Tillåt offentliga klientflöden.
6. På sidan API-behörigheter väljer du Lägg till en behörighet>API:er som min organisation använder.
7. Sök efter Azure DevOps MCP eller program-ID 2a72489c-aab2-4b65-b93a-a91edccf33b8och välj sedan programmet.
8. Välj de delegerade behörigheter som klienten behöver, följ riktlinjerna för OAuth-omfång och välj sedan Lägg till behörigheter.
9. Välj Bevilja administratörsmedgivande. Beroende på din roll kan en klientadministratör behöva slutföra det här steget.

Kopiera program-ID :t (klient) från appregistreringen. Du behöver det här värdet för att konfigurera markören.

Konfigurera skrivbordsappen Cursor

1. Öppna Inställningsverktyg>och MCP i Markören.

2. Välj Ny MCP-server.

3. Lägg till följande konfiguration och {client-id} ersätt med det program-ID (klient)-ID som du kopierade:

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

4. Spara konfigurationen och gå sedan tillbaka till Inställningsverktyg>och MCP.

5. Leta upp ado-servern och välj sedan Autentisera.

Konfigurera markörmolnagenter

Cursor Cloud Agents kräver en webbomdirigerings-URI och en klienthemlighet utöver den anpassade appregistreringen i Microsoft Entra.

1. I Microsoft Entra administrationscenter öppnar du appregistreringen som du skapade för Cursor.

2. Välj Autentisering (förhandsversion)>Lägg till omdirigerings-URI>Web.

3. Ange https://www.cursor.com/agents/mcp/oauth/callback som omdirigerings-URI och spara sedan ändringarna.

4. Välj Certifikat och hemligheter>Klienthemligheter>Ny klienthemlighet.

5. Ange en beskrivning, välj en förfalloperiod och välj sedan Lägg till.

6. Kopiera värdet för klienthemligheten. Värdet visas bara en gång.

7. Öppna MCP-serverkonfigurationen för molnagenter i Markören och lägg sedan till eller redigera den anpassade MCP-servern.

8. Ange server-URL:en till https://mcp.dev.azure.com.

9. Ange programmets (klientens) ID från appregistreringen i Klient-ID och värdet för klienthemlighet i Klienthemlighet.

   Du kan också redigera JSON-konfigurationen och ersätta platshållarna med dina appregistreringsvärden:

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

10. Spara konfigurationen och välj sedan Logga in från Cursor Cloud Agents för att slutföra Microsoft Entra-autentisering.

Om Microsoft Entra returnerar felet AADSTS50011kontrollerar du att webbomdirigerings-URI:n exakt matchar https://www.cursor.com/agents/mcp/oauth/callback. Om tokenutbytet misslyckas med felet AADSTS7000218, kontrollera att det aktuella värdet för klienthemligheten är konfigurerat i Cursor Cloud Agents.

Claude Code

Claude Code kräver en anpassad Microsoft Entra appregistrering för att få åtkomst till den fjärranslutna Azure DevOps MCP-servern.

Registrera programmet

1. Bekräfta att det Azure DevOps MCP-företagsprogrammet har etablerats i din klientorganisation. Om du inte hittar det, se Det går inte att hitta Azure DevOps MCP-företagsappen i klienten.
2. I Microsoft Entra administrationscenter går du till App registrations och skapar sedan en appregistrering.
3. I appregistreringen väljer du Autentisering (förhandsversion)>Lägg till omdirigerings-URI>Mobile- och skrivbordsprogram.
4. Ange http://localhost:3118/callback som omdirigerings-URI och spara sedan ändringarna.
5. På sidan Autentisering (förhandsversion) väljer du fliken Inställningar och aktiverar sedan Tillåt offentliga klientflöden.
6. På sidan API-behörigheter väljer du Lägg till en behörighet>API:er som min organisation använder.
7. Sök efter Azure DevOps MCP eller program-ID 2a72489c-aab2-4b65-b93a-a91edccf33b8och välj sedan programmet.
8. Välj de delegerade behörigheter som klienten behöver, följ riktlinjerna för OAuth-omfång och välj sedan Lägg till behörigheter.
9. Välj Bevilja administratörsmedgivande. Beroende på din roll kan en klientadministratör behöva slutföra det här steget.

Kopiera program-ID :t (klient) från appregistreringen. Du behöver det här värdet för att konfigurera Claude Code.

Konfigurera Claude Code

1. Kör följande kommando och ersätt {client-id} med det program-ID (klient)-ID som du kopierade och {organization} med ditt Azure DevOps organisationsnamn:

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

   Du kan också skapa en .mcp.json fil i roten på lagringsplatsen med följande konfiguration:

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

2. Starta Claude Code genom att köra claude.

3. Kör /mcpoch följ sedan webbläsarens inloggningsflöde för att autentisera med ditt Microsoft Entra-konto.

Mer information om de här alternativen finns i Ansluta Claude Code till verktyg via MCP.

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 eller Codex?

Claude Desktop och Codex 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