Come collegare Untappd a Gemini — via MCP

Solo self-hosted. Untappd rifiuta le richieste provenienti da indirizzi IP di data center e AnythingMCP Cloud gira in un data center, quindi questo connettore non è disponibile su AnythingMCP Cloud. Funziona su un'istanza di AnythingMCP che gestisci tu, su un computer o un server con una normale connessione internet di casa o dell'ufficio.

Untappd + Gemini

Cerca nel database di birre di Untappd da qualsiasi assistente AI. Trova birre per nome, birrificio o stile; leggi i dettagli della birra con valutazioni; cerca locali e check-in. 4 strumenti, richiede client_id + client_secret gratuiti dell'API Untappd.

Prerequisiti

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

UNTAPPD_CLIENT_ID, UNTAPPD_CLIENT_SECRET

Step 1 — Ottieni le credenziali

This connector wraps Untappd's REST API (api.untappd.com/v4).

Setup: Untappd requires a free API client_id + client_secret. Apply for them at https://untappd.com/api/register. Approval is usually fast.

Provide:

• UNTAPPD_CLIENT_ID — your app's client ID
• UNTAPPD_CLIENT_SECRET — your app's client secret

What's exposed: public, unauthenticated endpoints (no user OAuth needed for basic search + lookup). For per-user data (your check-ins, your wishlist), you'd need OAuth — not included in this connector.

Rate limits: Untappd publishes 100 req/hour per client. The connector does not auto-retry on 429; respect the limit.

…(continued in the in-app connector instructions)

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

1. Apri http://localhost:3000 e registrati. Il primo account diventa amministratore.
2. Apri lo store dei connettori (http://localhost:3000/connectors/store), scegli Untappd, inserisci le credenziali richieste (alcuni connettori non ne hanno bisogno) e installalo.
3. In MCP Servers crea un server e assegnagli il connettore Untappd. Nella pagina del server copia l'MCP endpoint (http://localhost:4000/mcp/<server-id>) e genera una chiave in API keys.

Il quickstart ascolta solo su localhost. Per un'istanza raggiungibile da altre persone o da client AI nel cloud, clona il repository ed esegui ./setup.sh, che configura dominio, HTTPS e OAuth (guida al deployment).

Step 3 — Aggiungi il connettore in Gemini

Gemini CLI gira sul tuo computer, quindi può usare l'endpoint locale:

gemini mcp add --transport http untappd http://localhost:4000/mcp/<server-id> -H "X-API-Key: <your-api-key>"

Il server viene salvato in .gemini/settings.json del progetto corrente; aggiungi -s user per salvarlo in ~/.gemini/settings.json per tutti i progetti. Avvia gemini ed esegui /mcp per vedere i tool di Untappd.

Tool disponibili

FAQ

Gemini 1.5 Pro o 2.x supportano MCP? Sì — Gemini CLI ≥ 0.4 e la Vertex AI tools API accettano connettori MCP httpUrl con header personalizzati.

Perché Untappd non è disponibile su AnythingMCP Cloud? Untappd rifiuta le richieste da indirizzi IP di data center. AnythingMCP Cloud gira in un data center, quindi ogni chiamata fallirebbe. Con un'istanza di AnythingMCP su una connessione di casa o dell'ufficio di solito funziona.

Prossimi passi

• Pagina del connettore
• Collega a Claude
• Collega a ChatGPT
• Collega a Cursor
• Collega a Meta Muse