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, Claude Code en Codex. Cursor vereist 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 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.

Cursor

Cursor 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: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 app nodig heeft 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 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.

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, Claude Code of Codex?

Claude Desktop, Claude Code 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