Lokales Debuggen von MCP- und API-Plug-Ins

Tipp

Empfohlen: Beginnen Sie mit Work IQ Dev Tools für unterstützte Pro-Code-, deklarative Agent- und Plug-In-Szenarien. Siehe WIQD-Schnellstart. Toolkitbasierte Anweisungen bleiben für vorhandene Projekte und Workflows verfügbar, die sie erfordern. Überprüfen Sie die Unterstützung der Funktionen und der Zielerfahrung , bevor Sie ein Tool auswählen: WIQD ist nicht für benutzerdefinierte Engine-Agenten vorgesehen.

Plugins ermöglichen es deklarativen Agents in Microsoft 365 Copilot, MCP-Server (Model Context Protocol) oder REST-APIs aufzurufen, um Daten abzurufen und Aufgaben auszuführen. Microsoft 365 Copilot muss den MCP oder API-Server über das Internet erreichen. In der Regel hosten Debuggingtools Debugsitzungen auf localhost (127.0.0.1), auf das nur von dem Computer zugegriffen werden kann, auf dem das Debugtool ausgeführt wird. Mithilfe eines Reverseproxys, z. B. Entwicklertunnel, können Sie Ihre Debugsitzung für das Internet verfügbar machen, um Debuggingaufrufe von Microsoft 365 Copilot zu aktivieren.

In diesem Artikel erfahren Sie, wie Sie das devtunnel Tool verwenden, um das lokale Debuggen für Ihren MCP-Server oder Ihre API zu aktivieren.

Hinweis

Ihre Debuggingtools bieten möglicherweise bereits eine Reverseproxylösung. Wir empfehlen, zur Bestätigung Ihre Entwicklertools in der Dokumentation nachzusehen. Wenn Sie beispielsweise eine neue API mit dem Microsoft 365 Agents Toolkit erstellt haben, übernimmt das Toolkit die Konfiguration des Reverseproxys für Sie.

Voraussetzungen

  • Die devtunnel CLI, die auf dem Computer installiert ist , auf dem Sie Ihre Debugsitzungen hosten
  • Die vom Debuggingtool verwendete HTTP-Portnummer.

Erstellen eines beständigen Dev-Tunnels

Mit der devtunnel CLI können Sie einen beständigen Dev-Tunnel erstellen – einen Tunnel, den Sie bei Bedarf beenden und starten können, ohne dass sich die gehostete URL ändert. Die Verwendung eines Tunnels mit einer persistenten URL vereinfacht das Debuggen für Plug-Ins, da Sie Ihre deklarativen Agent-App-Pakete nicht mit neuen URLs aktualisieren müssen.

  1. Wenn Sie noch nicht bei der devtunnel-CLI angemeldet sind, verwenden Sie devtunnel user login --help diese Optionen, um die verfügbaren Optionen anzuzeigen. Melden Sie sich beim CLI an, bevor Sie fortfahren.

  2. Erstellen Sie den Tunnel, der anonymen Zugriff zulässt. Der anonyme Zugriff ist erforderlich, damit Microsoft 365 Copilot auf Ihren Tunnel zugreifen kann, und steht in keinem Zusammenhang mit einer von Ihrer API geforderten Authentifizierung.

    devtunnel create --allow-anonymous
    

    Tipp

    Beim Erstellen eines neuen Tunnels wird Ihr Standardtunnel auf den neu erstellten umgestellt. Auf diese Weise können Sie das tunnel-id Argument für nachfolgende Befehle weglassen. Wenn Sie mehrere Tunnel erstellen, müssen Sie möglicherweise das tunnel-id Argument verwenden, um sicherzustellen, dass Sie den erwarteten Tunnel verwenden. Weitere Informationen finden Sie unter devtunnel --helpBefehlszeilenreferenz zu Dev-Tunnels.

  3. Fügen Sie die HTTP-Portnummer hinzu, die von Ihrem Debuggingtool verwendet wird. Ersetzen Sie dies durch Ihre Portnummer <port> , und legen Sie den --protocol Parameter darauf fest https , ob Ihr Debuggingtool HTTPS für den Port verwendet oder http ob es HTTPS nicht verwendet.

    devtunnel port create --port-number <port> --protocol https
    
  4. Starten Sie den Entwicklungstunnel.

    devtunnel host
    
  5. Kopieren Sie beim erstmaligen Ausführen dieses Dev-Tunnels die URL mit der Bezeichnung Connect via browser. Öffnen Sie diese URL in Ihrem Browser und wählen Sie "Weiter" aus, um den Tunnel zu aktivieren.

    Hinweis

    Nachdem Sie "Weiter" ausgewählt haben, zeigt Ihr Browser einen Fehler an. Dies wird erwartet und kann ignoriert werden.

Sobald der Tunnel aktiviert ist, können Sie den Tunnel mit STRG + C beenden. Sie können den Tunnel mit dem devtunnel host host-id Befehl neu starten.

Verwenden des Dev-Tunnels

Um Ihren Dev-Tunnel zum Debuggen zu verwenden, querladen Sie ein App-Paket mit der URL des Dev Tunnels anstelle der URL des Servers.

Legen Sie die url Eigenschaft des MCP-Serverspezifikationsobjekts in Ihrem Plug-In-Manifest fest.

"runtimes": [
  {
    "type": "RemoteMCPServer",
    "spec": {
      "url": "<your-dev-tunnel-url>",
    }
  }
]

Wenn Sie das Agents Toolkit in Visual Studio Code verwenden, um Ihren deklarativen Agent zu verwalten, können Sie der Datei /env/.env.dev.user eine Umgebungsvariable namens hinzufügen PLUGIN_SERVER_URL und diese anstelle Ihrer Dev-Tunnel-URL verwenden. Verwenden Sie den Schritt "Bereitstellen " im Bereich "Lebenszyklus ", um Ihren Agent querzuladen. Fügen Sie in Ihrer Datei /env/.env.dev.user Folgendes hinzu:

OPENAPI_SERVER_URL=<your-dev-tunnel-url>

Aktualisieren Sie in Ihrem Plug-In-Manifest die url Eigenschaft:

"runtimes": [
  {
    "type": "RemoteMCPServer",
    "spec": {
      "url": "${{PLUGIN_SERVER_URL}}",
    }
  }
]

Wenn Sie Agents Toolkit nicht verwenden, können Sie eine neue ZIP-Paketdatei generieren und Ihren Agent hochladen.