Google utilizza la tecnologia AI per tradurre i contenuti nella tua lingua preferita. Le traduzioni generate dall'AI potrebbero contenere errori.

Testa, esegui il debug e valuta nella modalità sviluppatore delle app Gemini

Utilizza la modalità sviluppatore delle app Gemini per testare in modo interattivo il tuo server Model Context Protocol (MCP), diagnosticare errori di schema o di runtime e valutare la qualità dello strumento prima di inviare l'app collegata per la revisione in Google Connected Console.

Questa guida illustra le seguenti attività:

Attiva la modalità sviluppatore delle app Gemini in Gemini, crea un'app MCP personalizzata e verifica il rilevamento iniziale degli strumenti.
Esegui il debug delle chiamate agli strumenti non riusciti, sincronizza gli schemi aggiornati e testa l'autenticazione.
Simula il contesto dell'ambiente utente e configura l'autenticazione client.

Per un'introduzione al layout dell'area di lavoro e alle schede di controllo, consulta la panoramica della modalità sviluppatore delle app Gemini.

Attiva la modalità sviluppatore delle app Gemini

Se esegui l'onboarding del tuo server MCP in Google Connected Console, la tua app registrata è già disponibile quando attivi la modalità sviluppatore delle app Gemini e puoi saltare il passaggio 2. Se vuoi testare un endpoint del server MCP HTTPS di cui è stato eseguito il deployment direttamente in Gemini prima di registrarlo nella console, segui entrambi i passaggi per attivare la modalità sviluppatore delle app Gemini e connettere il tuo server come app MCP personalizzata.

Passaggio 1: attiva la modalità sviluppatore delle app Gemini

Apri Gemini nel tuo browser web.
Fai clic su Impostazioni > Modalità sviluppatore delle app Gemini (o vai direttamente alla pagina gemini.google.com/devmode).

(Facoltativo) Passaggio 2: crea e testa un'app MCP personalizzata

Per connettere il tuo server MCP come app personalizzata nella modalità sviluppatore delle app Gemini, segui questi passaggi:

Nella finestra di dialogo Scegli un'app, fai clic su + Crea nuova.
Nella finestra di dialogo Connettiti a un server MCP, inserisci l'endpoint HTTPS pubblico del tuo server in URL del server MCP (assicurati che l'URL inizi con https://, ad esempio https://your-app-link.com/mcp).
Se il tuo server richiede credenziali OAuth preregistrate, fai clic su Impostazioni aggiuntive > Mostra altro per inserire l'ID client e il client secret OAuth, quindi fai clic su Avanti.
Nella finestra di dialogo di conferma della sicurezza e della privacy, esamina il modo in cui Gemini interagisce con il tuo server MCP personalizzato:
- Esecuzione degli strumenti: Gemini esegue gli strumenti del server MCP per attivare ed eseguire le funzioni disponibili per gestire le tue richieste.
- Recupero e condivisione dei dati: Gemini recupera e gestisce risorse, schemi e contesto esposti dagli endpoint del tuo server MCP e potrebbe condividere le informazioni a cui ha accesso in base alle impostazioni del tuo Account Google o quando interagisce con altre app connesse.
- Attendibilità e disconnessione: assicurati che il server MCP sia attendibile e consulta le sue norme sulla privacy prima di procedere. Puoi disconnettere il server in qualsiasi momento dalla pagina App connesse o eliminare il relativo link dai collegamenti del tuo Account Google.
Seleziona Dichiaro di aver compreso e di accettare i rischi per la sicurezza e la privacy legati alla connessione di questa app personalizzata, quindi fai clic su Connetti.
Nella finestra di dialogo Salva l'app personalizzata, inserisci un nome visualizzato per l'app personalizzata, verifica che gli strumenti del server vengano visualizzati nell'elenco Azioni disponibili e fai clic su Connetti.
Nel riquadro laterale della modalità sviluppatore delle app Gemini, seleziona la scheda Schemi degli strumenti per esaminare le informazioni su ogni strumento nell'app connessa, tra cui le definizioni dei parametri, i badge di sicurezza (Sola lettura, Distruttivo, Autenticazione richiesta), lo Schema non elaborato e la Struttura della risposta.
Nel riquadro della chat a sinistra, inserisci prompt in linguaggio naturale o @mention (ad esempio, @MyApp show my profile) e monitora la scheda Log eventi per vedere come funziona lo strumento.

Esegui il debug delle chiamate allo strumento

Quando una chiamata allo strumento non va a buon fine o produce argomenti imprevisti, puoi esaminare la telemetria diagnostica, aggiornare il server MCP di backend ed eseguire il ricaricamento rapido dello schema senza cancellare la cronologia delle conversazioni.

Per eseguire il debug di una chiamata allo strumento non riuscita, segui questi passaggi:

Nel riquadro a destra, seleziona la scheda Log eventi.
Fai clic sull'evento non riuscito nell'elenco Telemetria per espandere i dettagli ed esaminare il payload della richiesta Tool call e la risposta Tool result:
- Errori di connessione e di rete: controlla i messaggi di errore e la latenza per verificare che l'endpoint sia raggiungibile.
- Errori di autenticazione: se l'evento restituisce 401 o 403, verifica lo stato del token OAuth o le credenziali client nella scheda Autenticazione.
- Mancate corrispondenze nella convalida dello schema: se il server restituisce un errore di parametri non validi MCP (-32602), confronta gli argomenti JSON generati dal modello in Tool call con i tipi di parametri, le proprietà obbligatorie e le istruzioni di formato nella scheda Schemi degli strumenti.
- Eccezioni di runtime del server: controlla il codice di errore JSON-RPC e il messaggio in Tool result per diagnosticare le eccezioni di backend.
Per risolvere il problema, aggiorna l'implementazione del server MCP o perfeziona le descrizioni degli strumenti e dei parametri. Per indicazioni su come scrivere schemi degli strumenti e risposte di errore chiari, consulta Standard di integrazione delle app connesse MCP.
Nella scheda Schemi degli strumenti, fai clic su Sincronizza schema. Gemini recupera nuovamente tools/list dal tuo server MCP e aggiorna le definizioni degli strumenti attivi preservando il thread di chat corrente.
Riprova a fare la query. Nella scheda Log eventi, verifica che la chiamata allo strumento riprodotta restituisca 200 OK e mostri la risposta prevista nell'anteprima della chat.

Simula il contesto dell'ambiente e l'autenticazione

Puoi testare il modo in cui gli strumenti MCP rispondono a diverse località, fusi orari, impostazioni internazionali e metodi di autenticazione degli utenti direttamente nel riquadro di ispezione.

Esegui l'override del contesto dell'ambiente

Per simulare il contesto utente per gli strumenti sensibili a data, ora o impostazioni internazionali, segui questi passaggi:

Nel riquadro a destra, seleziona la scheda Environment (Ambiente).
In Data e ora, seleziona una Data simulata e un'Ora simulata per testare le espressioni di tempo relative (ad esempio "domattina" o "questo sabato pomeriggio").
In Preferenze, seleziona una Lingua per simulare le impostazioni internazionali dell'utente (ad esempio en-US).
Esegui un prompt di test nel riquadro della chat per valutare lo strumento con il contesto simulato.
Per ripristinare le impostazioni predefinite dell'ambiente, fai clic su Reimposta.

Configura l'autenticazione client

Per configurare o cambiare il metodo di autenticazione utilizzato durante la sessione della modalità sviluppatore delle app Gemini, procedi come segue:

Nel riquadro a destra, seleziona la scheda Autenticazione.
In Configurazione autenticazione client, seleziona una delle seguenti modalità di autenticazione:
- Dynamic Client Registration: utilizza un flusso OAuth per negoziare automaticamente le credenziali con il server di autorizzazione. Per saperne di più, consulta la guida all'implementazione di OAuth 2.1. Se applicabile, inserisci l'endpoint in Aggiungi un link all'app personalizzato.
- Registrazione manuale del client: consente di fornire manualmente un ID client e un client secret preregistrati. Espandi Impostazioni avanzate per configurare ulteriori override del flusso.
Fai clic su Salva e attendi che venga visualizzato il messaggio Salvato. Quindi, esegui un prompt di test per verificare che gli strumenti autenticati funzionino correttamente.