Come collegare Moss a Gemini via MCP

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

Moss + Gemini

Moss spend management (Germania ed Europa): spese da carte, fatture e rimborsi con righe e ricevute, saldi dei wallet e transazioni bancarie, fornitori, conti di spesa, aliquote IVA e centri di costo. Crea fornitori e voci di dimensione; non può pagare né approvare nulla.

Prerequisiti

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

MOSS_KEY_ID, MOSS_SECRET_KEY

Step 1 — Ottieni le credenziali

La configurazione richiede circa 5 minuti. Ti servono un admin di Moss e l'app mobile di Moss per confermare la nuova chiave.

1. Accedi a Moss come admin e apri Settings, Company Settings, API Keys (mostrato anche come Settings, Platform, API Keys).
2. Clicca Generate API Key e conferma nell'app mobile di Moss.
3. Copia il Key ID (inizia con kid_) in MOSS_KEY_ID e la Secret Key (inizia con sk_) in MOSS_SECRET_KEY. La secret viene mostrata una sola volta; se la perdi, genera una nuova chiave.
4. Installa il connettore ed esegui moss_list_expenses: restituisce le tue ultime spese e conferma la chiave.

Il connettore scambia la chiave con un token di un'ora su /oauth2/token di Moss (client credentials) e lo rinnova da solo. Richiede lo scope write, che include read, perché i tool di creazione e modifica ne hanno bisogno. Se l'AI deve solo leggere, disattiva quei tool.

Cosa legge: le spese (transazioni con carta, fatture e rimborsi) con le loro righe, importi netti, IVA e lordi, conto di spesa e aliquota IVA per riga, stato, stato di esportazione e fornitore; i file allegati alle spese (ricevute, PDF delle fatture), elencati con moss_search_files e consegnati come allegato da moss_download_file; i conti bancari Moss (wallet) con tipo di finanziamento, valuta e stato, il saldo e il saldo disponibile di ciascuno, e le transazioni bancarie in un intervallo di date di registrazione (acquisti e rimborsi con carta, payout, prelievi, ricariche, rimborsi del credito, con data di registrazione e di valuta, controparte e commissioni); i fornitori con coordinate bancarie, partita IVA, termini di pagamento e imputazione predefinita; i conti di spesa con i numeri di conto; le aliquote IVA; i termini di pagamento con le regole di scadenza e sconto; le dimensioni contabili come centri di costo, centri di profitto e progetti con le loro voci; gli utenti con team, responsabile e ruoli; team e reparti.

Filtri: le spese si filtrano per tipo (CARD_TRANSACTION, INVOICE, REIMBURSEMENT), stato (ad es. SUBMITTED, APPROVED, FLAGGED, REJECTED, REVIEWED, VERIFIED, COMPLETED), stato di esportazione (NOT_EXPORTED, READY_FOR_EXPORT, EXPORT_PENDING, EXPORTED, EXPORT_FAILED), data di creazione, data della spesa o ultima modifica, e si ordinano per stato, ora di creazione, importo in valuta aziendale o ora della spesa. Le transazioni bancarie richiedono sempre un intervallo di date di registrazione. I file delle singole righe vengono elencati solo se si passano anche gli id delle righe.

Cosa scrive: moss_create_supplier, moss_create_dimension, moss_update_dimension, moss_create_dimension_item (ad es. un nuovo centro di costo) e moss_update_dimension_item modificano dati anagrafici usati per la contabilizzazione. Sono attivi all'installazione; l'AI ti mostra cosa creerà o modificherà e aspetta il tuo sì, e passa external_user_id (la persona che ha chiesto) perché Moss possa tracciare la modifica. Fornitori e voci di dimensione si possono impostare ACTIVE o DEACTIVATED; l'eliminazione non è prevista. L'aggiornamento di una voce di dimensione richiede sempre nome e stato, quindi l'AI invia i valori attuali per ciò che deve restare. Creare più delle dimensioni predefinite richiede il modulo Moss Multiple Dimensions.

Disattivato all'installazione: moss_update_supplier, perché può sostituire l'IBAN su cui Moss paga le fatture del fornitore. Un amministratore lo attiva consapevolmente, e l'AI mostra poi i valori vecchi e nuovi prima di chiamarlo.

Importi e date: gli importi sono oggetti con una stringa decimale amount e una currency; homeAmount è nella valuta aziendale. Le date sono YYYY-MM-DD, i timestamp ISO 8601 in UTC. Gli id sono UUID.

Limiti: gli elenchi restituiscono fino a 100 elementi per pagina (default 50); l'AI chiede la page successiva finché meta.pagination.hasMore è true. I filtri per id accettano fino a 100 id. Moss consente 180 letture e 20 scritture al minuto per organizzazione.

Errori comuni: 401 significa che la chiave è stata revocata o il token non è stato emesso: controlla MOSS_KEY_ID e MOSS_SECRET_KEY. 402 significa che un modulo Moss non è attivo nel piano, ad es. Multiple Dimensions. 403 significa che al token manca lo scope. 409 significa che il record è gestito da un'integrazione contabile attiva. 422 significa che un id referenziato (conto di spesa, aliquota IVA, termine di pagamento, team) non esiste o è inattivo. 429 significa che il limite di richieste è esaurito: attendi Retry-After.

Il connettore non può pagare, approvare, esportare né eliminare nulla, e non crea spese né carica ricevute: la Moss Public API non offre chiamate per questo.

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

Tool disponibili

Esempi di prompt

• "Elenca le transazioni con carta del mese scorso ancora NOT_EXPORTED, con importo, fornitore e conto di spesa."
• "Qual è adesso il saldo disponibile di ciascuno dei nostri wallet Moss?"
• "Mostrami la ricevuta allegata alla spesa Moss di 249,90 EUR del 14 ottobre."
• "Somma le nostre fatture del terzo trimestre per fornitore e aliquota IVA."
• "Crea il centro di costo 4300 Marketing Events nella nostra dimensione centri di costo. Mostrami prima cosa crei."

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