Felsöka fjärrservern Azure DevOps MCP

Azure DevOps-tjänster

Den här artikeln hjälper dig att diagnostisera och lösa vanliga problem med remote Azure DevOps MCP Server. Information om lokala MCP Server-problem finns i felsökningsguiden för den lokala MCP-servern.

Anslutningsfel

Servern hittades inte eller URL-fel

Symptom: AI-assistenten kan inte ansluta till den fjärranslutna MCP-servern, eller så visas URL-relaterade fel.

Upplösning:

1. Kontrollera server-URL-formatet i din mcp.json:

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

2. Kontrollera följande:

   • Använd https://mcp.dev.azure.com/{organization} – ersätt {organization} med ditt faktiska organisationsnamn.
   • Använd bara organisationsnamnet (till exempel contoso), inte den fullständiga Azure DevOps URL:en.
   • type Måste vara "http", inte "stdio".

3. Om du utelämnar organisationsnamnet från URL:en (https://mcp.dev.azure.com/) måste du ange organisationsnamnet som kontext i varje verktygsanrop.

Nätverks- eller brandväggsblock

Symptom: Anslutningen överskrider tidsgränsen eller nekas, men URL:en är korrekt.

Upplösning:

• Se till att nätverket tillåter utgående HTTPS-trafik till mcp.dev.azure.com.
• Om du är bakom en företagsproxy eller brandvägg, kontrollera att mcp.dev.azure.com inte är blockerad. Kontakta din nätverksadministratör för att lägga till den här ändpunkten i tillåtelselistan.
• VPN-konfigurationer kan störa anslutningen. Försök att ansluta utan VPN för att isolera problemet.

Förhandsgranska tillgänglighet

Symptom: Du får ett fel som anger att tjänsten inte är tillgänglig.

Upplösning:

Den fjärranslutna MCP-servern är i offentlig förhandsversion och lanseras gradvis. Om du inte kan ansluta:

• Kontrollera att din organisation är ansluten till Microsoft Entra ID.
• Kom tillbaka senare när förhandsgranskningen fortsätter att expandera.
• Bekräfta med organisationsadministratören att inga principer blockerar förhandsversionsfunktioner.

Autentiseringsfel

Den fjärranslutna MCP-servern använder Microsoft Entra ID (OAuth) för autentisering. Personliga åtkomsttoken (PAT) stöds inte för fjärrservern.

Inloggningsprompten misslyckas eller visas inte

Symptom: OAuth-inloggningsprompten visas inte eller så misslyckas autentiseringen innan du kan logga in.

Upplösning:

1. Kontrollera att ditt konto är anslutet till Microsoft Entra ID. Fjärr-MCP-servern kräver en Microsoft Entra-backad identitet.
2. Kontrollera att webbläsaren kan öppnas för OAuth-flödet. Om du använder VS Code i en fjärr- eller huvudlös miljö kanske OAuth-omdirigeringen inte fungerar korrekt.
3. Rensa cachelagrade autentiseringsuppgifter:
   • I VS Code öppnar du kommandopaletten (Ctrl+Skift+P) och kör Konton: Logga ut. Försök sedan ansluta igen.
   • Om problemet kvarstår läser du in VS Code-fönstret igen (Developer: Reload Window).

Auktoriseringsfel efter inloggning

Symptom: Du loggar in, men får ett auktoriseringsfel när du försöker komma åt din organisation eller ditt projekt.

Upplösning:

• Bekräfta att du har rätt åtkomstnivå i Azure DevOps organisationen.
• Kontrollera att du är medlem i projektet som du försöker komma åt.
• Kontrollera att dina Azure DevOps behörigheter omfattar åtkomst till de resurser som du kör frågor mot (till exempel arbetsobjekt, lagringsplatser eller pipelines).

Principer för villkorlig åtkomst blockerar åtkomst

Symptom: En princip för villkorsstyrd åtkomst i Microsoft Entra blockerar din inloggning.

Upplösning:

Principer för villkorsstyrd åtkomst gäller för mcp-fjärrservern på samma sätt som för Azure DevOps. Om din klientorganisation tillämpar principer som platsbaserade eller enhetsbaserade begränsningar:

• Se till att du loggar in från en kompatibel enhet och nätverksplats.
• Om klientorganisationen använder platsbaserade principer för villkorsstyrd åtkomst kan din Microsoft Entra ID administratör behöva tillåta en lista över fjärr-MCP Server IP-adresser: 20.125.155.22 och 40.74.28.81.
• Kontakta din Microsoft Entra ID administratör för specifika principkrav.

Gäståtkomst (B2B) misslyckas

Symptom: En gästanvändare i Microsoft Entra klientorganisation kan inte komma åt den fjärranslutna MCP-servern.

Upplösning:

För att gäståtkomst ska fungera måste användaren vara:

1. Har lagts till i Microsoft Entra-klientorganisationen som en gästanvändare.
2. Har lagts till i Azure DevOps organisation med lämpliga behörigheter.
3. Beviljad åtkomst till de specifika projekt och resurser som de behöver.
4. Använda den organisationsspecifika URL:en (https://mcp.dev.azure.com/{organization}). Gästanvändare kan inte använda rot-URL:en (https://mcp.dev.azure.com/) – de måste inkludera organisationsnamnet i URL:en.

Om något av dessa steg saknas misslyckas åtkomsten. Behandla det här problemet på samma sätt som ett standardproblem med Azure DevOps gäståtkomst.

AADSTS felkoder

Symptom: Du ser en felkod som börjar med AADSTS (till exempel AADSTS50076, AADSTS700016).

Upplösning:

AADSTS fel är Microsoft Entra ID autentiseringsfel, inte MCP-specifika problem. Vanliga koder är:

En fullständig lista över felkoder finns i Microsoft Entra autentiserings- och auktoriseringsfelkoder.

Problem med serverkonfiguration

Felaktig mcp.json konfiguration

Symptom: Den fjärranslutna MCP-servern ansluter men verktygen läses inte in, eller så får du oväntat beteende.

Upplösning:

Kontrollera att du mcp.json använder rätt format för fjärrservern:

• Fjärrservern använder "type": "http" och "url".
• Den lokala servern använder "type": "stdio", "command"och "args".

Blanda inte fjärr- och lokala konfigurationsformat. Kör inte båda servrarna samtidigt – välj en:

• Remote server – Används för Visual Studio Code och Visual Studio. Ingen lokal installation krävs.
• Lokal server – Används för klienter som inte Microsoft (Claude Desktop, Claude Code, Cursor, Codex) som inte stöder Microsoft Entra autentisering.

Verktygsuppsättningen eller verktygsfiltreringen fungerar inte

Symptom: Du konfigurerar X-MCP-Toolsets eller X-MCP-Tools rubriker, men verktygslistan matchar inte förväntningarna.

Upplösning:

• Kombinera inte X-MCP-Toolsets- och X-MCP-Tools-rubriker – de är ömsesidigt uteslutande.
• Kontrollera att verktygsuppsättningsnamnen är korrekta: repos, wit, wiki, pipelines, work, testplan.
• När du använder X-MCP-Toolsanger du exakta verktygsnamn avgränsade med kommatecken.
• Sök efter stavfel i rubriknamn – rubriker är skiftlägeskänsliga.

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

En fullständig lista över tillgängliga verktygsuppsättningar och verktyg finns i Tillgängliga verktyg.

Skrivskyddat läge begränsar inte skrivningar

Symptom: Du ställer in X-MCP-Readonly men skrivåtgärder är fortfarande möjliga.

Upplösning:

Kontrollera att huvudvärdet är strängen "true":

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

Fel vid verktygsmatchning

Verktyg som inte visas i AI-assistenten

Symptom: När du har anslutit mcp-fjärrservern visas inga Azure DevOps verktyg i AI-assistenten.

Upplösning:

1. Bekräfta att serverstatusen visas som ansluten i din IDE.
   • I VS Code kontrollera MCP-serverstatusen på utdatapanelen (View>Output> välj GitHub Copilot eller MCP i listrutan).
2. Ladda in VS Code-fönstret igen (Ctrl+Skift+P>Developer: Reload Window).
3. Kontrollera att du är i agentläge i GitHub Copilot – MCP-verktyg visas bara i agentläge, inte i chattläge.
4. Kontrollera att du inte överskrider gränsen på 128 verktyg. Om du har konfigurerat flera MCP-servrar kan antalet kombinerade verktyg överskrida den här gränsen.

Obligatoriska parameterfel saknas

Symptom: Verktygsanrop misslyckas med fel med "nödvändig parameter saknas", vanligtvis för projektnamnet.

Upplösning:

Det här felet är det vanligaste rapporterade felet och är förväntat beteende. Många verktyg kräver ett projektnamn eller annan kontext:

• Inkludera projektnamnet i prompten: "Lista arbetsobjekt i Contoso-projektet ."
• Om du utelämnade organisationen från din URL ska du även inkludera organisationen i din fråga.
• Vissa verktyg kräver specifika parametrar. I dokumentationen tillgängliga verktyg finns obligatoriska parametrar.

Verktygsanropet misslyckas med serverfel

Symptom: Ett verktygsanrop returnerar ett serverfel när det har anropats korrekt.

Upplösning:

• Kontrollera att resursen som du frågar finns (till exempel att arbetsobjektets ID, lagringsplatsens namn eller pipeline-ID är korrekt).
• Bekräfta att du har behörighet att komma åt resursen.
• Om felet kvarstår skapar du ett problem med hjälp av mallen för mcp-fjärrserverproblem.

Copilot-integrationsproblem

AI-assistenten använder inte MCP-verktyg

Symptom: GitHub Copilot svarar på din fråga men använder inte Azure DevOps MCP-verktyg för att hämta data.

Upplösning:

1. Kontrollera att du använder agentläge i GitHub Copilot. MCP-verktyg är inte tillgängliga i standardchattläge.
2. Var tydlig i din fråga om vilka Azure DevOps data du behöver. I stället för "Vad är min sprintstatus?" kan du till exempel prova "Använd Azure DevOps för att hämta mina aktuella sprintjobbsobjekt".
3. Kontrollera att MCP-servern visas som ansluten med en grön statusindikator.

Inaktuella eller cachelagrade data returneras

Symptom: AI-assistenten returnerar inaktuella Azure DevOps data.

Upplösning:

Lägg till "Använd inte tidigare hämtade data" i din uppmaning för att framtvinga en ny fråga. AI-assistenter kan cachelagra verktygsresultat i en konversationssession.

Agenten misslyckas före verktygsanrop

Symptom: AI-assistenten misslyckas eller ger ett fel innan den anropar något MCP-verktyg.

Upplösning:

Det här problemet ligger utanför Azure DevOps MCP-gränsen. Felet inträffar i AI-assistentens orkestreringslager:

• Information om GitHub Copilot problem finns i dokumentationen GitHub Copilot.
• Starta om AI-assistenten och försök igen.
• Om problemet kvarstår rapporterar du det till din AI-assistentleverantör.

Klientfel som inte stöds

Icke-Microsoft klienter kan inte autentisera

Symptom: Klienter som Claude Desktop, Claude Code, Cursor eller Codex kan inte slutföra OAuth-handskakningen med den fjärranslutna MCP-servern.

Upplösning:

Icke-Microsoft klienter kan inte autentisera med den fjärranslutna MCP-servern eftersom Microsoft Entra ID för närvarande inte stöder dynamisk klientregistrering, vilket dessa klienter kräver.

Klienter som stöds för närvarande:

• Visual Studio Code
• Visual Studio (2022 och senare)

För icke-Microsoft klienter använder du lokal Azure DevOps MCP Server med PAT eller Azure CLI autentisering i stället. Kör inte både fjärrservrarna och de lokala servrarna samtidigt – välj den som matchar klienten.

Diagnostiktips

Aktivera felsökningsloggning i VS Code

Så här samlar du in mer information när du felsöker:

1. Öppna panelen Utdata i VS Code (Visa>utdata).
2. Välj GitHub Copilot eller MCP i listrutan för utdatakanalen.
3. Leta efter anslutningsstatus, autentiseringsflödesinformation och felmeddelanden.

Kontrollera anslutningen

Efter installationen testar du den fjärranslutna MCP-servern med en enkel fråga:

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

Om dessa frågor returnerar rätt data fungerar servern korrekt.

Vanliga frågor och svar

Kan jag använda den fjärranslutna MCP-servern med en personlig Microsoft-konto?

No. McP-fjärrservern kräver att din Azure DevOps organisation är ansluten till Microsoft Entra ID. Personliga Microsoft-konton (MSA) stöds inte.

Ska jag använda den fjärranslutna eller lokala MCP-servern?

Använd fjärrservern om klienten stöder den (Visual Studio Code eller Visual Studio). Använd endast den lokala servern om du använder en icke-Microsoft-klient som Claude Desktop, Claude Code, Cursor eller Codex. Kör inte båda servrarna samtidigt.

Varför ser jag olika verktyg med fjärrservern jämfört med den lokala servern?

Fjärrservrarna och de lokala servrarna kan finnas i olika versioner. Fjärrservern uppdateras oberoende av det lokala npm-paketet. X-MCP-Insiders Använd rubriken för att komma åt de senaste fjärrverktygen. För den lokala servern uppdaterar du npm-paketet till den senaste versionen.

Fungerar MCP-servern med Azure DevOps Server (lokalt)?

No. Varken fjärrservern eller den lokala MCP-servern stöder Azure DevOps Server (lokalt). Båda servrarna kräver Azure DevOps Services (moln).

Vilka data har den fjärranslutna MCP-servern åtkomst till?

Fjärrservern har åtkomst till samma Azure DevOps data som REST-API:et, som är begränsade till dina behörigheter. Den har inte åtkomst till data utöver vad din Microsoft Entra identitet har behörighet att se.

Hur rapporterar jag ett problem med den fjärranslutna MCP-servern?

Skapa ett ärende med hjälp av mallen Remote MCP Server issue template i GitHub-lagringsplatsen för Azure DevOps MCP Server.

Relaterat innehåll

• Konfigurera den fjärrstyrda Azure DevOps MCP-servern (förhandsversion)
• Översikt över Azure DevOps MCP Server
• Azure DevOps MCP Server GitHub-lagringsplats