Ermitteln von APIs mit dem Azure API Center MCP-Server

Der Azure API Center MCP-Server macht den API-Katalog Ihrer Organisation als systemeigene Tooloberfläche für KI-Agents und agentische Workflows verfügbar. Wenn Sie den API Center MCP-Server aktivieren, machen Sie Ihre APIs und KI-Ressourcen durch das wachsende Ökosystem von MCP-kompatiblen KI-Clients auffindbar, einschließlich Visual Studio Code Copilot, Claude Code und benutzerdefinierten Agents.

Der Azure API Center MCP-Server macht die folgenden Tools verfügbar, die Agents zum Ermitteln und Abrufen von Ressourcen aus dem Bestand (Registrierung) Ihres API Centers verwenden.

Voraussetzungen

• Ein API-Center in Ihrem Azure-Abonnement. Wenn Sie keins haben, lesen Sie die Schnellstartanleitung: Erstellen Ihres API-Centers.

• Mindestens eine APIs oder KI-Ressourcen, die in Ihrem API Center-Bestand registriert sind, z. B. MCP-Server oder Fähigkeiten.

• Das API Center-Portal wurde aktiviert und für Ihr API Center eingerichtet. Ausführliche Informationen finden Sie unter Einrichten und Anpassen Ihres API Center-Portals. Die zugriffsbasierte Methode, die Sie für das Portal (anonyme oder Microsoft Entra ID Authentifizierung) auswählen, bestimmt, wie Entwickler sich authentifizieren, wenn sie auf den MCP-Server zugreifen.

• Ein MCP-kompatibler Client wie Visual Studio Code mit Copilot, Claude Code oder einem benutzerdefinierten Agent.

• Stellen Sie für die CLI-Verwendung sicher, dass das MCP CLI-Tool installiert ist.

Aktivieren des Azure API Center MCP-Servers

So aktivieren Sie den MCP-Server mithilfe des Azure-Portals:

1. Wechseln Sie im Azure-Portal zu Ihrem API Center.
2. Wählen Sie im Randleistenmenü unter "Verbrauch" die Daten-API-Einstellungen aus.
3. Wählen Sie unter MCP-Endpunkt den MCP-Endpunkt "API Center aktivieren" aus.

Der MCP-Serverendpunkt folgt diesem Formular:

https://<service name>.data.<region>.azure-apicenter.ms/mcp

Beispiel: https://myapicenter.data.eastus.azure-apicenter.ms/mcp

Herstellen einer Verbindung mit dem MCP-Server

Nachdem Sie den API Center MCP-Server aktiviert haben, können Entwickler den MCP-Serverendpunkt ermitteln, wenn er sich beim API Center-Portal anmeldet. Entwickler können eine Verbindung mit dem MCP-Server herstellen, indem sie einen MCP-Client wie Visual Studio Code oder die MCP CLI verwenden. Für die Verbindung ist der MCP-Serverendpunkt und die entsprechenden Authentifizierungsanmeldeinformationen erforderlich, falls konfiguriert.

Informationen zum Herstellen einer Verbindung mit dem MCP-Server mithilfe von Claude Code finden Sie unter Hinzufügen eines MCP-Servers zu Claude Code.

Verbinden über VS Code

Entwickler können die MCP-Serverkonfiguration zu ihrer datei Visual Studio Code settings.json unter dem Schlüssel mcp hinzufügen.

1. Öffnen Sie Visual Studio Code, und drücken Sie Ctrl+Shift+P (oder Cmd+Shift+P auf dem Mac).

2. Suchen Sie nach Open User Settings (JSON).

3. Fügen Sie den folgenden Codeausschnitt unter dem mcp Schlüssel ein, und speichern Sie die Datei. Ersetzen Sie den url Wert durch Ihren API Center MCP-Serverendpunkt.

   {
     "servers": {
       "api-center": {
         "url": "https://myapicenter.data.eastus.azure-apicenter.ms/mcp",
         "type": "http"
       }
     },
     "inputs": []
   }
   

4. VS Code Copilot erkennt automatisch den MCP-Server und stellt eine Verbindung zum MCP-Server her.

Verbinden über CLI

Entwickler können die MCP CLI verwenden, um eine direkte Verbindung mit dem Server herzustellen und die Registrierungstools aufzurufen.

1. Stellen Sie eine Verbindung mit dem MCP-Server mithilfe eines Befehls wie im folgenden Beispiel her. Ersetzen Sie die URL durch Ihren API Center MCP-Serverendpunkt.

   mcp connect http https://myapicenter.data.eastus.azure-apicenter.ms/mcp
   

2. Durchsuchen Sie die Registrierung nach Ressourcen:

   mcp run mcp_registry_search --query "customer-support"
   

3. Abrufen von Details für eine bestimmte Ressource:

   mcp run mcp_registry_fetch --id "my-agent-skill"
   

Verwandte Inhalte

• Einrichten und Anpassen Ihres API Center-Portals
• Erkennung von API Center-Plug-Ins über einen Plug-In-Marktplatz aktivieren