Ramp

offiziell

Interagieren Sie mit der Ramp Developer API, um Analysen Ihrer Ausgaben durchzuführen und Erkenntnisse mithilfe von LLMs zu gewinnen.

GitHub

Was kann man mit Ramp MCP machen?

Finanzdaten in eine In-Memory-Datenbank laden – Verwenden Sie load_transactions, load_bills, load_reimbursements und andere Lade-Tools, um Ramp-Daten in eine flüchtige SQLite-Datenbank zur Analyse zu importieren.
Geladene Daten mit SQL abfragen – Führen Sie beliebige SQL-Abfragen gegen die In-Memory-Datenbank mit execute_query aus, um geladene Datensätze zu filtern, zu aggregieren oder zu verknüpfen.
Referenzdaten direkt abrufen – Rufen Sie Ramp-Kategorien und unterstützte Währungen über get_ramp_categories und get_currencies ab, ohne sie in die Datenbank zu laden.
Die flüchtige Datenbank verwalten – Verarbeiten Sie rohe API-Antworten mit process_data in abfragbare Tabellen und leeren Sie Tabellen mit clear_table, wenn Sie fertig sind.

Dokumentation

ramp-mcp: Ein Ramp MCP-Server

Übersicht

Ein Model Context Protocol-Server zum Abrufen und Analysieren von Daten oder Ausführen von Aufgaben für Ramp unter Verwendung der Developer API. Um Token- und Eingabegrößenbeschränkungen zu umgehen, implementiert dieser Server eine einfache ETL-Pipeline sowie eine flüchtige SQLite-Datenbank im Arbeitsspeicher für die Analyse durch ein LLM. Alle Anfragen werden standardmäßig an die Demo-Umgebung gestellt, können aber durch Setzen von RAMP_ENV=prd geändert werden. Große Datensätze können aufgrund von API- und/oder MCP-Client-Beschränkungen möglicherweise nicht verarbeitet werden.

Werkzeuge

Datenbank-Werkzeuge

Werkzeuge, die zum Einrichten, Verarbeiten, Abfragen und Löschen einer flüchtigen Datenbank im Arbeitsspeicher verwendet werden können.

process_data
execute_query
clear_table

Abruf-Werkzeuge

Werkzeuge, die zum direkten Abrufen von Daten verwendet werden können

get_ramp_categories
get_currencies

Lade-Werkzeuge

Lädt Daten auf den Server, die der Client abrufen kann. Stellen Sie basierend auf den gewünschten Werkzeugen sicher, dass Sie diese Bereiche auf Ihrem Ramp-Client aktivieren und die Bereiche beim Starten des Servers als CLI-Argument angeben.

Werkzeug	Bereich
load_transactions	transactions:read
load_reimbursements	reimbursements:read
load_bills	bills:read
load_locations	locations:read
load_departments	departments:read
load_bank_accounts	bank_accounts:read
load_vendors	vendors:read
load_vendor_bank_accounts	vendors:read
load_entities	entities:read
load_spend_limits	limits:read
load_spend_programs	spend_programs:read
load_users	users:read

Bei großen Datensätzen wird empfohlen, Claude explizit aufzufordern, REPL nicht zu verwenden und die Antworten prägnant zu halten, um Timeouts oder übermäßigen Token-Verbrauch zu vermeiden.

Einrichtung

Ramp-Einrichtung

Erstellen Sie einen neuen Client auf der Ramp-Entwicklerseite (Profil oben rechts > Developer > App erstellen)
Gewähren Sie dem Client die gewünschten Bereiche (basierend auf den Werkzeugen) und aktivieren Sie Client-Anmeldeinformationen (Klicken Sie auf App > Grant Types / Scopes)
Geben Sie die Client-ID und das Secret sowie die gewünschten Bereiche in der Konfigurationsdatei an

Lokale Einrichtung

Klonen Sie dieses Github-Repository über git clone git@github.com:ramp/ramp-mcp.git oder eine äquivalente Methode
Installieren Sie uv

Verwendung

Führen Sie den MCP-Server über Ihre CLI aus mit:

RAMP_CLIENT_ID=... RAMP_CLIENT_SECRET=... RAMP_ENV=<demo|prd> uv run ramp-mcp -s <COMMA-SEPARATED-SCOPES>

Konfiguration

Verwendung mit Claude Desktop

Fügen Sie dies zu Ihrer claude_desktop_config.json hinzu:

{
  "mcpServers": {
    "ramp-mcp": {
      "command": "uv",
      "args": [
        "--directory",
        "/<ABSOLUTE-PATH-TO>/ramp-mcp", // make sure to update this path
        "run",
        "ramp-mcp",
        "-s",
        "transactions:read,reimbursements:read"
      ],
      "env": {
        "RAMP_CLIENT_ID": "<CLIENT_ID>",
        "RAMP_CLIENT_SECRET": "<CLIENT_SECRET>",
        "RAMP_ENV": "<demo|qa|prd>"
      }
    }
  }
}

Falls diese Datei noch nicht existiert, erstellen Sie eine in /<ABSOLUTE-PATH-TO>/Library/Application Support/Claude/

Lizenz

Copyright (c) 2025, Ramp Business Corporation Alle Rechte vorbehalten. Dieser Quellcode ist unter der MIT-Lizenz lizenziert, die in der LICENSE-Datei im Stammverzeichnis dieses Quellbaums zu finden ist.