Come collegare Ramp a Gemini via MCP

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

Ramp + Gemini

Fai leggere alla tua AI il tuo account Ramp: carte, fondi e limiti di spesa, transazioni, rimborsi, fatture, fornitori, ricevute, estratti conto, conti di contabilità generale e utenti. Scope OAuth in sola lettura; non può inviare né approvare pagamenti. Il blocco carta e il memo sono opzionali e spenti di default.

Prerequisiti

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

RAMP_CLIENT_ID, RAMP_CLIENT_SECRET

Step 1 — Ottieni le credenziali

Non può muovere denaro né approvare nulla, per scelta. Il connettore non ha nessuno strumento per pagare fatture, liquidare rimborsi, fare bonifici, emettere carte o cambiare limiti, nemmeno uno spento, e non può approvare una fattura, un rimborso o una transazione. Il team finance può fare domande all'AI sulle spese senza darle un modo per pagare.

1. Accedi a https://app.ramp.com come admin o business owner e apri Company, poi Developer. Clicca Create New App, dalle un nome (per esempio AnythingMCP) e accetta i termini.
2. In Grant types, aggiungi Client Credentials.
3. In Scopes, clicca Configure allowed scopes e consenti tutti questi scope in sola lettura: business:read, users:read, departments:read, locations:read, entities:read, cards:read, funds:read, spend_programs:read, transactions:read, reimbursements:read, bills:read, vendors:read, receipts:read, accounting:read, statements:read. Il connettore li richiede tutti quando ottiene un token, quindi ognuno deve essere consentito nell'app; se ne manca uno, Ramp rifiuta il token con invalid_scope.
4. Copia il Client ID in RAMP_CLIENT_ID e il Client Secret in RAMP_CLIENT_SECRET, poi installa il connettore. AnythingMCP ottiene un access token (valido 10 giorni) e lo rinnova da solo.
5. Verifica la configurazione con ramp_get_business: mostra il nome della tua azienda e se i rimborsi sono attivi.

Da non consentire mai per questa app: bills:write, reimbursements:write, cards:read_vault, limits:write. Con gli scope di lettura sopra, il token non può modificare nulla in Ramp.

Spenti all'installazione: ramp_lock_card e ramp_unlock_card (sospendono una carta persa e tolgono di nuovo la sospensione) e ramp_update_transaction_memo (imposta il memo, al massimo 255 caratteri, sostituendo quello precedente). Per usarli, consenti cards:write o memos:write nell'app Ramp, aggiungi lo stesso scope all'elenco degli scope nelle impostazioni OAuth del connettore e attiva lo strumento. L'AI ti mostra il nome della carta e le ultime quattro cifre, oppure la transazione e il nuovo memo, e aspetta il tuo sì. Lo scope cards:write di Ramp permetterebbe a un software anche di emettere carte; questo connettore non ha uno strumento del genere.

I dati finanziari sono sensibili: saldi, transazioni, fatture, rimborsi, carte e dati dei dipendenti sono dati aziendali riservati. Condividi il server MCP solo con chi può vederli; l'AI legge solo ciò che chiedi. Numeri di carta completi e CVC non vengono mai restituiti (il vault delle carte di Ramp non viene usato), e i dati bancari di società e fornitori, così come i codici fiscali dei fornitori, vengono esclusi.

Cosa legge: dati aziendali e saldo (limite carta, limite disponibile, saldo dell'estratto conto e date di fatturazione); utenti, reparti, sedi e società; carte fisiche e virtuali; fondi (limiti di spesa) con saldo e restrizioni, e spend program; transazioni carta con esercente, categoria, memo, ricevute e stato di sincronizzazione contabile, dove requires_memo trova quelle a cui manca ancora un memo; rimborsi spese e chilometrici; fatture di Bill Pay con stato di approvazione e date di scadenza e pagamento; fornitori con i totali di spesa; ricevute con un link di download temporaneo e, se lo chiedi, gli importi che Ramp ha letto; conti di contabilità generale sincronizzati dal tuo gestionale; ed estratti conto della carta con un link PDF temporaneo.

Importi: l'importo di una transazione è un semplice numero in dollari (90.0), mentre gli oggetti importo sono in centesimi (9000 significa 90,00 USD). L'AI li converte.

Sandbox: con un'app della sandbox di Ramp, cambia l'URL di base del connettore in https://demo-api.ramp.com/developer/v1 e l'URL del token in https://demo-api.ramp.com/developer/v1/token. Le credenziali di produzione e di sandbox sono separate.

Limite di richieste: 200 richieste ogni 10 secondi per indirizzo IP; un 429 significa aspettare qualche secondo.

Errori comuni: nessun access token: client ID o secret errati, Client Credentials non aggiunto o uno scope non consentito nell'app (invalid_scope). 403: al token manca lo scope di quello strumento. 404 con DEVELOPER_7002: Ramp non conosce il token, per esempio un'app di sandbox usata in produzione; qui Ramp risponde 404 invece di 401. Qualsiasi altro 404: l'id non esiste.

Il connettore non paga fatture o rimborsi, non muove denaro, non emette né chiude carte, non modifica fondi e limiti, non approva nulla, non carica ricevute e non gestisce utenti, fornitori o la configurazione contabile.

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

Tool disponibili

Esempi di prompt

• "Quali transazioni carta della settimana scorsa non hanno ancora un memo o una ricevuta? Elenca titolare, esercente e importo."
• "Quali fatture scadono nei prossimi 14 giorni? Mostra fornitore, importo, scadenza e stato di approvazione."
• "Mostra i rimborsi inviati questo mese che non sono ancora stati pagati, raggruppati per dipendente."
• "Quali fondi hanno meno del 20 percento del limite rimasto in questo periodo?"
• "Qual è il saldo dell'estratto conto Ramp, il limite carta disponibile e la prossima data di fatturazione?"

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