View a markdown version of this page

Usa MCP Inspector - Fondamento Amazon AgentCore
Risoluzione dei problemi

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

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 tuo AgentCore gateway all'MCP Inspector per aiutarti a eseguire il debug delle destinazioni del gateway.

Per ulteriori informazioni su MCP Inspector, consultate la documentazione di MCP Inspector. https://modelcontextprotocol.io/docs/tools/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 e accedi all'interfaccia Inspector.

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

    • Tipo di trasporto: seleziona Streamable HTTP

    • URL: inserisci l'URL dell'endpoint del gateway restituito quando hai creato il gateway.

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

      • Il nome della chiave deve essere. Authorization

      • Sostituisci il valore con le credenziali di autorizzazione in entrata del tuo gateway.

  3. Scegli Connetti. Verrai connesso al tuo gateway. Puoi utilizzare MCP Inspector come strumento per esaminare e testare il tuo gateway prima di integrarlo con il tuo agente.

Per ulteriori informazioni su come ispezionare il server MCP a cui è connesso il gateway, consultate Panoramica delle funzionalità nella panoramica delle funzionalità nella documentazione di MCP Inspector. https://modelcontextprotocol.io/docs/tools/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 riscontri problemi durante l'utilizzo di MCP Inspector con il tuo gateway, controlla quanto segue:

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

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

  • Errori di richiamo 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