Registra, testa e pubblica l'app connessa

Una volta soddisfatti i prerequisiti, segui questi passaggi per registrare, configurare, testare e pubblicare la tua app connessa.

Passaggio 1: crea un'app connessa

Per creare un'app connessa:

  1. Accedi a Google Connected Console.
  2. Nella home page, seleziona Crea app.
  3. Nella finestra di dialogo Scegli cosa creare:
    • Se ti viene chiesto di accettare i Termini di servizio delle App connesse, seleziona Visualizza i termini, leggi e accetta il contratto, quindi seleziona Crea. Solo un amministratore dell'account può accettare il contratto.
    • In caso contrario, seleziona Crea nella scheda App collegata.

  4. Nella finestra di dialogo Assegna un nome all'app connessa, digita un nome per l'app connessa. Questo è il nome che verrà utilizzato per visualizzare l'app connessa nei prodotti Google ed è il modo in cui gli utenti menzioneranno l'app connessa utilizzando @. Seleziona Avanti.

  5. Nella finestra di dialogo Seleziona una categoria di app connessa, seleziona il dominio, la categoria o il settore della tua app dal menu Seleziona una categoria.

  6. Nella finestra di dialogo Scegli il tipo di connessione, scegli una delle seguenti opzioni:

    • Server MCP: collega un server MCP per rendere i tuoi servizi disponibili agli utenti di Gemini e della Ricerca su web, Android e iOS.
    • MCP per Android: rendi le funzionalità sul dispositivo accessibili a Gemini su Android, in modo che possa avviare azioni e completare attività per gli utenti all'interno della tua app.

    Scopri di più su come configurare un'app connessa Android MCP. Puoi scegliere un solo tipo di connessione per app connessa e questa scelta non può essere modificata in un secondo momento.

  7. Seleziona Crea app connessa.

In questo modo, si apre la pagina di riepilogo della gestione dell'app connessa (Configura e testa l'app connessa), dove puoi configurare i dettagli dell'app, la connessione al server MCP e i tester.

Passaggio 2: inserisci i dettagli dell'app connessa

Per fornire maggiori dettagli sulla tua app connessa e configurare il modo in cui viene visualizzata dagli utenti:

  1. Nella pagina di riepilogo dell'app collegata, nella riga Dettagli sull'app, seleziona Inizia (o Gestisci se stai aggiornando i dettagli esistenti).
  2. Nella parte superiore della pagina Dettagli sull'app, verifica il campo Nome app collegata. Se necessario, puoi aggiornare il nome. Questo nome viene mostrato agli utenti nei prodotti Google e viene utilizzato quando gli utenti menzionano la tua app con @.
  3. Nella sezione Dettagli pubblici, in Icona, carica l'icona dell'app (JPG o PNG, fino a 1 MB e 512 x 512 px).

  4. Completa i seguenti campi:

    • Descrizione: inserisci un riepilogo conciso di una sola frase (meno di 30 parole) che descriva le funzionalità principali della tua app connessa e cosa può fare. Questo testo viene mostrato agli utenti e non viene utilizzato come istruzioni per il modello.
    • Funzionalità: inserisci almeno tre attività di alto valore che la tua app connessa può eseguire. Seleziona Aggiungi funzionalità per aggiungere altre voci. Non includere numeri all'inizio delle funzionalità. Includi una sola funzionalità per voce. Se la tua categoria include funzionalità predefinite, queste vengono visualizzate in cima all'elenco e non possono essere modificate.
    • Prompt di esempio: inserisci almeno tre prompt di esempio che aiutino gli utenti a capire cosa possono chiedere. Seleziona Aggiungi prompt di esempio per aggiungere voci.
      • Almeno due prompt devono iniziare con @<YourAppName> (ad esempio, @Order Tracker where is my last order?).
      • Menziona <YourAppName> in modo naturale in almeno un prompt senza iniziare con il nome della tua app (ad esempio, Track my recent order on Order Tracker).
      • Non includere prefissi numerati (1., 2., 3.) né racchiudere i prompt tra virgolette ("...").

    • Localizzazione multilingue: per fornire traduzioni per Descrizione, Funzionalità e Prompt di esempio, racchiudi il testo di ogni lingua nei tag di lingua all'interno del campo di immissione. Ad esempio:

      <en-US>
Play music, manage playlists, and discover artists
</en-US>
<es-ES>
Reproduce música, gestiona listas y descubre artistas
</es-ES>

      Connected Console convalida automaticamente i tag e visualizza le impostazioni internazionali rilevate sotto ogni campo (ad esempio, Found translations for 2 languages: en-US, es-ES).

    • URL dei Termini di servizio: inserisci un link https:// o http:// valido ai tuoi Termini di servizio.

    • URL norme: inserisci un link https:// o http:// valido alle tue norme sulla privacy.

    • URL del sito web (facoltativo): inserisci un link al tuo sito web per l'attribuzione.

  5. Seleziona Salva nella parte inferiore della pagina per tornare alla pagina Panoramica.

Passaggio 3: inserisci l'endpoint MCP e verifica la proprietà del dominio

Prima che Google possa connettersi al tuo server MCP o sincronizzare i tuoi strumenti, devi fornire l'URL dell'endpoint del server MCP e verificare di essere proprietario del dominio su cui è ospitato.

Per inserire l'endpoint MCP e verificare la proprietà del dominio:

  1. Nella pagina Panoramica dell'app connessa, nella scheda Configurazione di MCP e strumenti, seleziona Inizia (o Gestisci se stai aggiornando i dettagli esistenti). Si apre il Passaggio 1 (Endpoint server MCP) del flusso di configurazione di MCP.
  2. In Connetti l'endpoint del server MCP, inserisci l'URL HTTPS completo dell'endpoint del server MCP (ad esempio, https://api.yourdomain.com/v1/mcp).

  3. In Verifica il tuo dominio, completa la verifica del token di verifica per il tuo dominio (se hai già verificato il dominio o il dominio principale nel tuo account sviluppatore, verrà visualizzato automaticamente come verificato):

    1. Nella scheda Verifica la proprietà del dominio, seleziona Scarica token. Il browser scarica un file denominato google-connected-apps.json con la seguente struttura:

      {
  "verification_tokens": [
    "YOUR_VERIFICATION_TOKEN"
  ]
}

    2. Carica e ospita questi contenuti JSON sul tuo server all'indirizzo https://<your-domain>/.well-known/google-connected-apps.

      • Assicurati che l'endpoint sia raggiungibile pubblicamente tramite HTTPS, restituisca HTTP 200 OK direttamente senza reindirizzamenti HTTP e includa il tuo token all'interno dell'array verification_tokens.

    3. Torna a Google Connected Console e seleziona Verifica dominio.

    4. Una volta completata la verifica, la riga Dominio verificato con token di verifica mostra un segno di spunta verde e sblocca la sezione Credenziali di accesso sottostante.

Passaggio 4: configura le credenziali di accesso

Dopo aver verificato il dominio, configura il modo in cui Google esegue l'autenticazione con il tuo server MCP e recupera le definizioni degli strumenti del server.

Per configurare le credenziali di accesso:

  1. Nella sezione Fornisci le credenziali di accesso (nel Passaggio 1 della pagina Configurazione di MCP e degli strumenti), seleziona Inizia (o Aggiorna credenziali per modificare una configurazione esistente).

  2. In Il tuo server richiede l'autorizzazione?, seleziona una delle seguenti opzioni:

    • No: seleziona questa opzione se il tuo server MCP è accessibile pubblicamente senza autenticazione, quindi seleziona Conferma.

    • Sì: seleziona questa opzione se uno degli strumenti esposti dal tuo server MCP richiede l'autorizzazione. Poi, in Seleziona il modello di autorizzazione utilizzato dal tuo server MCP, scegli il flusso di autenticazione:

      • Da macchina a macchina (credenziali client OAuth): seleziona questa opzione per l'autenticazione da servizio a servizio (RFC 6749) in cui Google comunica direttamente con il tuo server MCP utilizzando un ID client e un client secret condivisi senza reindirizzamenti di accesso dell'utente finale:
        1. Inserisci l'ID client (obbligatorio) e il client secret (facoltativo).
        2. Se vuoi, inserisci un Endpoint di autorizzazione (facoltativo) e un Endpoint del token (facoltativo) se il tuo server non li annuncia utilizzando /.well-known/oauth-authorization-server.
        3. Seleziona Registra client (o Aggiorna client).

      • Delegato dall'utente (codice di autorizzazione): seleziona questa opzione se il tuo server MCP richiede ai singoli utenti di accedere e autorizzare le azioni con i propri account utilizzando il collegamento dell'Account Google:

        1. Inserisci nella lista consentita gli URI di reindirizzamento OAuth di Google: nel banner Assicurati di aver inserito nella lista consentita gli URI di reindirizzamento forniti, seleziona Visualizza (o seleziona l'icona di copia) per esaminare gli URI di reindirizzamento specifici dell'app generati per l'app connessa. Aggiungili alla lista consentita del tuo server OAuth, quindi torna alla Console Google Connected.
        2. In Seleziona il modo in cui Google deve autenticarsi con il tuo server OAuth, seleziona la modalità di registrazione del tuo client OAuth:
          • Pre-registrato: scegli questa opzione se generi un ID client e un client secret (facoltativo) statici nel tuo provider OAuth. Puoi anche fornire un Endpoint di autorizzazione personalizzato (facoltativo) e un Endpoint token personalizzato (facoltativo).
          • Client ID Metadata o Dynamic client registration (consigliato): scegli questa opzione se il tuo server supporta OAuth Client ID Metadata Documents (CIMD) o Dynamic Client Registration (RFC 7591). Google controlla prima il CIMD e torna al DCR utilizzando gli endpoint di rilevamento .well-known. Se vuoi, puoi anche specificare endpoint di autorizzazione e token personalizzati.

        3. In Esegui l'autenticazione con le tue credenziali sviluppatore, poiché hai selezionato Delegato dall'utente come modello di autorizzazione, devi accedere al tuo server prima che Google possa recuperare gli strumenti. Seleziona una delle seguenti opzioni:

          • Autenticati tramite popup (consigliato): apre il flusso di autenticazione in una finestra di dialogo sovrapposta. Questa è l'esperienza predefinita.
          • Autenticati tramite reindirizzamento (fallback): apre il flusso di autenticazione utilizzando un reindirizzamento a schermo intero nella stessa scheda o finestra. Scegli questa opzione se il rendering della finestra di dialogo non va a buon fine a causa di vincoli di visualizzazione o intestazioni di sicurezza (come X-Frame-Options o Content-Security-Policy).

          Ti consigliamo di provare prima a eseguire l'autenticazione utilizzando la finestra di dialogo. Se non riesci a eseguire l'autenticazione utilizzando la finestra di dialogo, utilizza il metodo di reindirizzamento. La tua selezione determina anche l'esperienza di accesso degli utenti quando utilizzano per la prima volta l'app connessa.

        4. Seleziona Registra client (o Aggiorna client).

Passaggio 5: fornisci i dettagli dell'account di test (solo per l'autorizzazione delegata dall'utente)

Se l'app connessa richiede l'autenticazione, devi fornire al tuo rappresentante di Google credenziali di test predefinite, precompilate con dati di esempio realistici e con l'autenticazione a due fattori (2FA) disattivata, insieme alle istruzioni di test. In questo modo, il team di revisione e QA di Google può verificare l'esecuzione dello strumento senza essere bloccato da sandbox vuote, paywall o verifiche 2FA. Se Google non può testare completamente la tua app connessa, questa potrebbe essere rifiutata durante la revisione.

Passaggio 6: sincronizza gli strumenti

Per creare ogni versione della tua app connessa, Google si sincronizza con l'endpoint fornito per ottenere gli strumenti disponibili e acquisire un'istantanea. Questi sono gli strumenti che saranno disponibili per gli utenti in quella versione. Mentre la versione dell'app connessa è in anteprima e disponibile per i tester, puoi continuare ad apportare modifiche sul tuo server e sincronizzare nuovamente gli strumenti per l'aggiornamento. In questo modo viene creato un nuovo snapshot dei tuoi strumenti.

Quando pubblichi, viene utilizzata l'istantanea più recente dei tuoi strumenti per quella versione dell'app connessa. Non potrai più apportare modifiche agli strumenti, alle descrizioni o ai dettagli del server. Per aggiornare gli strumenti o sincronizzare eventuali modifiche dal server, crea una nuova versione dell'app connessa. Ti consigliamo di creare un nuovo endpoint per ogni versione della tua app connessa.

Per sincronizzare gli strumenti:

  1. Nella sezione Strumenti di sincronizzazione:

    1. Seleziona Strumenti di sincronizzazione.
    2. Se ti viene chiesto di accedere, autenticati con un account sviluppatore che disponga delle autorizzazioni per elencare tutti gli strumenti che intendi esporre agli utenti. Gli strumenti a cui il tuo account non può accedere non vengono sincronizzati.
    3. Una volta stabilita la connessione, Connected Console mostra il numero di strumenti sincronizzati, oltre al pulsante Sincronizza di nuovo gli strumenti.

  2. Seleziona Avanti in fondo alla pagina per andare al passaggio 2 della configurazione di MCP e degli strumenti.

Passaggio 7: determina come e dove gli utenti utilizzano la tua app

Nella sezione Strumenti della pagina Configurazione di MCP e degli strumenti, configura i parametri di base, ad esempio la disponibilità geografica dell'app connessa, la lingua e i prodotti Google in cui vuoi renderla disponibile.

  1. In Disponibilità, accanto a Rendi disponibile la versione in, configura le seguenti opzioni di targeting:
    • Paesi/regioni: seleziona le posizioni geografiche in cui deve essere disponibile la tua app connessa.
    • Lingue: seleziona le lingue supportate dall'app connessa.
    • Prodotti: seleziona i prodotti Google in cui sarà disponibile la tua app connessa.

  2. Nella sezione Strumenti dopo Disponibilità, esamina gli strumenti sincronizzati dal server MCP. Seleziona uno strumento nell'elenco Strumenti per configurarne le impostazioni nel riquadro Gestisci strumento a destra:

    • Attiva strumento: attiva o disattiva l'opzione Attiva strumento per includere o escludere lo strumento nell'app connessa. Gli strumenti disattivati non saranno disponibili nell'app connessa per l'interazione con gli utenti.

    • Contesto aggiuntivo: seleziona se il tuo strumento richiede indicatori di contesto di Google per funzionare:

      • Impostazioni internazionali: le impostazioni internazionali determinate dall'Account Google dell'utente.
      • Posizione approssimativa: posizione fisica dell'utente o del dispositivo all'interno di un'area pari o superiore a 3 chilometri quadrati (ad esempio, la città in cui si trova l'utente).
      • Posizione esatta: posizione fisica dell'utente o del dispositivo con una precisione pari o inferiore a 50 metri.

    • Conferma dell'utente: seleziona Conferma dell'utente richiesta per richiedere la conferma esplicita dell'utente prima di eseguire lo strumento (questa opzione viene preselezionata automaticamente se le annotazioni MCP dello strumento specificano destructiveHint: true).

  3. Se il tuo server MCP fornisce risorse UI, passa alla scheda Risorse UI accanto a Strumenti per ispezionare le risorse UI del tuo server (text/html, text/html;profile=mcp-app, text/javascript, text/css), verificare quali strumenti sono collegati a ciascuna risorsa ed esaminare la Content Security Policy (CSP) connectDomains e resourceDomains.

  4. Seleziona Salva nella parte inferiore della pagina.

Una volta salvati i dettagli sull'app e la configurazione di MCP e strumenti, la tua configurazione è automaticamente disponibile per tutti i tester che hai aggiunto per l'anteprima e lo stato della versione nella pagina di riepilogo viene aggiornato a Disponibile per i tester.

Passaggio 8: testa l'app connessa

Per rendere la tua app connessa disponibile ai tester, devi aggiungerli nella schermata Gestisci tester. Solo gli utenti che aggiungi all'elenco dei tester possono visualizzare e interagire con la tua app connessa non pubblicata. Puoi aggiungere solo tester che hanno un account @gmail.com.

  1. Nella pagina di riepilogo dell'app connessa, nella scheda Testa la tua app, seleziona Aggiungi tester (o Gestisci tester se ne hai già aggiunti alcuni).

  2. Nella schermata Gestisci i tester, seleziona le mailing list esistenti o seleziona Crea una mailing list per aggiungere gli Account Google autorizzati a testare la tua integrazione. Assicurati di includere il tuo indirizzo email se vuoi testare l'app.

  3. Seleziona Salva.

  4. I tester nell'app Gemini possono richiamare la tua app connessa digitando @ seguito dal nome dell'app connessa e selezionandola dal menu. Puoi anche visualizzare e collegare la tua app in Gemini andando a Impostazioni e guida → App connesse nella barra di navigazione a sinistra.

  5. Ti consigliamo di testare attentamente l'integrazione:

    • Prova tutti i tuoi prompt di esempio.
    • Testa sia le chiamate esplicite di @<AppName> sia le query in linguaggio naturale.
    • Verifica il flusso di autenticazione end-to-end, l'esecuzione dello strumento, i prompt di conferma dell'utente e tutte le risorse della UI.

Quando i test ti soddisfano, puoi inviare la tua app connessa a Google per la revisione.

Passaggio 9: avvia una revisione dell'app connessa e pubblicala dopo l'approvazione

Prima che la tua app connessa possa essere resa disponibile a tutti gli utenti, Google esamina e testa l'integrazione.

Per inviare l'app connessa per la revisione, procedi nel seguente modo:

  1. Nella pagina di riepilogo dell'app connessa, nella scheda Release sul lato destro della pagina, seleziona Invia per la revisione (attivata una volta completata la configurazione dell'app e in anteprima senza problemi di blocco).

  2. Mentre la tua versione è in corso di revisione:

    • Connected Console crea automaticamente una nuova versione bozza modificabile in modo che i tester possano continuare a visualizzare l'anteprima della tua app e tu possa preparare le modifiche future senza interrompere la revisione.
    • Blocca qualsiasi modifica alla versione in fase di revisione.
    • Per visualizzare i dettagli di sola lettura della versione in revisione o annullare la revisione, seleziona il pulsante Altre opzioni (⋮) nella scheda In revisione e seleziona Visualizza dettagli sull'app o Annulla revisione.

  3. Una volta che Google avrà completato la revisione, riceverai una notifica e la scheda Release verrà aggiornata:

    • Se vengono rilevati problemi: nella scheda Release viene visualizzato il messaggio Problemi rilevati. Seleziona Visualizza problemi per esaminare i risultati specifici della revisione. Aggiorna la configurazione o il server MCP nella versione di anteprima modificabile, verifica le correzioni con i tester e seleziona di nuovo Invia per la revisione.
    • Se approvata: nella scheda Release viene visualizzato il messaggio Pronta per la pubblicazione. Seleziona Pubblica quando vuoi rilasciare l'app connessa agli utenti.

Complimenti! La tua app connessa è stata pubblicata e verrà implementata per gli utenti nei prodotti Google selezionati.

Post-pubblicazione e gestione continua delle versioni

Una volta pubblicata, la scheda in basso in Release mostra Pubblicata insieme al numero di versione live dell'app connessa, alla data di pubblicazione e al numero di paesi/regioni, lingue e prodotti target. Puoi selezionare il menu Altre opzioni (⋮) nella scheda Pubblicata e selezionare Visualizza dettagli dell'app in qualsiasi momento per esaminare la configurazione di sola lettura della release pubblicata.

Mentre la versione pubblicata rimane attiva in produzione, puoi utilizzare il riquadro Modifica e testa l'app connessa a sinistra (o selezionare Crea nuova versione se non esiste una bozza) per configurare, visualizzare in anteprima e testare gli aggiornamenti in una nuova versione (Version <N+1>) in modo indipendente prima di inviarla per la revisione e la pubblicazione.