Microsoft Copilot Studio ❤️ MCP

Willkommen zum Microsoft Copilot Studio ❤️ MCP-Lab. In diesem Lab lernen Sie, wie Sie einen MCP-Server bereitstellen und ihn zu Microsoft Copilot Studio hinzufügen.

Was ist MCP?

Model Context Protocol (MCP) ist ein offenes Protokoll, das standardisiert, wie Anwendungen LLMs Kontext bereitstellen, definiert von Anthropic. MCP bietet eine standardisierte Möglichkeit, KI-Modelle mit verschiedenen Datenquellen und Tools zu verbinden. MCP ermöglicht es Makers, vorhandene Wissensserver und APIs nahtlos direkt in Copilot Studio zu integrieren.

Derzeit unterstützt Copilot Studio nur Tools. Weitere Informationen zu den aktuellen Funktionen finden Sie unter aka.ms/mcsmcp. Es gibt einige bekannte Probleme und geplante Verbesserungen. Diese sind hier aufgelistet.

Related MCP server: Microsoft Copilot Studio ❤️ MCP

MCP vs. Connectors

Wann verwenden Sie MCP? Und wann verwenden Sie Connectors? Wird MCP Connectors ersetzen?

MCP-Server werden Copilot Studio über die Connector-Infrastruktur zur Verfügung gestellt, daher sind diese Fragen nicht wirklich relevant. Die Tatsache, dass MCP-Server die Connector-Infrastruktur nutzen, bedeutet, dass sie Unternehmenssicherheits- und Governance-Kontrollen wie Virtual Network-Integration, Data Loss Prevention-Kontrollen, mehrere Authentifizierungsmethoden einsetzen können – alle in dieser Version verfügbar – und gleichzeitig Echtzeit-Datenzugriff für KI-gestützte Agents unterstützen.

MCP und Connectors sind also wirklich besser zusammen.

Voraussetzungen

• Azure-Abonnement (mit hinzugefügter Zahlungsmethode)

• Ein GitHub-Konto haben und angemeldet sein

• Copilot Studio-Test- oder Entwicklerkonto

• Power Platform-Umgebung bereitgestellt

Lab

Um diesen MCP-Server bereitzustellen und in Microsoft Copilot Studio zu verwenden, müssen Sie die folgenden Aktionen durchführen:

• Erstellen Sie ein neues GitHub-Repository basierend auf der Vorlage

• Bereitstellen der Azure-Web-App

• Erstellen des Power Platform-Connectors

• Hinzufügen des MCP-Servers als Aktion in Microsoft Copilot Studio

Erstellen eines neuen GitHub-Repositorys basierend auf der Vorlage

1. Wählen Sie Use this template

2. Wählen Sie `Create a new repository

   

3. Wählen Sie den richtigen Owner

4. Geben Sie ihm einen Repository name

5. Optional können Sie eine Description angeben

6. Wählen Sie Private

7. Wählen Sie Create repository

   Dies wird ein wenig dauern. Danach werden Sie zu dem neu erstellten Repository weitergeleitet.

[!WARNING]
Nach Abschluss der Schritte in diesem Lab haben Sie einen MCP-Server, der auf Azure läuft und öffentlich verfügbar ist. Idealerweise möchten Sie das nicht. Stellen Sie sicher, dass Sie die Azure-Web-App nach Abschluss des Labs löschen.

Bereitstellen der Azure-Web-App

1. Gehen Sie zu portal.azure.com

   

2. Fahren Sie mit der Maus über die Registerkarte Resource groups und wählen Sie Create

   

3. Klicken Sie auf das Dropdown-Menü Subscription und wählen Sie Ihr Abonnement aus der Liste

   

4. Klicken Sie in das Textfeld für den Namen der Resource group und geben Sie einen Namen für die Ressourcengruppe ein, z. B. "jokesgrp"

   

5. Wählen Sie im Dropdown-Menü Region die Region aus, die Ihnen am nächsten liegt

   

6. Klicken Sie auf Review + create

   

7. Klicken Sie auf Create

   

8. Wählen Sie Go to resource group

   

9. Wählen Sie Create

   

10. Klicken Sie in das search box

    

11. Geben Sie web app ein

12. Wählen Sie die Create button im Suchergebnis der Web-App

    

13. Wählen Sie Web App

    

14. Wählen Sie das Texteingabefeld Name und geben Sie einen Namen für die Web-App ein, z. B. "wegotjokes"

    

15. Wählen Sie im Dropdown-Menü Runtime stack die Option Node 22 LTS

    

16. Wählen Sie im Dropdown-Menü Region die Region aus, die Ihnen am nächsten liegt

    

17. Klicken Sie auf Review + create

    

18. Klicken Sie auf Create

    

19. Klicken Sie auf Refresh, um den Bereitstellungsfortschritt zu aktualisieren

    

20. Sobald die Bereitstellung abgeschlossen ist, wählen Sie Go to resource

    

21. Erweitern Sie die Registerkarte Deployment

    

22. Klicken Sie auf Deployment Center

    

23. Klicken Sie auf das Dropdown-Menü Source und wählen Sie GitHub

    

24. Wählen Sie Authorize

    

25. Wählen Sie Continue

    

26. Wählen Sie Authorize AzureAppService

    

27. Klicken Sie auf das Dropdown-Menü Organization und wählen Sie Ihre Organisation

    

28. Klicken Sie auf das Dropdown-Menü Repository und wählen Sie das GitHub-Repository aus der Liste, das Sie zuvor erstellt haben

    

29. Klicken Sie auf das Dropdown-Menü Branch und wählen Sie Ihren Branch

    

30. Lassen Sie alles andere standardmäßig und wählen Sie Save

    

31. Klicken Sie auf Refresh, um den Bereitstellungsstatus zu aktualisieren

    

32. Stellen Sie sicher, dass die Bereitstellung abgeschlossen ist

    

Erstellen des Power Platform-Connectors

1. Gehen Sie zu https://make.powerapps.com/

2. Wählen Sie More im linken Menü

3. Wählen Sie die Schaltfläche Discover all

4. Wählen Sie unter Daten das pin icon neben Custom connectors, um es an das linke Menü anzuheften

5. Wählen Sie Custom connectors im linken Menü

6. Wählen Sie New custom connector

7. Wählen Sie Create from blank

   

8. Geben Sie dem Connector einen Namen (z. B. JokesMCP)

9. Wählen Sie die blaue Schaltfläche Continue

10. Wählen Sie den Umschalter Swagger editor

    

11. Kopieren Sie den YAML-Code von hier und ersetzen Sie den Code im Swagger-Editor

12. Ersetzen Sie im Swagger-Editor dummyurl.azurewebsites.net durch die URL der Web-App, die Sie zuvor erstellt haben. Stellen Sie sicher, dass Sie https:// und alles nach azurewebsites.net entfernen

13. Wählen Sie Create connector, um den Connector zu erstellen

Hinzufügen des MCP-Servers als Aktion in Microsoft Copilot Studio

Jetzt haben Sie einen MCP-Server, der in Azure läuft, und einen Connector, der in der Power Platform verfügbar ist. In diesem Schritt geht es darum, einen Agenten in Microsoft Copilot Studio zu erstellen und den MCP-Server zum Agenten hinzuzufügen.

1. Gehen Sie zu https://copilotstudio.microsoft.com

2. Wählen Sie den Umgebungsauswahl in der oberen rechten Ecke

3. Wählen Sie die richtige Umgebung

4. Wählen Sie Create in der linken Navigation

5. Wählen Sie die blaue Schaltfläche New agent

   

6. Wählen Sie Skip to configure oben rechts

   

7. Ändern Sie den Namen in Jokester

8. Fügen Sie die folgende Description hinzu

   A humor-focused agent that delivers concise, engaging jokes only upon user request, adapting its style to match the user's tone and preferences. It remains in character, avoids repetition, and filters out offensive content to ensure a consistently appropriate and witty experience.

9. Fügen Sie die folgenden Instructions hinzu

   You are a joke-telling assistant. Your sole purpose is to deliver appropriate, clever, and engaging jokes upon request. Follow these rules:
   
   * Respond only when the user asks for a joke or something related (e.g., "Tell me something funny").
   * Match the tone and humor preference of the user based on their input—clean, dark, dry, pun-based, dad jokes, etc.
   * Never break character or provide information unrelated to humor.
   * Keep jokes concise and clearly formatted.
   * Avoid offensive, discriminatory, or NSFW content.
   * When unsure about humor preference, default to a clever and universally appropriate joke.
   * Do not repeat jokes within the same session.
   * Avoid explaining the joke unless explicitly asked.
   * Be responsive, witty, and quick.

10. Wählen Sie Create oben rechts

    

11. Aktivieren Sie die generative KI Orchestration

    

12. Deaktivieren Sie allgemeines Wissen im Abschnitt Knowledge

    

13. Wählen Sie Actions im oberen Menü

    

14. Wählen Sie Add an action

    

15. Suchen Sie nach dem Namen (in diesem Fall jokes) des Connectors, den Sie zuvor erstellt haben (siehe Nummer 1 im folgenden Screenshot)

16. Wählen Sie den Jokes MCP server (siehe Nummer 2 im folgenden Screenshot)

    

17. Warten Sie, bis die Verbindung erstellt wurde, und wählen Sie Next, wenn sie fertig ist

    

18. Ändern Sie die Description for the agent to know when to use this action in den folgenden Text:

    Trigger this action when a user asks for a joke. It can provide Chuck Norris jokes, Dad jokes and Yo Mama jokes.

    Lassen Sie den Rest standardmäßig, wie zum Beispiel die Endbenutzerauthentifizierung, über die Sie gleich mehr erfahren werden.

19. Wählen Sie Add action, um die Aktion zum Agenten hinzuzufügen

    

20. Wählen Sie das refresh icon im Bereich Test your agent

    

21. Senden Sie im Bereich Test your agent die folgende Nachricht:

    Can I get a Chuck Norris joke?

    Dies zeigt Ihnen eine Meldung, dass zusätzliche Berechtigungen erforderlich sind, um diese Aktion auszuführen. Dies liegt an der Benutzerauthentifizierung im Aktionsassistenten.

22. Wählen Sie Connect

    

    Dies öffnet ein neues Fenster, in dem Sie Ihre Verbindungen für diesen Agenten verwalten können.

23. Wählen Sie Connect neben dem JokesMCP

    

24. Warten Sie, bis die Verbindung erstellt wurde, und wählen Sie Submit

    

25. Die Verbindung sollte jetzt verbunden sein, daher sollte der Status auf Connected gesetzt sein

    

26. Schließen Sie die Registerkarte „Verbindungen verwalten“ in Ihrem Browser

    Jetzt sollten Sie wieder auf dem Bildschirm des Jokester-Agenten sein.

27. Wählen Sie das refresh icon im Bereich Test your agent

    

28. Senden Sie im Bereich Test your agent die folgende Nachricht:

    Can I get a Chuck Norris joke?

    Dies zeigt nun einen Chuck-Norris-Witz – anstelle der zusätzlichen Berechtigungen.

    

29. Senden Sie im Bereich Test your agent die folgende Nachricht:

    Can I get a Dad joke?

    Dies zeigt nun einen Vaterwitz.

    

30. Senden Sie im Bereich Test your agent die folgende Nachricht:

    Can I get a Yo Mama joke?

    Dies zeigt nun einen Yo-Mama-Witz.

    

Und das war der Jokes-MCP-Server, der in Microsoft Copilot Studio funktioniert. Das ist auch das Ende des Labs! Hoffentlich hat Ihnen das Lab gefallen. Nehmen Sie sich bitte die Zeit, unser Feedback-Formular auszufüllen.

Details zum Jokes-MCP-Server

Dies ist ein MCP-Server, der auf dem TypeScript SDK basiert.

Mit diesem MCP-Server können Sie Witze von den folgenden Websites abrufen:

• chucknorris.io

• icanhazdadjoke.com

• yomama-jokes.com

Wenn Sie den Server lokal ausführen möchten, führen Sie npm install im Stammverzeichnis des Repositorys aus.

Danach können Sie npm run build ausführen, um den Server zu erstellen, und npm start, um den Server zu starten.

Tools

Die folgenden Tools sind enthalten:

get-chuck-joke

Dieses Tool ruft einen zufälligen Chuck-Norris-Witz von chucknorris.io ab.

get-chuck-categories

Dieses Tool ruft die verfügbaren Kategorien von chucknorris.io ab.

get-dad-joke

Dieses Tool ruft einen zufälligen Vaterwitz von icanhazdadjoke.com ab.

get-yo-mama-joke

Dieses Tool ruft einen zufälligen Yo-Mama-Witz von yomama-jokes.com ab.

Bekannte Probleme und geplante Verbesserungen

Es gibt einige bekannte Probleme und geplante Verbesserungen für MCP in Microsoft Copilot Studio. Sie sind in diesem Microsoft-Learn-Artikel aufgeführt.

Mitwirken

Dieses Projekt begrüßt Beiträge und Vorschläge. Die meisten Beiträge erfordern, dass Sie einer Contributor License Agreement (CLA) zustimmen, in der Sie erklären, dass Sie das Recht haben, uns die Rechte zur Nutzung Ihres Beitrags zu gewähren, und dass Sie dies auch tatsächlich tun. Einzelheiten finden Sie unter https://cla.opensource.microsoft.com.

Wenn Sie einen Pull Request einreichen, ermittelt ein CLA-Bot automatisch, ob Sie eine CLA bereitstellen müssen, und kennzeichnet den PR entsprechend (z. B. Statusprüfung, Kommentar). Befolgen Sie einfach die Anweisungen des Bots. Sie müssen dies nur einmal für alle Repos tun, die unsere CLA verwenden.

Dieses Projekt hat den Microsoft Open Source Code of Conduct übernommen. Weitere Informationen finden Sie in der Code-of-Conduct-FAQ oder wenden Sie sich bei weiteren Fragen oder Anmerkungen an opencode@microsoft.com.

Marken

Dieses Projekt kann Marken oder Logos für Projekte, Produkte oder Dienste enthalten. Die autorisierte Verwendung von Microsoft-Marken oder -Logos unterliegt den Markenrichtlinien von Microsoft und muss diesen entsprechen. Die Verwendung von Microsoft-Marken oder -Logos in geänderten Versionen dieses Projekts darf keine Verwirrung stiften oder eine Unterstützung durch Microsoft implizieren. Jegliche Verwendung von Marken oder Logos Dritter unterliegt den Richtlinien dieser Dritten.