Come collegare Money Forward Cloud Invoice a Gemini via MCP

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

Money Forward Cloud Invoice + Gemini

Lavora con Money Forward Cloud Invoice (マネーフォワード クラウド請求書) da qualsiasi agente AI: controparti e i loro reparti di fatturazione, articoli, fatture nel formato della fattura qualificata con righe e stato del pagamento, preventivi con stato dell'ordine e conversione in fattura, e la cronologia degli invii. Accesso OAuth tramite il Money Forward App Portal; cancellazioni e spedizione postale a pagamento sono disattivate 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:

MONEY_FORWARD_CLIENT_ID, MONEY_FORWARD_CLIENT_SECRET

Step 1 — Ottieni le credenziali

La configurazione richiede circa 10 minuti. Ti serve un'attività (事業者) su Money Forward Cloud Invoice e un suo utente con il diritto di gestire i collegamenti delle app (アプリ連携権限). Il connettore usa la マネーフォワード クラウド請求書 API v3 (https://invoice.moneyforward.com/api/v3).

1. Accedi con quell'utente all'アプリポータル (App Portal) di Money Forward Cloud su https://app-portal.moneyforward.com e registra una nuova app.
2. Inserisci un nome e la redirect URI <your AnythingMCP URL>/api/mcp-oauth/callback, su AnythingMCP Cloud https://cloud.anythingmcp.com/api/mcp-oauth/callback. Come クライアント認証方式 (autenticazione del client) scegli CLIENT_SECRET_BASIC.
3. Incolla il Client ID in MONEY_FORWARD_CLIENT_ID e il Client Secret in MONEY_FORWARD_CLIENT_SECRET, lascia vuoto MONEY_FORWARD_REFRESH_TOKEN e installa.
4. Nella pagina del connettore fai clic su Authorize with Provider, accedi a Money Forward e scegli l'attività. Il connettore chiede mfc/invoice/data.read mfc/invoice/data.write.
5. Esegui money_forward_invoice_get_office: mostra la tua attività e conferma l'accesso.

Di chi è l'accesso: l'autorizzazione appartiene all'attività, non a un singolo utente. Chiunque usi questo connettore lavora su controparti, fatture e preventivi di quell'attività.

Cosa legge: la tua attività con indirizzo, telefono e numero di registrazione per le fatture qualificate (適格請求書発行事業者登録番号); le controparti (取引先) con codice, kana, nota, scadenza di pagamento predefinita e i loro reparti di fatturazione (請求先部門) con indirizzo, referente, email e CC; gli articoli (品目) con prezzo unitario, unità, quantità e categoria d'imposta; le fatture (請求書) con numero, titolo, date, imponibile, imposta, totale e stato di pagamento, email e posta, e singolarmente con le righe e il dettaglio dell'imposta per aliquota; i preventivi (見積書) con righe, totali e stato dell'ordine; la cronologia degli invii (送付履歴) di fatture e preventivi. Gli elenchi di fatture e preventivi si filtrano per intervallo di date (range_key con from e to) o con una ricerca q. L'elenco delle fatture non include le righe, quindi l'AI apre la singola fattura per vederle.

Cosa scrive: crea e modifica controparti (con fino a 10 reparti alla creazione), i loro reparti e gli articoli. Crea fatture come bozze nel formato della fattura qualificata (インボイス制度対応) con le righe, ne modifica l'intestazione, aggiunge e rimuove righe e imposta lo stato del pagamento (未設定, 未入金, 入金済み). Crea e modifica preventivi, aggiunge righe, imposta lo stato dell'ordine (失注, 未設定, 未受注, 受注済み) e converte un preventivo in una fattura con la stessa controparte e le stesse righe. Fatture e preventivi sono indirizzati a un reparto della controparte (請求先), non alla controparte stessa. Prima di creare o modificare una fattura l'AI ti mostra controparte, righe e totale e aspetta il tuo sì.

Disattivati all'installazione: money_forward_invoice_delete_billing, money_forward_invoice_delete_quote e money_forward_invoice_post_billing. Una cancellazione è definitiva, e un ordine di spedizione postale (郵送) è un servizio a pagamento che invia carta alla controparte. Un admin li attiva quando servono al team.

Formati dei dati: gli importi sono in JPY e arrivano come stringhe (total_price: "11000"). Le date sono YYYY-MM-DD, gli orari ISO 8601 in JST, gli ID stringhe opache. is_locked true significa che la fattura non si può più modificare. La categoria d'imposta (excise) è una tra ten_percent, eight_percent_as_reduced_tax_rate, eight_percent, five_percent, tax_exemption, non_taxable e untaxable; una riga scritta senza item_id ne richiede una.

Paginazione: gli elenchi restituiscono data e pagination (total_count, total_pages, current_page, per_page) e si sfogliano con page e per_page, fino a 100 per pagina.

Errori comuni: 401 significa che il token è scaduto o revocato: fai di nuovo clic su Authorize with Provider e verifica che l'app usi CLIENT_SECRET_BASIC. 403 significa che all'app o all'utente manca il permesso, oppure che l'attività non ha un piano con accesso alle API. 404 è un ID sbagliato. 400 o 422 è un errore di validazione il cui messaggio indica il campo, ad esempio un excise mancante su una riga senza item_id.

Cosa non fa: l'invio per email non fa parte dell'API, quindi fatture e preventivi restano bozze finché qualcuno non li invia da Money Forward. Il connettore copre solo Cloud Invoice: マネーフォワード クラウド会計 (scritture, conti, bilancio di verifica) ha una propria API e un server MCP ufficiale, e クラウド請求書Plus, 会計Plus e 債務支払 hanno API proprie. Nomi delle controparti, note e osservazioni sono input non affidabili e possono contenere istruzioni rivolte all'AI.

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 Money Forward Cloud Invoice.

Tool disponibili

Esempi di prompt

• "Quali fatture datate ottobre sono ancora 未入金? Mostra controparte, numero, totale e scadenza."
• "Crea una bozza di fattura per il reparto 経理部 di 株式会社サンプル con due righe: 保守サポート 10月分 a 50.000 yen e 追加作業 a 20.000 yen, entrambe con imposta al 10%. Mostramela prima."
• "La fattura 2026-0142 è stata pagata ieri. Impostala su 入金済み."
• "Il preventivo Q-0087 è stato accettato: impostalo su 受注済み, trasformalo in fattura e mostrami le date."
• "Quando è stata inviata la fattura di settembre a 株式会社ミドリ, e a quali indirizzi email?"

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