Erstellen und Registrieren von MCP-Servern im API Center basierend auf Azure Logic Apps (Vorschau)

Damit ein Agent oder ein großes Sprachmodell (Large Language Model, LLM) durch das Ausführen von Aktionen in externen Dienste, Systemen, Apps oder Daten Anforderungen erfüllen kann, erstellen Sie einen MCP-Server (Model Context Protocol), der Tools zum Ausführen von Aufgaben für Ihren Agent oder Ihr Modell bereitstellt. Diese Tools können beispielsweise Dateien lesen, aktualisieren oder löschen, Datenbanken abfragen, E-Mails senden, mit APIs interagieren, Berechnungen durchführen oder sogar Workflows auslösen.

Über das Azure API Center können Sie einen MCP-Server mithilfe von Tools erstellen und registrieren, die durch vordefinierte Connectoraktionen in Azure Logic Apps gesteuert werden. In der Regel verwenden Sie Connectoraktionen und Trigger in Azure Logic Apps, um Workflows für Automatisierungs- und Integrationslösungen zu erstellen. Mit Zugriff auf mehr als 1.400 Connectors, die mit einer umfangreichen Palette von Clouddiensten, lokalen Systemen, Apps und Daten arbeiten, können Sie verschiedene Toolsets erstellen, die mit Ihren Unternehmensressourcen interagieren.

In diesem Leitfaden wird gezeigt, wie Sie die folgenden Aufgaben ausführen:

• Erstellen eines MCP-Servers, der von einer Standard-Logik-App unterstützt wird.
• Erstellen von Tools, die der Server für Agents und Modelle zum Aufrufen verfügbar macht.
• Registrieren des MCP-Servers über eine API Center-Ressource.

Weitere Informationen finden Sie in den folgenden Artikeln:

• MCP-Serverkonzepte
• Was ist Azure API Center?
• Was ist Azure Logic Apps?
• Was sind Connectors in Azure Logic Apps
• Connectors für Azure Logic Apps

Weitere Informationen zu MCP und API Center

Das folgende Diagramm zeigt die Beziehungen zwischen den verschiedenen Komponenten in der praktischen Zusammenarbeit in diesem Szenario:

• Der MCP-Server und die Tools, die Sie über das API Center erstellen und registrieren
• Die Connectoraktionen in Azure Logic Apps, die Sie zum Erstellen der Tools verwenden, die Ihr MCP-Server bereitstellt
• Die Interaktionen zwischen dem MCP-Client und dem MCP-Server
• Die Interaktionen zwischen Ihrem MCP-Client und dem Agent oder Modell
• Die Eingaben, die über den MCP-Client an den Agent oder das Modell weitergeleitet werden
• Die Ausgaben des Agents oder Modells, die über den MCP-Client ausgegeben werden

MCP ist ein offener Standard, mit dem KI-Komponenten wie LLMs, Agents und MCP-Clients Tools verwenden können, um auf sichere, auffindbare und strukturierte Weise mit externen Diensten und Systemen zu arbeiten. Dieser Standard definiert, wie der Zugriff auf Tools beschrieben, ausgeführt und authentifiziert wird, damit KI-Komponenten mit realen Diensten, Systemen, Datenbanken, APIs und Geschäftsworkflows interagieren können. Ein MCP-Server fungiert wie eine Brücke zwischen KI-Komponenten und den Tools, die sie verwenden können.

API Center bietet zentrale API-Ermittlung und Governance der Entwurfszeit-API, sodass Sie all Ihre APIs konsolidiert an einem Ort nachverfolgen können. Sie können für Ihre Organisation einen organisierten strukturierten API-Bestand mit Informationen wie Versionsdetails, API-Definitionsdateien und allgemeinen Metadaten entwickeln und verwalten, unabhängig vom API-Typ, der Lebenszyklusphase oder dem Bereitstellungsort. Projektbeteiligte in Ihrer Organisation, z. B. API-Programmmanager, IT-Administratoren, App-Entwickler und API-Entwickler können diese APIs entwerfen, ermitteln, wiederverwenden und steuern.

Voraussetzungen

In der folgenden Tabelle werden die Voraussetzungen für diesen Leitfaden beschrieben:

Einschränkungen und bekannte Probleme

In der folgenden Liste werden für diesen Release geltende Einschränkungen oder Probleme beschrieben:

• Sie können nur einen Connector für Ihren MCP-Server auswählen.

• Integrierte Connectors auf Dienstanbieterbasis und benutzerdefinierte Connectors werden derzeit nicht unterstützt.

• Jedes Tool kann nur eine Aktion haben.

Erstellen eines MCP-Servers und von Tools

Angenommen, Sie möchten einen MCP-Server mithilfe von Tools erstellen, mit denen Kontakte verwaltet und E-Mails gesendet werden.

1. Öffnen Sie im Azure-Portal Ihre API Center-Ressource.

2. Wählen Sie auf der Seitenleiste „Ressourcen“ unter Ermittlung die Option MCP aus.

3. Suchen Sie auf der MCP-Seite die Kachel Azure Logic Apps, und wählen Sie Registrieren aus.

   

4. Führen Sie auf der Startseite des Assistenten " Registrieren eines MCP-Servers mit Azure Logic Apps " die folgenden Schritte aus:

   1. Geben Sie im Abschnitt "Projektdetails " die folgenden Informationen zu Ihrem MCP-Server an:

      Eigentum	Erforderlich	Wert	Description
      MCP-Servername	Yes	< mcp-server-name>	Der Name, der für den MCP-Server verwendet werden soll.
      Beschreibung	Yes	< mcp-server-description>	Die Beschreibung der Rolle, des Zwecks und der Aufgaben des MCP-Servers, die der Server ausführen kann. Diese Beschreibung hilft Agents und Modellen dabei, den geeigneten Server und die zu verwendenden Tools genauer zu identifizieren und auszuwählen.
      Logik-App	Yes	< Standard-Logik-App-Ressource>	Wählen Sie in der Liste eine vorhandene Standardlogik-App aus, die verwendet werden soll, oder wählen Sie zum Erstellen einer neuen Logik-App die Option "Logik-App erstellen" aus.

      

   2. Wählen Sie im Abschnitt "Extras " unter "Connectors" die Option "Verbinder hinzufügen " oder "Hinzufügen" aus.

      

   3. Suchen und wählen Sie im Bereich Connector hinzufügen und auf der Registerkarte Connector auswählen den Connector aus, für den Sie ein Tool erstellen möchten, z. B.:

      

   4. Wählen Sie auf der Registerkarte Aktionen auswählen alle Aktionen aus, die Sie als Tool erstellen möchten. Klicken Sie auf Weiter, wenn Sie fertig sind.

      Sie können mehrere Aktionen auswählen, aber nur ein Tool für jede ausgewählte Aktion erstellen.

      

   5. Geben Sie auf der Registerkarte Verbindung erstellen alle Verbindungsinformationen an, oder melden Sie sich bei Bedarf mit Ihren Anmeldeinformationen an, und authentifizieren Sie sich.

      Wenn Sie eine andere Verbindung erstellen müssen, wählen Sie Neue hinzufügen aus.

   6. Wenn Sie fertig sind, wählen Sie "Speichern" aus, was Sie zur Seite " Registrieren eines MCP-Servers mit Azure Logic Apps " zurückgibt.

      Im Abschnitt Connectors wird nun der ausgewählte Connector angezeigt. Im Abschnitt Aktionen werden die ausgewählten Aktionen angezeigt, die die von Ihrem MCP-Server bereitgestellten Tools verwenden. Standardmäßig verwenden alle Parameter für diese Aktionen ein LLM als Eingabequelle. Sie können diese Eingabequelle basierend auf den Anforderungen Ihres Szenarios in „Vom Benutzer bereitgestellt“ ändern.

      

5. Um einem Agent oder einem LLM zu helfen, das richtige Tool auszuwählen und aus korrekten Quellen stammende Eingaben an Toolparameter zu übergeben, überprüfen und aktualisieren Sie das Setup jedes Tools, indem Sie die folgenden Schritte ausführen:

   1. Wählen Sie im Abschnitt Aktionen entweder den Toolnamen oder die Schaltfläche „Bearbeiten“ (Bleistift) für dieses Tool aus.

   2. Geben Sie im Bereich Bearbeiten: <Toolname> die folgenden Informationen an:

      `Section`	Description
      Beschreibung	Beschreibt den Zweck des durch die Aktion unterstützten Tools, um einem Agent oder einem LLM zu helfen, zu ermitteln, wann das Tool verwendet werden soll. Eine Standardbeschreibung ist vorhanden, Sie können den Text jedoch Ihren Anforderungen entsprechend anpassen. Der Standardtext stammt aus der API-Swagger-Beschreibung des Connectors, z. B. Aktionen – Office 365 Outlook.
      Standardparameter	Listet alle Parameter auf, die zum Ausführen des Tools erforderlich sind. Für jeden Parameter lauten die Eingabequellenoptionen Modell und Benutzer. Standardmäßig stellt das Modell (LLM) die Eingaben bereit. Wenn Sie Benutzer auswählen, wird die entsprechende Benutzeroberfläche angezeigt, damit Sie die Eingabequelle angeben können. Weitere Informationen finden Sie unter Informationen zum Auflösen von Parameterwerten zur Laufzeit.
      Optionale Parameter	Wählen Sie alle anderen Parameter aus, die Sie für das Tool einschließen möchten.

      Das folgende Beispiel zeigt die Beschreibung sowie Parameter für das Tool E-Mail senden" (V2):

      

   3. Wenn Sie fertig sind, wählen Sie Änderungen speichern aus.

6. Wenn Sie alle Tools überprüft oder aktualisiert haben, wählen Sie Registrieren aus.

7. Warten Sie auf die Benachrichtigungen, dass Azure ihren MCP-Server erfolgreich registriert hat.

Informationen zum Auflösen von Parameterwerten zur Laufzeit

In diesem Abschnitt werden die Optionen beschrieben, wie der MCP-Server Eingabeparameterwerte für aktionengestützte Tools erhält. Sie können das Modell entweder als Standardquelle beibehalten, oder Sie können hartcodierte statische Werte für alle Interaktionen bereitstellen.

• Vom Modell bereitgestellte Eingaben

  Standardmäßig übergibt das Modell Parameterwerte zur Laufzeit basierend auf der Unterhaltung zwischen dem Agent und dem Endbenutzer. Diese Werte sind dynamisch und bis zur Laufzeit unbekannt.

• Vom Benutzer bereitgestellte Eingaben

  Sie geben die Parameterwerte während der Entwicklung an. Diese Werte sind in der Regel hartcodiert und bleiben für alle Interaktionen zwischen dem Agent und dem Endbenutzer gleich.

Suchen und Anzeigen ihres MCP-Servers

Stellen Sie für diese Aufgabe sicher, dass Sie die Anforderung zum Einrichten des API Center-Portals abgeschlossen haben.

1. Wählen Sie auf der Seitenleiste „API Center-Ressourcen“ im API Center-PortalEinstellungen aus.

2. Wählen Sie auf der Symbolleiste Einstellungen die Option API Center-Portal anzeigen aus.

   Ihr Browser öffnet das API-Portal für Ihre API Center-Ressource unter der folgenden URL:

   <.

   Weitere Informationen finden Sie unter Zugriff auf das API Center – Portal.

3. Melden Sie sich mit Ihrem Azure-Konto an.

   Das API-Portal zeigt die verfügbaren MCP-Server an.

4. Suchen und wählen Sie den von Ihnen erstellten MCP-Server aus.

5. Suchen Sie im MCP-Serverinformationsbereich auf der Registerkarte Optionen den Abschnitt Endpunkt-URL, und wählen Sie URL kopieren aus, um den Zugriff über einen MCP-Client zu testen.

Testen des Zugriffs auf Ihren MCP-Server

1. Wählen Sie in Visual Studio Code im Menü Ansicht die Option Befehlspalette aus. Suchen und wählen Sie MCP: Server hinzufügen aus.

   

2. Wählen Sie HTTP (HTTP oder Server-Sent Events) aus. Geben Sie unter Server-URL eingeben die URL für Ihren MCP-Server an.

3. Geben Sie unter Server-ID eingeben einen aussagekräftigen Namen für Ihren MCP-Server an.

   Wenn Sie zum ersten Mal einen MCP-Server hinzufügen, müssen Sie auswählen, wo Ihre MCP-Konfiguration gespeichert werden soll. Sie erhalten die folgenden Optionen. Wählen Sie die beste Option für Ihr Szenario aus:

   Option	Description
   Global	Ihre Benutzerkonfiguration liegt im Verzeichnis C:\Benutzer<Ihr-Benutzername>\AppData\Roaming\Code\Benutzer und ist für alle Arbeitsbereiche verfügbar.
   Workspace	Ihr aktueller Arbeitsbereich in Visual Studio Code.

   In diesem Beispiel wird Global ausgewählt, um die MCP-Serverinformationen in der Benutzerkonfiguration zu speichern. Daher erstellt und öffnet Visual Studio Code eine mcp.json-Datei, die Ihre MCP-Serverinformationen anzeigt.

4. Wählen Sie in sich öffnendenmcp.json-Datei den Link Start oder Neustart aus, um eine Verbindung für Ihren MCP-Server herzustellen, z. B.:

   

5. Wenn die Authentifizierungsaufforderung angezeigt wird, wählen Sie Zulassen und dann das Konto aus, das für die Authentifizierung verwendet werden soll.

6. Melden Sie sich an, und geben Sie ihre Zustimmung, um Ihren MCP-Server aufzurufen.

   Nach Abschluss der Authentifizierung wird in der mcp.json-Datei Wird ausgeführt als MCP-Serverstatus angezeigt.

   

7. Versuchen Sie als Test, Ihren MCP-Server über GitHub Copilot aufzurufen:

   1. Öffnen Sie auf der Titelleiste von Visual Studio Code die Copilot-Liste, und wählen Sie Chat öffnen aus.

   2. Wählen Sie unter dem Chateingabefeld aus der Liste der integrierten Modi die Option Agent aus.

   3. Wählen Sie in der LLM-Liste das zu verwendende LLM aus.

   4. Um die Tools zu durchsuchen, die auf Ihrem MCP-Server verfügbar sind, wählen Sie Tools konfigurieren aus.

   5. Wählen oder entfernen Sie in der Liste „Tools“ die Tools nach Bedarf, stellen Sie jedoch sicher, dass Ihr neuer MCP-Server ausgewählt ist.

Jetzt können Sie über die Copilot-Chatschnittstelle mit Ihrem MCP-Server interagieren.

Verwandte Inhalte

• Workflows mit KI-Agents und -Modellen in Azure Logic Apps
• Ausführen von Verbrauchsworkflows als Aktionen für Agents in Azure AI Foundry