View a markdown version of this page

Utiliser le MCP Inspector - Amazon Bedrock AgentCore
Résolution des problèmes

Utiliser le MCP Inspector

Le MCP Inspector, disponible via le Model Context Protocol (MCP), est un outil de développement qui vous permet de tester et de déboguer des serveurs MCP via une interface interactive. Vous pouvez connecter votre AgentCore passerelle à l'inspecteur MCP pour vous aider à déboguer les cibles de votre passerelle.

Pour plus d'informations sur le MCP Inspector, consultez la documentation du MCP Inspector.

Pour connecter votre passerelle à l'inspecteur

  1. Ouvrez un terminal et exécutez npx @modelcontextprotocol/inspector pour effectuer les opérations suivantes :

    1. Installation de l'inspecteur

    2. Démarrez l'inspecteur sur localhost.

    3. Générez un jeton de session pour l'authentification.

    4. Ouvrez votre navigateur pour accéder à l'interface de l'inspecteur.

  2. Dans l'interface de l'inspecteur, configurez les champs suivants :

    • Type de transport — Sélectionnez le protocole HTTP streamable

    • URL — Entrez l'URL du point de terminaison de la passerelle renvoyée lors de la création de votre passerelle.

    • Développez l'authentification. La section En-têtes personnalisés doit être préremplie avec une paire clé-valeur.

  3. Choisissez Se connecter. Vous serez connecté à votre passerelle. Vous pouvez utiliser le MCP Inspector comme outil pour examiner et tester votre passerelle avant de l'intégrer à votre agent.

Pour plus d'informations sur la manière dont vous pouvez inspecter le serveur MCP auquel votre passerelle est connectée, consultez la section Présentation des fonctionnalités dans la documentation de MCP Inspector.

Important

Le MCP Inspector est un outil de développement qui ne doit pas être utilisé dans les environnements de production. Sécurisez toujours vos jetons d'accès et vos identifiants de passerelle.

Résolution des problèmes

Si vous rencontrez des problèmes lors de l'utilisation du MCP Inspector avec votre passerelle, vérifiez les points suivants :

  • Problèmes de connexion : assurez-vous que l'URL de votre passerelle est correcte et accessible depuis votre réseau

  • Problèmes d'authentification : vérifiez que votre jeton d'accès est valide et qu'il n'a pas expiré

  • Erreurs d'invocation de l'outil : vérifiez les messages d'erreur dans la réponse et assurez-vous que vos paramètres d'entrée correspondent au schéma de l'outil

  • Erreurs de proxy : si vous voyez des erreurs liées à la connexion proxy, essayez de redémarrer MCP Inspector