Come collegare Pancake a Gemini via MCP

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

Pancake + Gemini

Gestisci la inbox di social commerce di Pancake dalla tua AI: elenca e leggi le conversazioni Facebook, Instagram, Zalo, WhatsApp e TikTok di una pagina, aggiungi tag e assegnale, segnale come lette, cerca i clienti, aggiungi note, elenca post e staff e leggi le statistiche di pagina, staff e tag. Le risposte 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:

PANCAKE_PAGE_ID, PANCAKE_PAGE_ACCESS_TOKEN

Step 1 — Ottieni le credenziali

La configurazione richiede circa 2 minuti. Ti serve un account Pancake con accesso alla pagina che vuoi collegare: il connettore usa l'id della pagina e il Page Access Token di quella pagina.

1. Accedi su https://pages.fm e apri la pagina che vuoi collegare.
2. Vai su Settings → Tools (in vietnamita Cài đặt → Công cụ) e copia il Page Access Token in PANCAKE_PAGE_ACCESS_TOKEN. Incolla solo il token, senza page_access_token= davanti.
3. Inserisci l'id della pagina in PANCAKE_PAGE_ID: la parte dopo pages.fm/ nell'indirizzo della pagina, per esempio 256469571178082. Le pagine di altri canali mantengono il prefisso, per esempio waba_102952029333366.
4. Installa il connettore ed esegui pancake_list_tags: elenca i tag della pagina e conferma che token e id della pagina vanno insieme.

Un'installazione per pagina: Pancake riunisce in una sola inbox i canali Facebook, Instagram, Zalo, WhatsApp, TikTok e altri di una pagina, ma ogni pagina collegata in Pancake ha il suo id e il suo token. Per lavorare con più pagine installa il connettore una volta per pagina. Il token resta valido finché non lo rigeneri in Pancake e viaggia come parametro di query page_access_token, l'unico modo che Pancake accetta, e solo verso pages.fm.

Cosa legge: le conversazioni della pagina, 60 alla volta, dalle più recenti: messaggi privati, commenti sotto i post e commenti alle dirette, con anteprima, stato di lettura, cliente, tag, staff assegnato e numeri di telefono. Poi i messaggi di una conversazione, 30 alla volta, con gli allegati; i tag della pagina; lo staff con lo stato online; i clienti con nome, genere, compleanno, numeri di telefono, email e note; i post con numero di commenti, like e numeri di telefono raccolti; e le statistiche della pagina (per ora), dello staff e dei tag.

Sempre con un intervallo di tempo: clienti, post, statistiche della pagina e dei tag si leggono per un intervallo con inizio e fine (since e until), e diversi endpoint accettano al massimo circa un mese alla volta. Chiedi questa settimana o settembre e l'AI calcola l'intervallo. Le statistiche dello staff usano un intervallo di date nel fuso orario della pagina (UTC+7 per una pagina in Vietnam); gli orari nelle risposte sono in UTC.

Chiede prima di modificare un cliente: prima di pancake_update_customer (nome, genere, compleanno o numeri di telefono; un nuovo elenco di numeri sostituisce quello vecchio) l'AI ti mostra cosa cambia e aspetta il tuo sì. pancake_tag_conversation, pancake_assign_conversation, pancake_mark_conversation_read, pancake_mark_conversation_unread e pancake_add_customer_note modificano solo la inbox condivisa: il cliente non vede tag, assegnazioni, stato di lettura o note, e l'AI li usa quando glielo chiedi.

Disattivati all'installazione: pancake_send_message, pancake_reply_comment e pancake_send_private_reply. Scrivono al cliente: un messaggio nella inbox, una risposta pubblica sotto un commento che legge chiunque veda il post, oppure un messaggio privato su Messenger all'autore di un commento, fino a 7 giorni dopo il commento. Un amministratore li attiva consapevolmente, e anche allora l'AI ti mostra il testo esatto e aspetta il tuo sì. Valgono le regole dei canali: Facebook e Instagram consentono risposte libere solo entro 24 ore dall'ultimo messaggio del cliente.

Limiti: Pancake consente 5 richieste al secondo per pagina. Un 429 significa rallentare e riprovare dopo un momento.

Errori comuni: Pancake risponde alla maggior parte degli errori con HTTP 200 e success false; il connettore li trasforma in errori. Invalid access_token (errore 102) significa che il token è sbagliato, è stato rigenerato o appartiene a una pagina diversa da PANCAKE_PAGE_ID. 403 significa che il tuo ruolo sulla pagina non consente l'azione; per le statistiche serve un ruolo che possa vedere i report.

Il connettore non elenca le tue pagine e non genera token di pagina, non carica media e non invia immagini, non invia modelli WhatsApp, non modifica né elimina note, non cambia le impostazioni round-robin e non lavora con annunci, registri chiamate, esportazioni di dati, chat plugin, webhook o Pancake POS (ordini, prodotti e magazzino).

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 Pancake.

Tool disponibili

Esempi di prompt

• "Mostrami le conversazioni non lette di oggi nella inbox e riassumi cosa chiedono i clienti."
• "Metti il tag Spedizione a tutte le conversazioni di stamattina che chiedono dei costi di spedizione e assegnale a Giulia."
• "Chi dello staff ha gestito più conversazioni la settimana scorsa, e com'è andato il team nel complesso?"
• "Aggiungi una nota alla cliente Sara Bianchi: vuole la taglia M, paga in contrassegno. Poi cambia il suo numero in 333 123 4567, ma prima fammi vedere la modifica."
• "Quanti nuovi clienti e numeri di telefono ha raccolto la pagina ogni giorno questa settimana, e quale post ha avuto più commenti?"

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