De externe Azure DevOps MCP-server instellen

Azure DevOps Services

De externe Azure DevOps MCP-server is een gehoste versie van de Azure DevOps MCP-server waarvoor geen lokale installatie is vereist. In plaats van de server op uw computer uit te voeren, verbindt u uw AI-assistent rechtstreeks met het door Azure DevOps gehoste eindpunt met behulp van streambaar HTTP-transport.

Kies eerst voor werken op afstand

Gebruik de externe MCP-server wanneer uw omgeving deze ondersteunt. De externe server is de aanbevolen optie omdat Azure DevOps hosts en deze bijwerkt en u geen Node.js hoeft te installeren of een lokaal serverproces te beheren.

Gebruik de lokale MCP-server wanneer uw client niet kan worden geverifieerd bij de externe server met Microsoft Entra ID. Deze beperking is momenteel van toepassing op clients zoals Claude Desktop en Codex. Cursor en Claude Code vereisen een aangepaste Microsoft Entra app-registratie om te verifiëren. Zie Hulp bij AI inschakelen met de Azure DevOps MCP-server voor lokale installatie-instructies.

Vereiste voorwaarden

configuratie van mcp.json

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

U kunt ook de naam van de organisatie weglaten uit de URL. Als u echter de naam van de organisatie weglaat, moet u deze opgeven als context in elke aanroep van het hulpprogramma.

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

Hulpmiddelensets

Geef hulpprogramma's op om de hulpprogramma's te beperken die beschikbaar zijn voor de MCP-server. Mag niet worden gecombineerd met X-MCP-Tools.

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

Hulpmiddelen voor alleen-lezen

Gebruik de X-MCP-Readonly header om de server te beperken tot alleen-lezenbewerkingen. Deze beperking is handig als u wijzigingen in Azure DevOps resources wilt voorkomen.

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

Hulpmiddelensets en alleen-lezenfilters combineren

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

Afzonderlijke hulpprogramma's

Gebruik de X-MCP-Tools header om alleen specifieke hulpprogramma's in te schakelen. Mag niet worden gecombineerd met X-MCP-Toolsets.

Geef de namen van hulpprogramma's op die worden weergegeven in de lijst met beschikbare hulpprogramma's . Kies bij geconsolideerde hulpprogramma's, zoals wit_work_item, de bewerking met behulp van de parameter action van het hulpprogramma wanneer u het aanroept.

{
  "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

Wanneer we experimenteren en nieuwe hulpprogramma's en updates voor bestaande hulpprogramma's introduceren, kunt u vroegtijdig toegang krijgen tot deze wijzigingen met behulp van de X-MCP-Insiders header.

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

Beschikbare hulpmiddelen

Basis hulpprogramma's

Basishulpprogramma's zijn altijd beschikbaar, tenzij anders vermeld.

Werk

De werkhulpmiddelen worden samengevoegd tot gegroepeerde dispatchers met behulp van een action parameter.

Repos

De hulpprogramma's voor repositories worden samengevoegd in gegroepeerde dispatchers met de parameter action.

Wit

De work item-tools worden samengebracht in gegroepeerde dispatchers met behulp van een parameter action.

Pipelines

De pijplijnhulpprogramma's worden geconsolideerd in dispatcher-groepen met de parameter action.

Wiki

De wikileesbewerkingen worden samengevoegd tot één wiki hulpprogramma. Gebruik de action parameter om de bewerking te selecteren.

Testplannen

De hulpmiddelen voor testplannen worden gebundeld in dispatcher-groepen met behulp van de parameter action.

Geavanceerde beveiliging

De geavanceerde beveiligingshulpprogramma's worden samengevoegd in een gegroepeerde dispatcher die gebruikmaakt van een action parameter.

Enterprise Live Migration (previewversie)

De hulpprogramma's voor livemigratie van Enterprise gebruiken een action parameter voor het groeperen en verzenden van taken. Meer informatie over de preview-versie van Enterprise Live Migration.

Als u alleen de hulpprogramma's voor bedrijfs livemigratie beschikbaar wilt maken, gebruikt u de X-MCP-Toolsets header met de elm waarde:

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

Ondersteunde omgevingen

Voor de externe Azure DevOps MCP-server moeten uw gebruikersaccount en Azure DevOps organisatie verbinding maken met Microsoft Entra ID.

Niet alle MCP-clients ondersteunen standaard Microsoft Entra verificatie. Voor sommige omgevingen zijn extra stappen vereist om de clienttoepassing te registreren.

Ondersteunde omgevingen voor het externe eindpunt, wanneer Microsoft Entra verificatie beschikbaar is, zijn onder andere:

• Visual Studio met GitHub Copilot
• Visual Studio
• Microsoft Foundry
• Microsoft Copilot Studio
• GITHUB COPILOT CLI
• GitHub Copilot-app
• Cursor desktop, Cursor Cloud Agents of Claude Code met een aangepaste Microsoft Entra app-registratie

Visual Studio Code

De externe MCP-server configureren in Visual Studio Code:

1. Voeg een .vscode/mcp.json bestand toe aan uw opslagplaats met de mcp.json configuratie die eerder is weergegeven.
2. Sla het bestand op.
3. Open GitHub Copilot in VS Code.
4. Wanneer u hierom wordt gevraagd, moet u zich verifiëren met behulp van uw Microsoft Entra-account en uw account selecteren.

Nadat de verificatie is voltooid, wordt er een lijst met beschikbare hulpprogramma's weergegeven.

Visual Studio (2022 en hoger)

Configureer de externe MCP-server in Visual Studio door de server-URL toe te voegen aan uw MCP-instellingen. Zie Gebruik MCP-servers in Visual Studio voor meer informatie.

OAuth-bereiken kiezen voor aangepaste clients

Wanneer u een aangepaste MCP-client registreert, verleent u alleen de gedelegeerde machtigingen die zijn vereist voor de Azure DevOps bewerkingen die de client uitvoert. OAuth-bereiken bepalen welke Azure DevOps resources en bewerkingen waartoe de client toegang heeft. Het inschakelen van een MCP-hulpprogramma of hulpprogrammaset verleent geen extra machtigingen.

Volg het principe van minimale bevoegdheden:

• Verleen leesmachtigingen wanneer de client alleen-lezen-MCP-hulpprogramma's gebruikt.
• Verken schrijf- of beheerbereiken alleen wanneer de client de bijbehorende schrijfbewerkingen nodig heeft.
• Controleer overgenomen machtigingsbereiken om te voorkomen dat u redundante machtigingen verleent.

Zie OAuth-scopes voor de beschikbare scopes en hun onderlinge relaties.

OAuth-bereiken overschrijven de machtigingen van de aangemelde gebruiker niet. Een MCP-bewerking slaagt alleen wanneer zowel het toepassingsbereik als de Azure DevOps machtigingen van de gebruiker dit toestaan.

Cursor

Cursor vereist een aangepaste Microsoft Entra-app-registratie voor toegang tot de externe Azure DevOps MCP-server.

De toepassing registreren voor cursor-bureaublad

1. Controleer of de Azure DevOps MCP-ondernemingstoepassing is toegevoegd aan uw tenant. Als u deze niet kunt vinden, zie Kan de Azure DevOps MCP-bedrijfstoepassing niet vinden in de tenant.
2. Ga in de Microsoft Entra-beheercentrum naar App-registraties en maak vervolgens een app-registratie.
3. Selecteer Verificatie (preview)>Omleidings-URI>Mobile- en desktoptoepassingen toevoegen in de app-registratie.
4. Voer de http://localhost:8787/callback omleidings-URI in en sla de wijzigingen op.
5. Selecteer op de pagina Verificatie (preview) het tabblad Instellingen en schakel openbare clientstromen toestaan in.
6. Selecteer op de pagina API-machtigingeneen machtigings-API> toevoegendie door mijn organisatie wordt gebruikt.
7. Zoek Azure DevOps MCP of de toepassings-id 2a72489c-aab2-4b65-b93a-a91edccf33b8en selecteer vervolgens de toepassing.
8. Selecteer de gedelegeerde machtigingen die uw client nodig heeft, volg de richtlijnen voor het OAuth-bereik en selecteer vervolgens Machtigingen toevoegen.
9. Selecteer Beheerderstoestemming verlenen. Afhankelijk van uw rol moet een tenantbeheerder deze stap mogelijk voltooien.

Kopieer de toepassings-id (client) uit de app-registratie. U hebt deze waarde nodig om Cursor te configureren.

Cursor-bureaublad configureren

1. Open Instellingen>en MCP in Cursor.

2. Selecteer Nieuwe MCP-server.

3. Voeg de volgende configuratie toe, waarbij u {client-id} vervangt door de toepassings-id (client-id) die u hebt gekopieerd:

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

4. Sla de configuratie op en ga vervolgens terug naar Instellingen>.

5. Zoek de ado-server en selecteer Vervolgens Verifiëren.

Cursor-cloudagents configureren

Cursor Cloud Agents vereisen een webomleidings-URI en een clientgeheim naast de aangepaste Microsoft Entra app-registratie.

1. Open in de Microsoft Entra-beheercentrum de app-registratie die u voor Cursor hebt gemaakt.

2. Selecteer Verificatie (preview)>Omleidings-URI toevoegen>Web.

3. Voer de https://www.cursor.com/agents/mcp/oauth/callback omleidings-URI in en sla de wijzigingen op.

4. Selecteer Certificaten & geheimenKlantgeheimenNieuw klantgeheim.

5. Voer een beschrijving in, selecteer een verloopperiode en selecteer vervolgens Toevoegen.

6. Kopieer de waarde van het clientgeheim. De waarde wordt slechts één keer weergegeven.

7. Open in Cursor de MCP-serverconfiguratie van cloudagents en voeg de aangepaste MCP-server toe of bewerk deze.

8. Stel de server-URL in op https://mcp.dev.azure.com.

9. Voer de toepassings-id (client) in van uw app-registratie in client-id en de waarde van het clientgeheim in Clientgeheim.

   U kunt ook de JSON-configuratie bewerken en de tijdelijke aanduidingen vervangen door uw app-registratiewaarden:

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

10. Sla de configuratie op en selecteer vervolgens Aanmelden in cursorcloudagents om Microsoft Entra verificatie te voltooien.

Als Microsoft Entra een fout AADSTS50011retourneert, controleert u of de webomleidings-URI exact overeenkomthttps://www.cursor.com/agents/mcp/oauth/callback. Als tokenuitwisseling mislukt met een fout AADSTS7000218, controleert u of de huidige waarde van het clientgeheim is geconfigureerd in Cursor Cloud Agents.

Claude Code

Claude Code vereist een aangepaste Microsoft Entra-app-registratie voor toegang tot de externe Azure DevOps MCP-server.

Registreer de toepassing

1. Controleer of de Azure DevOps MCP-ondernemingstoepassing is toegevoegd aan uw tenant. Als u deze niet kunt vinden, zie Kan de Azure DevOps MCP-bedrijfstoepassing niet vinden in de tenant.
2. Ga in de Microsoft Entra-beheercentrum naar App-registraties en maak vervolgens een app-registratie.
3. Selecteer Verificatie (preview)>Omleidings-URI>Mobile- en desktoptoepassingen toevoegen in de app-registratie.
4. Voer de http://localhost:3118/callback omleidings-URI in en sla de wijzigingen op.
5. Selecteer op de pagina Verificatie (preview) het tabblad Instellingen en schakel openbare clientstromen toestaan in.
6. Selecteer op de pagina API-machtigingeneen machtigings-API> toevoegendie door mijn organisatie wordt gebruikt.
7. Zoek Azure DevOps MCP of de toepassings-id 2a72489c-aab2-4b65-b93a-a91edccf33b8en selecteer vervolgens de toepassing.
8. Selecteer de gedelegeerde machtigingen die uw client nodig heeft, volg de richtlijnen voor het OAuth-bereik en selecteer vervolgens Machtigingen toevoegen.
9. Selecteer Beheerderstoestemming verlenen. Afhankelijk van uw rol moet een tenantbeheerder deze stap mogelijk voltooien.

Kopieer de toepassings-id (client) uit de app-registratie. U hebt deze waarde nodig om Claude Code te configureren.

Claude Code configureren

1. Voer de volgende opdracht uit, waarbij u {client-id} de toepassings-id (client) vervangt die u hebt gekopieerd en {organization} door de naam van uw Azure DevOps organisatie:

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

   U kunt ook een .mcp.json bestand maken in de hoofdmap van uw opslagplaats met de volgende configuratie:

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

2. Start Claude Code door claude uit te voeren.

3. Voer /mcp uit en volg vervolgens het aanmeldingsproces in de browser om u aan te melden met uw Microsoft Entra-account.

Zie Claude Code verbinden met hulpprogramma's via MCP voor meer informatie over deze opties.

De verbinding controleren

Controleer na de installatie of de externe MCP-server werkt door uw AI-assistent een vraag te stellen over uw Azure DevOps gegevens.

Voorbeelden:

• "Geef de projecten in mijn Azure DevOps organisatie weer."
• 'Mijn toegewezen werkitems weergeven'.
• "Welke pull requests vereisen mijn recensie?"

Als de AI-assistent resultaten van uw Azure DevOps organisatie retourneert, is de externe MCP-server correct geconfigureerd.

AI gebruiken om externe MCP-installatie te valideren en problemen op te lossen

De volgende voorbeeldprompts voor Copilot Chat helpen u bij het kiezen van de juiste MCP-aanpak, het configureren en valideren van de externe configuratie, het verbeteren van prompts voor dagelijks gebruik en het oplossen van problemen wanneer dat nodig is. Kopieer en plak deze prompts in Copilot Chat en vervang tijdelijke aanduidingen door uw werkelijke organisatie, client en foutdetails.

Copilot wordt aangedreven door AI, dus verrassingen en fouten zijn mogelijk. Zie voor meer informatie de veelgestelde vragen over algemeen gebruik van Copilot.

Troubleshooting

Voor ondersteuning kunt u een probleem maken in de lokale MCP-serveropslagplaats . Zorg ervoor dat je de sjabloon Remote probleem gebruikt.

Veelgestelde vragen

Hoe zit het met andere klanten zoals Claude Desktop of Codex?

Claude Desktop en Codex vereisen dynamische registratie van een OAuth-client-id in Microsoft Entra ID voordat ze de externe MCP-server kunnen gebruiken. Microsoft Entra ID biedt momenteel geen ondersteuning voor de dynamische clientregistratiestroom die deze clients nodig hebben. Gebruik de lokale MCP-server met deze clients.

Verwante inhoud

• overzicht van Azure DevOps MCP-server
• Azure DevOps MCP Server GitHub opslagplaats