Jokes MCP Server

Microsoft Copilot Studio ❤️ MCP

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

Was ist MCP?

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

Copilot Studio unterstützt derzeit 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 aufgeführt.

MCP vs. Konnektoren

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

MCP-Server werden Copilot Studio über eine Connector-Infrastruktur zur Verfügung gestellt, daher sind diese Fragen nicht wirklich relevant. Die Tatsache, dass MCP-Server die Connector-Infrastruktur nutzen, ermöglicht es ihnen, unternehmensweite Sicherheits- und Governance-Kontrollen wie die Integration virtueller Netzwerke , Data Loss Prevention- Kontrollen und verschiedene Authentifizierungsmethoden – alle in dieser Version verfügbar – einzusetzen und gleichzeitig den Echtzeit-Datenzugriff für KI-gestützte Agenten zu unterstützen.

MCP und Konnektoren sind in Kombination also wirklich besser .

Voraussetzungen

• Azure-Abonnement (mit hinzugefügter Zahlungsmethode)
• Besitzen Sie ein GitHub-Konto und seien Sie angemeldet
• Test- oder Entwicklerkonto für Copilot Studio
• Bereitgestellte Power Platform-Umgebung

Labor

Um diesen MCP-Server bereitstellen und in Microsoft Copilot Studio verwenden zu können, müssen Sie die folgenden Schritte ausführen:

• Erstellen Sie ein neues GitHub-Repository basierend auf der Vorlage
• Bereitstellen der Azure-Web-App
• Erstellen des Power Platform Connectors
• Fügen Sie den MCP-Server als Aktion in Microsoft Copilot Studio hinzu

Erstellen Sie ein neues GitHub-Repository basierend auf der Vorlage

1. Wählen Sie Use this template
2. Wählen Sie „Neues Repository erstellen“
3. Wählen Sie den richtigen Owner
4. Geben Sie ihm einen Repository name
5. Optional können Sie eine Description eingeben
6. Wählen Sie Private
7. Wählen Sie Create repositoryDies dauert einen Moment. Anschließend werden Sie zum neu erstellten Repository weitergeleitet.

[!WARNUNG]
Nach Abschluss der Schritte in diesem Lab verfügen Sie über einen öffentlich verfügbaren MCP-Server in Azure. Idealerweise ist das jedoch nicht erwünscht. Löschen Sie die Azure-Web-App nach Abschluss des Labs.

Bereitstellen der Azure-Web-App

1. Gehen Sie zu portal.azure.com
2. Bewegen Sie den Mauszeiger ü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 aus
4. Klicken Sie in das Textfeld Resource group und geben Sie einen Ressourcengruppennamen ein, z. B. „jokesgrp“.
5. Wählen Sie aus der Dropdown-Liste Region die Region aus, die Ihnen am nächsten liegt.
6. Klicken Sie auf Review + create
7. Klicken Sie Create
8. Wählen Sie Go to resource group
9. Wählen Sie Create
10. Klicken Sie in das search box

11. Typ web app
12. Wählen Sie im Web-App-Suchergebnis die Create button aus

13. Web App auswählen

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

15. Wählen Sie das Dropdown-Menü Runtime stack und wählen Sie Node 22 LTS

16. Wählen Sie die Dropdown-Liste Region und wählen Sie die Region aus, die Ihnen am nächsten liegt

17. Klicken Sie auf Review + create

18. Klicken Sie 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 aus.

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 aus

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

29. Klicken Sie auf das Dropdown-Menü Branch und wählen Sie Ihre Filiale aus

30. Behalten Sie für alle anderen die Standardeinstellungen bei und wählen Sie Save

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

32. Überprüfen, ob die Bereitstellung abgeschlossen ist

Erstellen des Power Platform Connectors

1. Gehen Sie zu https://make.powerapps.com/
2. Wählen Sie im linken Menü More
3. Wählen Sie die Schaltfläche Discover all
4. Wählen Sie unter „Daten“ das pin icon neben Custom connectors aus, um es im linken Menü anzuheften.
5. Wählen Sie im linken Menü Custom connectors aus
6. Wählen Sie New custom connector
7. Wählen Sie Create from blank
8. Geben Sie dem Connector einen Namen (zum Beispiel JokesMCP )
9. Wählen Sie die blaue Schaltfläche Continue
10. Wählen Sie den Swagger editor Umschalter

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 zuvor erstellten Web-App. Entfernen Sie https:// und alles nach azurewebsites.net
13. Wählen Sie Create connector um den Connector zu erstellen

Fügen Sie den MCP-Server als Aktion in Microsoft Copilot Studio hinzu

Jetzt läuft ein MCP-Server in Azure und ein Connector ist in der Power Platform verfügbar. In diesem Schritt erstellen Sie einen Agenten in Microsoft Copilot Studio und fügen den MCP-Server hinzu.

1. Gehen Sie zu https://copilotstudio.microsoft.com
2. Wählen Sie den Umgebungswähler in der oberen rechten Ecke aus
3. Wählen Sie die richtige Umgebung
4. Wählen Sie in der linken Navigation Create aus
5. Wählen Sie die blaue Schaltfläche „ New agent
6. Wählen Sie oben rechts „ Skip to configure “
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 oben rechts Create

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 Screenshot unten).
16. Wählen Sie den Jokes MCP server aus (siehe Nummer 2 im Screenshot unten)

17. Warten Sie, bis die Verbindung hergestellt ist, 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:

Lassen Sie den Rest wie gewohnt, beispielsweise 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 aus.

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

Es wird eine Meldung angezeigt, dass zum Ausführen dieser Aktion zusätzliche Berechtigungen erforderlich sind. Dies liegt an der Benutzerauthentifizierung im Aktionsassistenten.

22. Wählen Sie Connect

Dadurch wird ein neues Fenster geöffnet, 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 hergestellt ist, und wählen Sie Submit

25. Die Verbindung sollte nun hergestellt sein, daher sollte der Status auf Connected gesetzt werden

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

Jetzt sollten Sie wieder im Jokester-Agentenbildschirm sein.

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

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

Hier wird nun ein Chuck-Norris-Witz angezeigt – anstelle der zusätzlichen Berechtigungen.

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

Dies wird jetzt einen Papa-Witz zeigen.

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

Hier wird nun ein Yo-Mama-Witz angezeigt.

Und das war der Jokes MCP-Server im Microsoft Copilot Studio. Dies ist zugleich das Ende des Labs! Hoffentlich hat es Ihnen gefallen. Bitte nehmen Sie sich die Zeit, unser Feedback-Formular auszufüllen.

Witze MCP-Serverdetails

Dies ist ein auf dem TypeScript SDK basierender MCP -Server.

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, stellen Sie sicher, dass Sie npm install im Stammverzeichnis des Repositorys ausführen.

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

Werkzeuge

Folgende Werkzeuge sind im Lieferumfang enthalten:

Get-Chuck-Witz

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

Get-Chuck-Kategorien

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

Papa-Witz verstehen

Dieses Tool ruft einen zufälligen Papa-Witz von icanhazdadjoke.com ab.

Hol-deine-Mama-Witz

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.

Beitragen

Dieses Projekt freut sich über Beiträge und Vorschläge. Für die meisten Beiträge müssen Sie einer Contributor License Agreement (CLA) zustimmen. Darin erklären Sie, dass Sie uns die Nutzungsrechte an Ihrem Beitrag einräumen. Weitere Informationen finden Sie unter https://cla.opensource.microsoft.com .

Wenn Sie einen Pull Request einreichen, prüft ein CLA-Bot automatisch, ob Sie einen CLA bereitstellen müssen, und ergänzt den PR entsprechend (z. B. Statusprüfung, Kommentar). Folgen Sie einfach den Anweisungen des Bots. Sie müssen dies nur einmal für alle Repos tun, die unseren CLA verwenden.

Dieses Projekt folgt dem Microsoft Open Source-Verhaltenskodex . Weitere Informationen finden Sie in den häufig gestellten Fragen zum Verhaltenskodex . Bei Fragen oder Anmerkungen wenden Sie sich bitte 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 Marken- und Markenrichtlinien von Microsoft und muss diese einhalten. Die Verwendung von Microsoft-Marken oder -Logos in modifizierten Versionen dieses Projekts darf weder Verwirrung stiften noch eine Förderung durch Microsoft implizieren. Jede Verwendung von Marken oder Logos Dritter unterliegt den Richtlinien dieser Dritten.