Come collegare Fudo a Gemini — via MCP

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

Fudo + Gemini

Fudo, punto cassa per ristoranti: vendite e scontrini con articoli e pagamenti, pagamenti e metodi di pagamento, clienti, prodotti e categorie del menu, spese e fornitori, tavoli, sale, cucine, ingredienti e personale. Fudo API v1alpha1 con API key e secret; le scritture sono incluse ma installate disattivate.

Prerequisiti

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

FUDO_API_KEY, FUDO_API_SECRET

Step 1 — Ottieni le credenziali

Il connettore legge la Fudo API v1alpha1 con una API key e un secret rilasciati dal supporto di Fudo.

1. Scrivi a [email protected] indicando il nome del tuo account Fudo e l'utente che deve ricevere l'accesso API. Fudo consiglia un utente dedicato come api@mirestaurante; l'API può fare ciò che il ruolo di quell'utente consente.
2. Inserisci l'apiKey in FUDO_API_KEY e l'apiSecret in FUDO_API_SECRET. Il connettore li scambia su https://auth.fu.do/api con un token valido 24 ore e lo rinnova prima della scadenza.
3. Parti da fudo_list_payment_methods: verifica le credenziali e restituisce gli id dei metodi di pagamento.

Da sapere:

• Vendite di un giorno: fudo_list_sales con created_at = and(gte.2026-10-06T00:00:00Z,lte.2026-10-06T23:59:59Z) e sale_state = in.(CLOSED). Gli orari sono ISO 8601 in UTC con Z.
• I filtri usano le espressioni con operatore di Fudo (eq., gte., in.(a,b), ilike.%text%). Una forma che Fudo non accetta per una colonna risponde 400 o 422.
• page_size vale 250 di default (massimo 500) e non c'è un totale: richiedi pagine finché una non ha meno elementi di page_size.
• Creazione e modifica di clienti, spese e prodotti sono installate disattivate; attiva quei tool consapevolmente. Il rate limiting risponde 429.

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

Tool disponibili

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
• Collega a Claude
• Collega a ChatGPT
• Collega a Cursor
• Collega a Meta Muse