Prerequisiti per l'utilizzo delle app connesse

Prima di iniziare, assicurati di disporre di quanto segue:

  • Un server MCP di cui è stato eseguito il deployment con un endpoint HTTPS sicuro

    Il server MCP deve essere raggiungibile pubblicamente tramite HTTPS utilizzando il trasporto HTTP Streamable (ad esempio https://api.yourdomain.com/v1/mcp).

    Per i dettagli sull'implementazione, consulta la guida per gli sviluppatori di server MCP di Connected Apps Platform.

  • Assicurati che il tuo server possa ricevere richieste da Google

    Se il tuo server limita l'accesso esterno in base all'IP di origine, inserisci nella lista consentita i seguenti indirizzi IP:

    • 108.177.64.0/20
    • 142.250.88.0/22
    • 172.217.80.0/20
    • 192.178.20.0/22
    • 192.179.0.0/20
    • 74.125.232.0/24
    • 136.121.40.0/21

    Gli intervalli IP in uscita di Google possono cambiare nel tempo, quindi ti consigliamo di leggerli dagli elenchi pubblicati da Google e di aggiornare regolarmente la tua lista consentita:

  • Accesso a un account sviluppatore registrato in Google Connected Console

    Dopo aver eseguito l'accesso, assicurati di disporre di una delle seguenti autorizzazioni per le app collegate in Google Connected Console:

    • Visualizza le app collegate
    • Crea e gestisci le app connesse

    I Termini di servizio delle App connesse devono essere accettati anche da un proprietario o amministratore dell'account. La prima volta che la tua organizzazione accede alle app connesse in Google Connected Console, un proprietario dell'account o un amministratore deve accedere e accettare il contratto del programma prima che i membri del team invitati possano procedere.

    Se ritieni di avere l'accesso, ma non riesci a creare app connesse, chiedi al proprietario dell'account o all'amministratore di concedere al tuo account utente l'autorizzazione "Visualizza app connesse" o "Crea e gestisci app connesse" nella pagina Utenti e autorizzazioni.

  • Possibilità di ospitare un file di verifica .well-known sul dominio del tuo server MCP

    Per verificare la proprietà del dominio, devi essere in grado di pubblicare direttamente un file del token di verifica JSON (con HTTP 200 OK e senza reindirizzamenti) all'indirizzo https://<your-domain>/.well-known/google-connected-apps.

  • Esamina le categorie di app collegate disponibili

    La categoria della tua app connessa è associata a funzionalità specifiche che deve supportare per garantire un'esperienza utente di alta qualità. Una volta selezionata una categoria per un'app connessa, non è possibile modificarla. Ulteriori informazioni.

  • Un server MCP di cui è stato eseguito il deployment con un URL endpoint valido

    Per maggiori dettagli, consulta la guida per gli sviluppatori del server MCP delle app connesse.

  • Metadati pubblici e asset del brand per l'app connessa

    • Nome dell'app connessa: il nome visualizzato dell'app connessa mostrato agli utenti nei prodotti Google e utilizzato quando gli utenti menzionano la tua app con @.
    • Descrizione: un riepilogo conciso di una sola frase (meno di 30 parole) di ciò che l'app connessa può fare per gli utenti, ad esempio "Monitora i tuoi acquisti recenti, controlla lo stato della consegna e visualizza la cronologia degli ordini".
    • Icona: un'icona dell'app di 512 x 512 px in formato JPEG o PNG, con una dimensione massima del file di 1 MB (1024 KB).
    • Funzionalità: almeno tre attività di alto valore che la tua app connessa può eseguire, ad esempio "Cerca nella cronologia degli ordini" o "Controlla lo stato della consegna in tempo reale", oltre alle funzionalità predefinite definite dalla categoria della tua app. Queste informazioni vengono mostrate agli utenti per aiutarli a decidere se connettersi. Non includere numeri all'inizio delle funzionalità.
    • Prompt di esempio: almeno tre query di esempio che aiutano gli utenti a capire cosa possono chiedere. Inizia almeno due prompt di esempio con il nome della tua app connessa. Menziona il nome della tua app in modo naturale in almeno un prompt (ovvero senza iniziare con il nome dell'app). Non includere numeri all'inizio dei prompt di esempio.
    • URL dei Termini di servizio: un URL accessibile pubblicamente per i Termini di servizio della tua app connessa.
    • URL delle norme sulla privacy: un URL accessibile pubblicamente per le norme sulla privacy dell'app connessa.
    • URL del sito web (facoltativo): un sito web per l'app connessa.