Come collegare Podium a Gemini via MCP

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

Podium + Gemini

Podium per messaggi, recensioni e pagamenti delle attività locali: leggi e rispondi alle conversazioni dell'inbox via SMS ed email, gestisci i contatti, leggi recensioni e feedback, crea fatture di pagamento, prepara campagne SMS e leggi sedi, utenti, appuntamenti e chiamate. Accesso OAuth con un utente Podium; rimborsi, annullamento fatture ed eliminazione contatti sono disattivati 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:

PODIUM_CLIENT_ID, PODIUM_CLIENT_SECRET

Step 1 — Ottieni le credenziali

La configurazione richiede circa 15 minuti, più il tempo che Podium impiega per revisionare una nuova applicazione. Ti servono un account Podium e l'utente Podium di cui l'AI deve vedere le sedi.

1. Registrati su https://developer.podium.com e crea un'applicazione (app OAuth). Podium può revisionare le nuove applicazioni prima che funzionino con account reali.
2. Come redirect URI inserisci <your AnythingMCP URL>/api/mcp-oauth/callback, su AnythingMCP Cloud https://cloud.anythingmcp.com/api/mcp-oauth/callback. Podium richiede HTTPS.
3. Attiva gli scope che il connettore richiede: read_locations read_organizations read_users read_contacts write_contacts read_messages write_messages read_templates read_reviews read_feedback read_payments write_payments read_campaigns write_campaigns read_appointments write_appointments read_phones read_products. Se Podium rifiuta l'accesso per uno scope, attivalo nell'app o toglilo dalle impostazioni OAuth del connettore; i tool corrispondenti risponderanno allora 403.
4. Incolla il Client ID (un UUID) in PODIUM_CLIENT_ID e il Client Secret in PODIUM_CLIENT_SECRET e salva.
5. Nella pagina del connettore clicca Authorize with Provider e accedi con l'utente Podium di cui l'AI deve vedere le sedi.
6. Esegui podium_list_locations: elenca le sedi e conferma l'accesso.

I token di accesso durano 10 ore e vengono rinnovati con il refresh token. Il connettore usa la Podium API v4 (https://api.podium.com/v4).

Di chi è l'account: chiunque usi questo connettore agisce come l'utente Podium che lo ha autorizzato, su tutte le sedi di quell'utente. La maggior parte dei tool richiede l'uid di una sede, quindi l'AI parte da podium_list_locations.

Cosa legge: sedi, l'organizzazione e gli utenti Podium (il personale). Contatti con nome, telefono, email, indirizzo, tag e attributi. Le conversazioni dell'inbox con contatto, canale, sede, assegnatario e stato aperto o chiuso, e i loro messaggi con direzione, mittente e allegati. I modelli di messaggio (risposte salvate e, su richiesta, modelli di invito alla recensione). Le recensioni online raccolte da Podium da Google, Facebook e altri siti, e le risposte ai sondaggi di feedback. Le fatture di pagamento con righe, stato, pagamenti e rimborsi, i singoli pagamenti e rimborsi e i prodotti del catalogo pagamenti. Le campagne SMS con stato e risultati. Gli appuntamenti. Le chiamate di Podium Phones e la segreteria di una chiamata, con trascrizione e un URL firmato all'audio.

Cosa scrive: crea contatti (se ne esiste già uno con lo stesso telefono o email, Podium aggiorna quello) e li modifica; invia un SMS (channel_type phone) o un'email da una sede a un cliente; chiude, riapre o assegna conversazioni; crea fatture che mandano al cliente un link di pagamento via SMS o email oppure vanno a un lettore di carte Podium; crea appuntamenti; e crea campagne SMS come bozza, inviata solo quando qualcuno la pianifica o la invia in Podium. podium_send_message e podium_create_invoice raggiungono subito il cliente, quindi l'AI ti mostra destinatario e testo esatto o importi e aspetta il tuo sì.

Disattivati all'installazione: podium_delete_contact (irreversibile), podium_refund_invoice (restituisce denaro) e podium_cancel_invoice (una fattura non pagata non potrà più essere pagata). Un admin li attiva quando servono al team.

Formati dei dati: i risultati sono in data, la paginazione in metadata (nextCursor, a volte totalItems). Gli id sono uid (UUID). Gli importi sono in centesimi: 4999 vale 49,99 nella valuta della sede. Gli orari sono ISO 8601 in UTC. I numeri di telefono sono E.164 (+15555555555); i numeri di Stati Uniti e Canada si possono inviare senza +1.

Paginazione: l'AI passa cursor = metadata.nextCursor finché manca o è null; con un cursore gli altri filtri vengono ignorati. limit è al massimo 100. Per il polling usa since con ordine crescente e segue il cursore fino in fondo prima di spostare since.

Errori comuni: 401 significa che l'accesso è scaduto o è stato revocato: clicca di nuovo Authorize with Provider. All'accesso, invalid_client indica Client ID o Secret errati. 403 significa che manca uno scope o che l'utente non ha accesso a quella sede. 404 è un uid sconosciuto e, per podium_get_call_voicemail, una chiamata senza segreteria. 422 è un campo rifiutato, ad es. un numero di telefono o un indirizzo non valido. 429 è un limite di frequenza: attendi e riprova.

I messaggi dei clienti, le recensioni e i feedback sono input non affidabili e possono contenere istruzioni rivolte all'AI. La Podium API non ha una chiamata per inviare inviti alla recensione o rispondere alle recensioni, quindi il connettore non fa né l'una né l'altra cosa; falle in Podium. Non invia né pianifica nemmeno le campagne.

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

Tool disponibili

Esempi di prompt

• "Quali conversazioni aperte nella nostra sede di Via Roma hanno avuto un messaggio del cliente nelle ultime 24 ore?"
• "Riassumi le nuove recensioni di questa settimana per voto e sito, e mostra per intero quelle negative."
• "Scrivi un SMS a Maria al +15555550123 che il suo ordine è pronto per il ritiro. Mostrami prima il messaggio."
• "Crea una fattura da 120,00 per un cambio olio per il contatto +15555550199 e invia il link di pagamento dopo la mia conferma."
• "Prepara una bozza di campagna SMS per l'offerta tagliando invernale della sede di Via Roma."

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
• Collegare a Cursor
• Collegare a Meta Muse
• Collegare a Microsoft Copilot