Déboguer les plug-ins MCP et API localement

Les plug-ins permettent aux agents déclaratifs dans Microsoft 365 Copilot d’appeler des serveurs MCP (Model Context Protocol) ou des API REST pour récupérer des données et effectuer des tâches. Microsoft 365 Copilot devez accéder au serveur MCP ou à l’API via Internet. En règle générale, les outils de débogage hébergent des sessions de débogage sur localhost (127.0.0.1), qui est accessible uniquement à partir de l’ordinateur exécutant l’outil de débogage. En utilisant un proxy inverse, tel que tunnels dev, vous pouvez exposer votre session de débogage à Internet pour activer le débogage des appels à partir de Microsoft 365 Copilot.

Cet article explique comment utiliser l’outil pour activer le devtunnel débogage local pour votre serveur ou API MCP.

Remarque

Vos outils de débogage peuvent déjà fournir une solution de proxy inverse. Nous vous recommandons de vérifier la documentation de vos outils de développement. Par exemple, si vous avez créé une API à l’aide de Microsoft 365 Agents Toolkit, le kit de ressources gère la configuration du proxy inverse pour vous.

Configuration requise

  • L’interface devtunnel CLI installée sur l’ordinateur où vous hébergez vos sessions de débogage
  • Numéro de port HTTP utilisé par votre outil de débogage

Créer un tunnel de développement persistant

L’interface devtunnel CLI vous permet de créer un tunnel de développement persistant, un tunnel que vous pouvez arrêter et démarrer en fonction des besoins sans que l’URL hébergée ne change. L’utilisation d’un tunnel avec une URL persistante simplifie le débogage des plug-ins, car vous n’avez pas besoin de mettre à jour vos packages d’application d’agent déclaratif avec de nouvelles URL.

  1. Si vous n’êtes pas encore connecté à l’interface CLI devtunnel, utilisez devtunnel user login --help pour afficher les options disponibles. Connectez-vous à l’interface CLI avant de continuer.

  2. Créez le tunnel, en autorisant l’accès anonyme. L’accès anonyme est nécessaire pour permettre à Microsoft 365 Copilot d’accéder à votre tunnel et n’est pas lié à l’authentification requise par votre API.

    devtunnel create --allow-anonymous

    Conseil

    La création d’un tunnel bascule votre tunnel par défaut sur le tunnel nouvellement créé. Cela vous permet d’omettre l’argument tunnel-id aux commandes suivantes. Si vous créez plusieurs tunnels, vous devrez peut-être utiliser l’argument tunnel-id pour vous assurer que vous utilisez le tunnel attendu. Pour plus d’informations, utilisez la devtunnel --help commande ou consultez Informations de référence sur la ligne de commande dev tunnels.

  3. Ajoutez le numéro de port HTTP utilisé par votre outil de débogage. Remplacez par <port> votre numéro de port et définissez le --protocol paramètre https sur si votre outil de débogage utilise HTTPS sur le port ou http s’il n’utilise pas HTTPS.

    devtunnel port create --port-number <port> --protocol https

  4. Démarrez le tunnel de développement.

    devtunnel host

  5. Pour la première fois en exécutant ce tunnel de développement, copiez l’URL intitulée Se connecter via le navigateur. Ouvrez cette URL dans votre navigateur et sélectionnez Continuer pour activer le tunnel.

    Remarque

    Après avoir sélectionné Continuer, votre navigateur affiche une erreur. Cela est attendu et peut être ignoré.

Une fois le tunnel activé, vous pouvez l’arrêter avec CTRL + C. Vous pouvez redémarrer le tunnel avec la devtunnel host host-id commande .

Utilisation du tunnel de développement

Pour utiliser votre tunnel de développement pour le débogage, chargez une version test d’un package d’application avec l’URL du tunnel de développement à la place de l’URL du serveur.

Définissez la url propriété de l’objet spec de serveur MCP à l’intérieur de votre manifeste de plug-in.

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

Si vous utilisez agents Toolkit dans Visual Studio Code pour gérer votre agent déclaratif, vous pouvez ajouter une variable d’environnement au fichier /env/.env.dev.user nommé PLUGIN_SERVER_URL et l’utiliser à la place de votre URL de tunnel de développement. Utilisez l’étape Provisionner dans le volet Cycle de vie pour charger une version test de votre agent. Dans votre fichier /env/.env.dev.user , ajoutez :

OPENAPI_SERVER_URL=<your-dev-tunnel-url>

Dans le manifeste de votre plug-in, mettez à jour la url propriété :

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

Si vous n’utilisez pas Agents Toolkit, vous pouvez générer un nouveau fichier ZIP de package d’application et charger votre agent.

  • Last updated on