Come collegare Flour a Gemini via MCP

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

Flour + Gemini

Cassa cloud e gestionale di magazzino Flour (Germania), in sola lettura: articoli con prezzi e giacenze per magazzino, movimenti di magazzino, scontrini, fatture e altri documenti, articoli venduti per periodo e cassa, partner commerciali, giornali di cassa, inventari, filiali e punti vendita.

Prerequisiti

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

FLOUR_API_TOKEN

Step 1 — Ottieni le credenziali

La configurazione richiede circa 2 minuti, una volta che hai il token. Ti servono un account Flour e un token della REST API v3, che Flour rilascia su richiesta.

1. Scrivi a [email protected] dall'indirizzo email del titolare dell'account e chiedi un token REST API v3 per il tuo account Flour.
2. Incolla solo il token in FLOUR_API_TOKEN, senza la parola Bearer, spazi o virgolette. Il connettore lo invia nell'header Authorization.
3. Installa il connettore ed esegui flour_list_stocks: elenca i tuoi magazzini (magazzino, area vendita, stock online) con i loro id e mostra che il token funziona.

Cosa legge: i tuoi magazzini, filiali e punti vendita (casse); gli articoli con codice articolo, EAN, produttore, prezzi di vendita per listino, prezzi di acquisto, scorte minime, varianti e componenti dei kit; la giacenza di ogni articolo per magazzino, fisica (contata) e calcolata (dopo gli ordini aperti), e i suoi movimenti (entrate merce, vendite, rettifiche, trasferimenti); i documenti di vendita e di acquisto (scontrini e fatture, preventivi, ordini, documenti di trasporto, note di credito, fatture passive, ordini a fornitore) con righe, riepilogo IVA e stato del pagamento; gli articoli venduti in un periodo con quantità e ricavo netto, anche per cassa; clienti e fornitori; i giornali di cassa con fondo iniziale e finale e prelievi; gli inventari con le righe contate; e le statistiche salvate nel tuo account.

Prima i dati di base: i filtri lavorano con gli id. L'AI legge prima magazzini e casse, poi chiede gli scontrini di una cassa o la giacenza di un magazzino. Per i più venduti usa flour_get_sold_articles, che toglie già le note di credito; per singoli scontrini e fatture usa flour_list_documents e flour_get_document. flour_find_article trova un articolo dal codice articolo o dall'EAN del codice a barre.

Date e importi: Flour vuole le date in UTC. Una giornata lavorativa tedesca inizia in UTC la sera prima (alle 22:00 d'estate, alle 23:00 d'inverno), e l'AI fa la conversione per te. Gli importi sono nella valuta del documento, di solito euro: totalExVat è il netto, totalIncVat il lordo.

Periodi brevi sulle casse molto attive: gli elenchi arrivano pagina per pagina, senza un totale. Un anno di scontrini può valere decine di migliaia di documenti, e le risposte oltre 400 KB vengono tagliate, quindi l'AI chiede un giorno o una settimana alla volta.

Sola lettura: tutti i 17 strumenti leggono soltanto. Nel tuo account Flour non cambia nulla, quindi non c'è niente da confermare e nessuno strumento è disattivato all'installazione.

Le credenziali restano in Flour: impostazioni dei terminali di pagamento, dati fiscali della TSE e coordinate bancarie salvati in Flour vengono rimossi dalle risposte e non arrivano mai all'AI.

Limiti: Flour consente circa 60 richieste al minuto per token. Dopo un 429 l'AI aspetta un minuto prima di riprovare.

Errori comuni: 401 significa che il token è sbagliato o è stato revocato: chiedine uno nuovo a [email protected]. 429 significa più di circa 60 richieste in un minuto. Una risposta tagliata significa che il periodo era troppo ampio: restringilo.

Il connettore non registra vendite, non crea né modifica articoli, documenti o partner commerciali, non movimenta il magazzino e non chiude le casse: legge soltanto.

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

Tool disponibili

Esempi di prompt

• "Quali articoli abbiamo venduto di più la settimana scorsa su tutte le casse, per quantità e per ricavo netto?"
• "Di quali articoli ci restano 5 pezzi o meno in magazzino, e quando ci è arrivata l'ultima merce?"
• "Mostrami gli scontrini di ieri della cassa del negozio di Bolzano con il totale IVA inclusa."
• "Trova l'articolo con EAN 4006381333931 e mostrami prezzo e giacenza per magazzino."
• "Quanto contante c'era in cassa alla chiusura di sabato, e ci sono stati prelievi?"

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