View a markdown version of this page

Usa MCP Inspector - Amazon Bedrock AgentCore
Risoluzione dei problemi

Usa MCP Inspector

MCP Inspector, disponibile tramite il Model Context Protocol (MCP), è uno strumento per sviluppatori che consente di testare ed eseguire il debug dei server MCP tramite un'interfaccia interattiva. Puoi connettere il AgentCore gateway all'MCP Inspector per aiutarti a eseguire il debug degli obiettivi del gateway.

Per ulteriori informazioni su MCP Inspector, consultate la documentazione di MCP Inspector.

Per connettere il gateway all'ispettore

  1. Apri un terminale ed npx @modelcontextprotocol/inspector esegui le seguenti operazioni:

    1. Installa l'ispettore

    2. Avvia l'ispettore su localhost.

    3. Genera un token di sessione per l'autenticazione.

    4. Apri il browser all'interfaccia Inspector.

  2. Nell'interfaccia dell'ispettore, configura i seguenti campi:

    • Tipo di trasporto: seleziona Streamable HTTP

    • URL: immetti l'URL dell'endpoint del gateway restituito al momento della creazione del gateway.

    • Espandi Autenticazione. La sezione Custom Headers deve essere precompilata con una coppia chiave-valore.

  3. Scegli Connetti. Sarai connesso al tuo gateway. È possibile utilizzare MCP Inspector come strumento per esaminare e testare il gateway prima di integrarlo con il proprio agente.

Per ulteriori informazioni su come ispezionare il server MCP a cui è connesso il gateway, vedere Panoramica delle funzionalità nella panoramica delle funzionalità nella documentazione di MCP Inspector.

Importante

MCP Inspector è uno strumento di sviluppo e non deve essere utilizzato in ambienti di produzione. Proteggi sempre i token di accesso e le credenziali del gateway.

Risoluzione dei problemi

Se riscontrate problemi durante l'utilizzo di MCP Inspector con il gateway, controllate quanto segue:

  • Problemi di connessione: assicuratevi che l'URL del gateway sia corretto e accessibile dalla rete

  • Problemi di autenticazione: verifica che il token di accesso sia valido e non sia scaduto

  • Errori di invocazione dello strumento: controlla i messaggi di errore nella risposta e assicurati che i parametri di input corrispondano allo schema dello strumento

  • Errori proxy: se vedi errori relativi alla connessione proxy, prova a riavviare MCP Inspector