Come collegare BILL (Bill.com) a Gemini via MCP

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

BILL (Bill.com) + Gemini

Contabilità fornitori e clienti in BILL (Bill.com): fornitori, fatture passive, fatture ricorrenti, note di credito dei fornitori, approvazioni delle fatture e relative policy, pagamenti ai fornitori, clienti, fatture attive, note di credito e incassi. API v3 di BILL con developer key e accesso utente; l'approvazione delle fatture è inclusa ma disattivata 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:

BILL_API_URL, BILL_DEV_KEY, BILL_ORGANIZATION_ID, BILL_USERNAME, BILL_PASSWORD

Step 1 — Ottieni le credenziali

1. Per accedere all'API di BILL serve una developer key. La genera un amministratore nell'app web di BILL in Settings → Sync & Integrations → Manage Developer Keys → Generate developer key. Per provare prima, registra un account sviluppatore sandbox su https://developer.bill.com, che include una chiave sandbox. Incolla la chiave in BILL_DEV_KEY.
2. Copia l'ID dell'organizzazione, che trovi in fondo alla stessa pagina Manage Developer Keys, in BILL_ORGANIZATION_ID. Inizia con 008.
3. Inserisci l'e-mail e la password di un utente BILL di quell'organizzazione in BILL_USERNAME e BILL_PASSWORD. Usa un utente dedicato all'API: il suo ruolo in BILL limita ciò che l'AI può vedere e fare.
4. Imposta BILL_API_URL su https://gateway.prod.bill.com/connect per la produzione o su https://gateway.stage.bill.com/connect per la sandbox. Una developer key sandbox non funziona in produzione, e viceversa.
5. Installa il connettore ed esegui per primo bill_com_get_session. Verifica l'accesso e mostra con quale organizzazione e quale utente lavora il connettore.

Sessioni: il connettore accede come quell'utente e gestisce la sessione da solo. Una sessione scade dopo 35 minuti di inattività, e il connettore semplicemente accede di nuovo.

Cosa legge: BILL (in precedenza Bill.com) gestisce la contabilità fornitori e clienti delle aziende statunitensi. Sul lato fornitori l'AI legge i fornitori, le fatture passive con scadenza, stato di pagamento e di approvazione, le fatture ricorrenti, le note di credito dei fornitori, i pagamenti ai fornitori, le policy di approvazione e le fatture in attesa della tua approvazione. Sul lato clienti legge i clienti, le fatture attive, le note di credito e gli incassi.

Da dove iniziare: chiedi le fatture non pagate o pagate in parte ordinate per scadenza, le fatture in attesa della tua approvazione oppure le fatture ai clienti ancora aperte o pagate in parte.

Approvazioni disattivate all'installazione: bill_com_approve_or_deny_bills approva o rifiuta le fatture in attesa dell'approvazione dell'utente collegato, con un commento facoltativo per fattura, e le fatture approvate possono poi essere pagate. Attivalo solo se vuoi che l'AI approvi fatture per quell'utente; parte dall'elenco di bill_com_list_pending_approvals. Tutto il resto è in sola lettura.

Limiti: 20.000 richieste per developer key all'ora, 3 richieste contemporanee per organizzazione e 200 accessi per developer key all'ora. Gli errori BDC_1144 e BDC_1322 indicano che è stato raggiunto un limite: attendi e riprova.

Il connettore non esegue pagamenti e non crea fatture passive né fatture attive.

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 BILL (Bill.com).

Tool disponibili

Esempi di prompt

• "Quali fatture sono non pagate o pagate in parte, ordinate per scadenza, e quanto scade nei prossimi 14 giorni?"
• "Quali fatture aspettano la mia approvazione, di quali fornitori e per quali importi?"
• "Elenca le fatture ai clienti ancora aperte e già scadute, con l'importo ancora da incassare."
• "Quali pagamenti ai fornitori sono partiti questo mese e quali fatture hanno saldato?"

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