Come collegare Ramp a Claude 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 + Claude

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 Claude

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.

Percorso consigliato: funziona su claude.ai web senza toccare alcun file di configurazione.

1. In Claude apri Customize → Connectors.
2. Clicca + e poi Add custom connector.
3. Inserisci un nome, ad esempio Ramp, e l'URL del server MCP remoto https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID, poi clicca Add.
4. Clicca Connect e accedi ad AnythingMCP (OAuth) per consentire l'accesso.

Tutti i tool sotto compaiono nella tua chat: inizia a scrivere prompt.

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

Funziona con Claude Code come con Claude Desktop? Sì, punta entrambi a https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID.

Prossimi passi

• Landing del connettore
• Collegare a ChatGPT
• Collegare a Cursor
• Collegare a Gemini
• Collegare a Meta Muse