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

• Visual Studio Code ( Link )
• Node v22 (idealerweise über nvm für Windows oder nvm installiert)
• Git installiert ( Link )
• Azure Developer CLI ( Link )
• Azure-Abonnement (mit hinzugefügter Zahlungsmethode)
• GitHub-Konto
• Test- oder Entwicklerkonto für Copilot Studio
• Bereitgestellte Power Platform-Umgebung – mit folgendem Schalter:

➕ 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 aus (dieser ist möglicherweise bereits ausgewählt, wenn Sie nur einen Eigentümer zur Auswahl haben).
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.

⚖️ Auswahl: Server lokal ausführen oder in Azure bereitstellen

Jetzt haben Sie die Wahl! Entweder Sie betreiben den Server lokal – oder Sie stellen ihn in Azure bereit.

Für beides müssen Sie einige Schritte ausführen:

1. Klonen Sie dieses Repository, indem Sie den folgenden Befehl ausführen (ersetzen Sie {account} durch Ihren eigenen GitHub-Kontonamen):git clone https://github.com/{account}/mcsmcp.git
2. Öffnen Sie Visual Studio Code und öffnen Sie den geklonten Ordner
3. Öffnen Sie das Terminal und navigieren Sie zum geklonten Ordner

🏃‍♀️ Führen Sie den MCP-Server lokal aus

1. Führen Sie npm install
2. Führen Sie npm run build && npm run start
3. Wählen Sie oben im Visual Studio Code-Terminal PORTS aus
4. Wählen Sie die grüne Schaltfläche Forward a Port
5. Geben Sie 3000 als Portnummer ein (dies sollte mit der Portnummer übereinstimmen, die Sie beim Ausführen des Befehls in Schritt 5 sehen). Möglicherweise werden Sie aufgefordert, sich bei GitHub anzumelden. Tun Sie dies in diesem Fall bitte, da dies für die Nutzung der Portweiterleitungsfunktion erforderlich ist.
6. Klicken Sie mit der rechten Maustaste auf die Zeile, die Sie gerade hinzugefügt haben, und wählen Sie Port visibility > Public , um den Server öffentlich verfügbar zu machen
7. Strg + Klick auf die Forwarded address , die etwa so aussehen sollte: https://something-3000.something.devtunnels.ms
8. Wählen Sie im folgenden Popup Copy , um die URL zu kopieren
9. Öffnen Sie den Browser Ihrer Wahl und fügen Sie die URL in die Adressleiste ein, geben Sie dahinter /mcp ein und drücken Sie die Eingabetaste

Wenn alles gut gegangen ist, wird die folgende Fehlermeldung angezeigt:

Keine Sorge – diese Fehlermeldung ist kein Grund zur Beunruhigung!

🌎 In Azure bereitstellen

[!WICHTIG] Wie in den Voraussetzungen aufgeführt, muss für diesen Teil die Azure Developer CLI auf Ihrem Computer installiert sein.

Denken Sie daran, sich bei der Azure Developer CLI anzumelden, falls Sie dies noch nicht getan haben.

[!WARNUNG]
Nach dem Ausführen azd up verfügen Sie über einen öffentlich verfügbaren MCP-Server in Azure. Idealerweise ist das nicht erwünscht. Führen Sie azd down nach Abschluss des Labs aus, um alle Ressourcen aus Ihrem Azure-Abonnement zu löschen. Informationen zur Ausführung von azd down finden Sie in diesem Abschnitt .

Führen Sie den folgenden Befehl im Terminal aus:

Geben Sie als eindeutigen Umgebungsnamen mcsmcplab oder etwas Ähnliches ein. Wählen Sie das zu verwendende Azure-Abonnement und einen Wert für den Standort aus. Anschließend dauert es einige Minuten, bis der Server bereitgestellt ist. Anschließend sollten Sie die am Ende aufgeführte URL aufrufen und /mcp an das Ende dieser URL anhängen können.

Sie sollten erneut den folgenden Fehler sehen:

👨‍💻 Verwenden Sie den Jokes MCP-Server in Visual Studio Code / GitHub Copilot

Um den Jokes MCP-Server zu verwenden, müssen Sie die URL Ihres Servers (kann entweder Ihre Devtunnel-URL oder Ihre bereitgestellte Azure Container App sein) mit dem Teil /mcp am Ende verwenden und ihn als MCP-Server in Visual Studio Code hinzufügen.

1. Drücken Sie entweder ctrl + shift + P (Windows/Linux) oder cmd + shift + P (Mac) und geben Sie MCP ein
2. Wählen Sie MCP: Add Server...
3. Wählen Sie HTTP (HTTP or Server-Sent Events)
4. Fügen Sie die URL Ihres Servers in das Eingabefeld ein (stellen Sie sicher, dass am Ende /mcp enthalten ist).
5. Drücken Sie Enter
6. Geben Sie einen Namen für den Server ein, zum Beispiel JokesMCP
7. Wählen Sie User Settings , um die MCP-Servereinstellungen in Ihren Benutzereinstellungen zu speichernDadurch wird Ihrer Datei settings.json ein MCP-Server hinzugefügt. Er sollte wie folgt aussehen:
8. Öffnen Sie GitHub Copilot
9. Wechseln Sie vom Ask zum Agent
10. Stellen Sie sicher, dass die JokesMCP -Serveraktionen ausgewählt sind, wenn Sie das Werkzeugsymbol auswählen:

11. Stellen Sie die folgende Frage:

Sie sollten eine Antwort wie diese erhalten:

Jetzt haben Sie den JokesMCP -Server zu Visual Studio Code hinzugefügt!

👨‍💻 Verwenden Sie den Jokes MCP-Server in Microsoft Copilot Studio

Importieren des Connectors

1. Gehen Sie zu https://make.preview.powerapps.com/customconnectors (stellen Sie sicher, dass Sie sich in der richtigen Umgebung befinden) und klicken Sie auf + Neuer benutzerdefinierter Connector .
2. Wählen Sie Import from GitHub
3. Wählen Sie Custom als Konnektortyp aus.
4. Wählen Sie dev als Zweig
5. Wählen Sie MCP-Streamable-HTTP als Connector
6. Wählen Sie Continue
7. Ändern Sie den Connector-Namen in einen passenden Namen, beispielsweise Jokes MCP
8. Ändern Sie die Beschreibung in etwas Passendes
9. Fügen Sie Ihre Stamm-URL (z. B. something-3000.something.devtunnels.ms oder something.azurecontainerapps.io ) in das Feld Host ein.
10. Wählen Sie Connector erstellen

[!WARNUNG]
Möglicherweise werden Ihnen beim Erstellen eine Warnung und ein Fehler angezeigt. Diese sollten bald behoben sein. Sie können sie jedoch vorerst ignorieren.

11. Schließen Sie den Connector

Erstellen Sie einen Agenten und fügen Sie den MCP-Server als Tool hinzu

1. Gehen Sie zu https://copilotstudio.preview.microsoft.com/
2. Wählen Sie den Umgebungswähler in der oberen rechten Ecke aus
3. Wählen Sie die richtige Umgebung aus (die Umgebung mit aktiviertem Schalter Get new features early “).
4. Wählen Sie in der linken Navigation Create aus
5. Wählen Sie die blaue Schaltfläche „ New agent
6. Wählen Sie links die Registerkarte 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 Continue

11. Aktivieren Sie die generative KI- Orchestration

12. Deaktivieren Sie allgemeines Wissen im Abschnitt Knowledge

13. Wählen Sie im oberen Menü Tools

14. Wählen Sie Add a tool

15. Wählen Sie die Registerkarte Model Context Protocol , um alle Model Context Protocol-Server zu filtern (siehe Nummer 1 im Screenshot unten).
16. Wählen Sie den Jokes MCP -Server aus (siehe Nummer 2 im Screenshot unten)

17. Erstellen Sie eine neue Verbindung, indem Sie „ Not connected und „Neue Verbindung erstellen“ auswählen.

18. Wählen Sie Create

19. Wählen Sie Add to agent , um das Tool 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:

Anstelle der zusätzlichen Berechtigungen wird nun ein Chuck-Norris-Witz angezeigt. Falls dies nicht der Fall ist, haben Sie wahrscheinlich die Voraussetzung übersehen, dass in der Umgebung die get new features early nutzen“ aktiviert sein muss.

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

Dies wird jetzt einen Papa-Witz zeigen.

Und das war der Jokes MCP-Server, der im Microsoft Copilot Studio funktionierte.

❌ Entfernen der Azure-Ressourcen

Um die Azure-Ressourcen nach Abschluss des Labors zu entfernen, führen Sie den folgenden Befehl im Terminal aus:

Dieser Befehl zeigt Ihnen die zu löschenden Ressourcen an und fordert Sie anschließend zur Bestätigung auf. Bestätigen Sie mit y , und die Ressourcen werden gelöscht. Dies kann einige Minuten dauern, aber am Ende erhalten Sie eine Bestätigung:

💡 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.

🗣️ Feedback

Wir hoffen, Ihnen hat das Lab gefallen. Nehmen Sie sich bitte die Zeit, unser Feedback-Formular auszufüllen und uns mitzuteilen, wie wir uns verbessern können!

🚀 Mitwirken

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.