Come collegare Google Merchant Center a ChatGPT via MCP

💡 Niente installazione? Vai direttamente su cloud.anythingmcp.com. Accedi, clicca Connectors → Google Merchant Center, inserisci le credenziali, genera una MCP API key e hai finito. Niente Docker, niente git clone, niente server locale.

Google Merchant Center + ChatGPT

Gestisci Google Merchant Center da qualsiasi agente AI tramite la Merchant API v1: prodotti elaborati e input di prodotto, feed (origini dati), stati e problemi dei prodotti, report su rendimento, competitività dei prezzi e best seller in Merchant Center Query Language, inventario locale e regionale, promozioni e notifiche. Accesso OAuth con Google; le eliminazioni sono disattivate all'installazione.

Prerequisiti

Le istruzioni di setup complete sono incluse nel connettore stesso (visibili nello store quando lo selezioni). Le variabili d'ambiente richieste sono:

GOOGLE_CLIENT_ID, GOOGLE_CLIENT_SECRET, GOOGLE_MERCHANT_ACCOUNT_ID

Step 1 — Ottieni le credenziali

La configurazione richiede una sola volta circa 15 minuti. Ti servono un account Merchant Center, un utente Google con accesso all'account (Admin per la registrazione una tantum del progetto) e un progetto Google Cloud. Il connettore usa la Merchant API v1 (https://merchantapi.googleapis.com), che ha sostituito la Content API for Shopping v2.1: Google l'ha dismessa il 18 agosto 2026, dal 1° settembre 2026 le sue chiamate falliscono sempre più spesso con HTTP 410 e all'inizio del 2027 verrà spenta del tutto.

1. Apri https://console.cloud.google.com, scegli o crea un progetto, poi APIs & Services, Library, e attiva Merchant API.
2. In APIs & Services, OAuth consent screen scegli Internal su Google Workspace, altrimenti External con stato di pubblicazione In production. Finché un'app è in Testing, Google revoca i suoi refresh token dopo 7 giorni e il connettore smette di funzionare ogni settimana.
3. In Credentials, Create credentials, OAuth client ID scegli il tipo Web application e aggiungi come redirect URI autorizzato <your AnythingMCP URL>/api/mcp-oauth/callback, su AnythingMCP Cloud https://cloud.anythingmcp.com/api/mcp-oauth/callback.
4. Incolla il client ID in GOOGLE_CLIENT_ID e il client secret in GOOGLE_CLIENT_SECRET. In GOOGLE_MERCHANT_ACCOUNT_ID va l'id dell'account Merchant Center: il numero in alto in Merchant Center accanto al nome del negozio, oppure quello dopo a= nell'indirizzo (merchants.google.com/mc/overview?a=123456789). Su un account avanzato (multi-cliente) usa l'id dell'account avanzato per gestire l'account stesso, oppure l'id di un sub-account per quel negozio.
5. Nella pagina del connettore clicca Authorize with Provider e accedi con un account Google che sia utente dell'account Merchant Center: Admin per la configurazione e le scritture, Standard per prodotti e feed, Read only per le letture (Performance reporting copre solo i report sul rendimento).
6. Registra il progetto Cloud una volta sola: esegui google_merchant_center_register_gcp_project, se vuoi con developer_email. Quell'account Google diventa il contatto tecnico e riceve il ruolo di sviluppatore API; se non è ancora utente dell'account, riceve un invito da accettare entro 14 giorni. Finché il progetto non è registrato, ogni altra chiamata risponde 401 GCP project with id ... is not registered with the merchant account. Serve un utente Admin, e la registrazione si fa sull'account principale (avanzato o autonomo), non su ogni sub-account. google_merchant_center_get_developer_registration mostra i numeri di progetto registrati.
7. Esegui google_merchant_center_get_account per verificare la connessione.

Lo stesso progetto Cloud e lo stesso client OAuth possono servire tutti i connettori Google (Gmail, Google Calendar, Google Drive, Google Sheets, Search Console, Analytics, Ads, Merchant Center): attiva ogni API in quel progetto, riusa GOOGLE_CLIENT_ID e GOOGLE_CLIENT_SECRET e autorizza ogni connettore una volta.

Scope e account: il connettore chiede https://www.googleapis.com/auth/content, l'unico scope della Merchant API (lettura e scrittura). Ciò che l'AI può fare è limitato dall'accesso a Merchant Center dell'utente che ha effettuato l'accesso; per un agente di sola lettura accedi con un utente Read only e disattiva tutti i tool di insert, update, create, fetch e register. Un connettore lavora sull'unico account indicato in GOOGLE_MERCHANT_ACCOUNT_ID. google_merchant_center_list_accounts elenca tutti gli account che l'utente può aprire, google_merchant_center_list_subaccounts i sub-account di un account avanzato. Per un altro account installa di nuovo il connettore con quell'id.

Cosa legge: l'account con fuso orario e lingua, i dati aziendali (indirizzo, telefono, assistenza clienti), la home page e se è verificata e rivendicata, i problemi dell'account con la loro gravità, i programmi (schede senza costi, annunci Shopping, schede locali, checkout) con la loro idoneità, le impostazioni di spedizione, le regioni, gli utenti con i loro diritti di accesso e le quote API. I prodotti elaborati, uniti da tutte le origini dati, con i loro attributi e productStatus per destinazione e paese, compresi i problemi a livello di articolo; i conteggi degli stati per contesto di report e paese con i problemi più frequenti. Le origini dati (feed) e l'esito dell'ultimo caricamento di file. L'inventario locale e regionale per prodotto, le promozioni con il loro stato di approvazione e le sottoscrizioni alle notifiche. Report in Merchant Center Query Language: rendimento dei prodotti (clic, impressioni, CTR, conversioni), stato e problemi per prodotto, competitività dei prezzi e suggerimenti di prezzo (suggested_price), best seller e visibilità rispetto alla concorrenza.

Cosa scrive: input di prodotto in un'origine dati di tipo API (google_merchant_center_insert_product_input ne crea uno o lo sostituisce per intero, google_merchant_center_update_product_input cambia i campi elencati in update_mask, ad esempio product_attributes.price,product_attributes.availability), origini dati (crea, modifica, recupera subito un feed di file), inventario locale e regionale per negozio o regione (un insert sostituisce quella voce), promozioni in un'origine dati di promozioni e sottoscrizioni alle notifiche che inviano a un callback HTTPS su PRODUCT_STATUS_CHANGE o ACCOUNT_SERVICE_CHANGE. I prodotti dei feed di file o aggiunti dall'interfaccia di Merchant Center non si possono modificare qui; sovrascrivi i loro attributi con un'origine dati API supplementare. Le modifiche compaiono in google_merchant_center_get_product dopo qualche minuto, l'approvazione per annunci e schede senza costi può richiedere qualche giorno, e Google esamina ogni promozione (il programma Promozioni deve essere attivo per il paese).

Disattivati all'installazione: google_merchant_center_delete_product_input, google_merchant_center_delete_local_inventory, google_merchant_center_delete_regional_inventory e google_merchant_center_delete_notification_subscription. Non si possono annullare (un prodotto eliminato perde storico e stato), quindi un admin li attiva quando servono al team.

Formati dei dati: l'id di un prodotto è contentLanguage~feedLabel~offerId, ad esempio en~US~sku123; gli offer id che contengono /, % o ~ si passano come codifica base64url senza padding dell'intero id. I nomi delle risorse sono percorsi come accounts/123/dataSources/456 e i tool prendono come id l'ultima parte. Gli importi sono in micros: {"amountMicros": "19990000", "currencyCode": "EUR"} vale 19,99 EUR. I numeri grandi (micros, quantità, id) arrivano come stringhe JSON. Gli orari sono RFC 3339 in UTC; i valori date dei report sono nel fuso orario dell'account. I nomi degli attributi sono in camelCase (title, link, imageLink, availability, condition, gtins, brand, mpn, googleProductCategory, salePrice, shipping).

Report: google_merchant_center_search_reports accetta SELECT fields FROM table WHERE ... ORDER BY ... LIMIT n con nomi dei campi in snake_case. Le condizioni si combinano solo con AND (al posto di OR usa IN) e ORDER BY funziona solo sui campi selezionati. product_performance_view e non_product_performance_view richiedono una condizione sulla data come date DURING LAST_30_DAYS e almeno una metrica. Le tabelle dei best seller richiedono report_granularity e report_country_code nel filtro. Le righe arrivano come results[], ognuna con un oggetto che porta il nome della tabella, ad esempio productPerformanceView.

Paginazione e limiti: i tool di elenco restituiscono nextPageToken; l'AI richiama con page_token finché non manca. google_merchant_center_list_products restituisce di default 25 prodotti per pagina, al massimo 1000; i report fino a 100000 righe per pagina (default 1000). google_merchant_center_list_quotas mostra i limiti giornalieri e al minuto e l'uso di oggi per gruppo di metodi. Le scritture di prodotti sono limitate al giorno in proporzione alla dimensione del catalogo: distribuisci le modifiche in blocco e preferisci un feed supplementare a migliaia di aggiornamenti singoli.

Errori comuni: 401 GCP project with id ... is not registered significa che manca il passo 6; ogni altro 401 significa che l'autorizzazione è scaduta o è stata revocata (sempre dopo 7 giorni finché la schermata di consenso è in Testing): clicca di nuovo Authorize with Provider. 403 The caller does not have access to the accounts significa che l'utente non è utente di quell'account oppure GOOGLE_MERCHANT_ACCOUNT_ID è sbagliato; 403 Merchant API has not been used in project significa che l'API non è attiva (passo 1). 400 su un input di prodotto significa che manca un attributo obbligatorio o è scritto male, oppure che l'origine dati non è di tipo API. 404 è un id di prodotto, origine dati o promozione sconosciuto. 429 RESOURCE_EXHAUSTED significa quota esaurita: controlla google_merchant_center_list_quotas e riprova più tardi.

Il connettore non gestisce ordini e resi, non modifica le norme di spedizione o di reso, non crea account né gestisce utenti, non legge le recensioni dei prodotti e non gestisce le campagne Google Ads (per quelle c'è il connettore Google Ads).

Step 2 — Installa l'adapter

curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d

Step 3 — Aggiungi il connettore in ChatGPT

L'URL del tuo server: in AnythingMCP apri MCP Servers → il server su cui si trova questo connettore e copia il suo URL (https://cloud.anythingmcp.com/mcp/…). Usalo ovunque questa guida mostra YOUR_SERVER_ID.

ChatGPT aggiunge i server MCP come plugin dalla pagina Plugins, sul web e nei piani a pagamento. La modalità sviluppatore non serve più. In un workspace Business possono farlo solo admin e owner; in Enterprise ed Edu un amministratore può concedere il permesso Create plugins with MCPs.

1. Vai su chatgpt.com/plugins, clicca Add e poi Add custom MCP server.
2. Inserisci un nome, ad esempio Name: Google Merchant Center.
3. In Connection inserisci come Server URL https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID e lascia Authentication su OAuth.
4. Seleziona I understand and want to continue, poi Create as a plugin. Quando ChatGPT lo chiede, accedi ad AnythingMCP e consenti l'accesso.
5. Installa il nuovo plugin dai tuoi plugin personali, poi digita @ in una chat e selezionalo.

Tool disponibili

Esempi di prompt

• "Fai un controllo di salute del negozio: problemi dell'account e quanti prodotti sono non approvati per paese."
• "Quali prodotti non sono idonei o sono non approvati, e cosa devo correggere per ciascuno?"
• "Mostrami i 20 prodotti con più clic negli ultimi 30 giorni, con impressioni e CTR."
• "Dove il mio prezzo è sopra il prezzo di riferimento? Elenca i prodotti con lo scarto maggiore."
• "Imposta il prodotto enUSsku123 su OUT_OF_STOCK. Mostrami la modifica prima di inviarla."

FAQ

Il piano free di ChatGPT funziona con i server MCP personalizzati? OpenAI documenta i server MCP personalizzati solo per i piani a pagamento; il piano Free non è nell'elenco.

Prossimi passi

• Landing del connettore
• Collegare a Claude
• Collegare a Cursor
• Collegare a Gemini
• Collegare a Meta Muse
• Collegare a Microsoft Copilot