Come collegare Meta Catalog a Gemini via MCP

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

Meta Catalog + Gemini

Fai controllare e gestire alla tua AI i cataloghi prodotti Meta (Commerce Manager): prodotti con prezzi, disponibilità e stato di revisione, set di prodotti, feed di dati ed errori di caricamento, e la diagnostica del catalogo. Dopo la tua conferma può anche aggiornare, aggiungere o eliminare prodotti in blocco (disattivato 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:

META_CATALOG_ACCESS_TOKEN, META_CATALOG_BUSINESS_ID

Step 1 — Ottieni le credenziali

La configurazione richiede circa 10 minuti. Ti servono un portfolio business di Meta con un catalogo prodotti in Commerce Manager e un'app Meta.

1. Apri developers.facebook.com/apps/creation e crea un'app business collegata al tuo portfolio business. Se usi già il connettore Meta Ads, puoi riutilizzare la sua app.
2. Consigliato, un token che non scade: in Business Settings apri Users → System users e aggiungi un utente di sistema. In Assign assets → Catalogs assegnagli il tuo catalogo (Manage catalog, oppure View catalog se l'AI deve solo leggere). Clicca su Generate token, scegli l'app, imposta la scadenza su Never e spunta catalog_management e business_management. Meta può chiederti prima di verificare il portfolio business.
3. Incolla il token in META_CATALOG_ACCESS_TOKEN. Inizia con EA; incollalo senza la parola Bearer.
4. Inserisci l'id del portfolio business in META_CATALOG_BUSINESS_ID: solo cifre, da Business Settings → Business info oppure da business_id= nella barra degli indirizzi di business.facebook.com. Con un token di utente di sistema meta_catalog_list_businesses restituisce un elenco vuoto, quindi prendi l'id da Business Settings.
5. Installa il connettore ed esegui meta_catalog_check_permissions: entrambi i permessi devono risultare granted. Poi meta_catalog_list_catalogs elenca i tuoi cataloghi con il numero di prodotti.

Con un token utente: un token utente dal Graph API Explorer (la tua app, User Token, gli stessi due permessi) dura solo un'ora o due. Compila anche i campi facoltativi META_APP_ID e META_APP_SECRET (nella tua app in App settings → Basic): AnythingMCP scambia così il token con uno a lunga durata di circa 60 giorni alla prima chiamata e lo rinnova quando mancano meno di 10 giorni, come nel connettore Meta Ads. Senza questi valori estendi tu il token nell'Access Token Debugger (Extend Access Token) e lo sostituisci prima che passino i 60 giorni; la pagina del connettore ti avvisa in anticipo. Con un token di utente di sistema lasciali vuoti.

Cosa legge: i cataloghi della tua azienda e quelli che i clienti hanno condiviso con lei (come li vede un'agenzia o un partner, con i tuoi ruoli su ciascuno); i prodotti con SKU (retailer_id), nome, prezzo e prezzo scontato, disponibilità, giacenza, stato di revisione (approved, pending, rejected, outdated), visibilità, errori e motivi di rifiuto; i set di prodotti con la regola di filtro e i loro prodotti; i feed di dati con la pianificazione, le sessioni di caricamento (articoli rilevati, salvati, non validi ed eliminati) e gli errori di caricamento con numero di riga e SKU; e la diagnostica che mostra Commerce Manager, segnata come MUST_FIX o OPPORTUNITY.

Capire perché i prodotti non compaiono: l'AI parte da meta_catalog_get_diagnostics, poi elenca i prodotti con errori o con un certo stato di revisione e legge con meta_catalog_get_product gli errori e i motivi di rifiuto esatti di un prodotto. Per i problemi dei feed passa da meta_catalog_list_feeds a meta_catalog_list_feed_uploads e poi a meta_catalog_list_upload_errors.

Due id per prodotto: Meta assegna a ogni prodotto un suo id, mentre il tuo SKU è il retailer_id (la colonna id di un feed). L'AI usa l'id Meta per i singoli prodotti e lo SKU nelle modifiche in blocco e nei filtri. I prezzi tornano come testo con la valuta, per esempio 19.99 EUR.

Le modifiche arrivano nelle inserzioni e negli shop: i cataloghi alimentano le inserzioni Advantage+ per cataloghi, gli Shop di Facebook e Instagram e il tagging dei prodotti, quindi una modifica al catalogo si vede lì. Un prodotto fornito da un feed pianificato viene sovrascritto al caricamento successivo del feed: per una modifica duratura correggi la sorgente del feed o usa un feed supplementare.

Disattivati all'installazione: meta_catalog_batch_update_items, meta_catalog_create_product, meta_catalog_update_product e meta_catalog_delete_product. Cambiano ciò che i clienti vedono nelle inserzioni e negli shop, e un prodotto eliminato non si può ripristinare, solo aggiungere di nuovo. Un amministratore può attivarli uno per uno se l'AI deve modificare il catalogo.

Chiede prima di ogni modifica: una volta attivati, l'AI indica il catalogo, i prodotti (nome e SKU) e i valori vecchi e nuovi, e aspetta il tuo sì. Un batch accetta fino a 5.000 modifiche (se ne consigliano meno di 3.000) e viene elaborato in background: l'AI lo segue con meta_catalog_check_batch_status finché non è finito e ti riporta gli errori.

Limiti: Meta limita le chiamate API. I codici di errore 4, 17, 613, 80009 e 80014 (il limite dei batch) significano aspettare qualche minuto prima di riprovare.

Errori comuni: il codice 190 indica che il token non è valido o è scaduto; creane uno nuovo. Con il subcode 467, 460 o 458 (disconnesso, password cambiata, app rimossa) la sessione è chiusa per sempre e il connettore smette di inviare il token finché non ne salvi uno nuovo. I codici 10 e da 200 a 299 indicano che manca un permesso o che l'utente di sistema non ha accesso a quel catalogo: assegna il catalogo e genera di nuovo il token. Il codice 100 indica che un parametro, un campo o un filtro è sbagliato.

Il connettore non crea né elimina cataloghi, feed o set di prodotti, non cambia la pianificazione dei feed né carica file di feed, non gestisce cataloghi localizzati, pixel o sorgenti di eventi, non gestisce le inserzioni per cataloghi (se ne occupa il connettore Meta Ads) e non tagga prodotti nei post di Instagram.

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 Gemini

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.

Gemini CLI legge i server MCP da ~/.gemini/settings.json (su Windows %USERPROFILE%\.gemini\settings.json). Aggiungi:

{
  "mcpServers": {
    "anythingmcp": {
      "httpUrl": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
      "headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
    }
  }
}

1. Crea una chiave API MCP in AnythingMCP da MCP Servers → il tuo server → API keys e incollala al posto di YOUR_MCP_API_KEY.
2. Salva il file e riavvia gemini.
3. Esegui /mcp in Gemini CLI (oppure gemini mcp list dal terminale): anythingmcp dovrebbe risultare connesso.
4. Inizia a scrivere prompt: Gemini CLI ora può chiamare i tool di Meta Catalog.

Tool disponibili

Esempi di prompt

• "Perché i prodotti del nostro catalogo principale vengono rifiutati o non compaiono? Dammi i problemi MUST_FIX e quanti articoli tocca ciascuno."
• "L'ultimo caricamento del nostro feed prodotti è andato a buon fine? Mostrami gli errori con numero di riga e SKU."
• "Quali prodotti del set Saldi estivi sono esauriti in questo momento?"
• "Porta lo SKU TSHIRT-ROSSA-M a 24,90 EUR e disponibile. Mostrami i valori vecchi e nuovi prima di cambiare qualcosa."
• "Elenca i cataloghi che i nostri clienti hanno condiviso con noi e quanti prodotti ha ciascuno."

FAQ

Dove cerca i server MCP Gemini CLI? In ~/.gemini/settings.json per il tuo utente, oppure in .gemini/settings.json dentro un progetto. gemini mcp list mostra ogni server e se si connette.

Prossimi passi

• Landing del connettore
• Collegare a Claude
• Collegare a ChatGPT