Ramp MCP Server

resmi

Berinteraksi dengan API Developer Ramp untuk menjalankan analisis pengeluaran Anda dan mendapatkan wawasan dengan memanfaatkan LLM.

GitHub

Dokumentasi

ramp-mcp: Server MCP Ramp

Gambaran Umum

Server Model Context Protocol untuk mengambil dan menganalisis data atau menjalankan tugas untuk Ramp menggunakan Developer API. Untuk mengatasi keterbatasan token dan ukuran input, server ini menerapkan pipeline ETL sederhana + database sqlite ephemeral di memori untuk analisis oleh LLM. Semua permintaan secara default ditujukan ke demo, tetapi dapat diubah dengan mengatur RAMP_ENV=prd. Dataset besar mungkin tidak dapat diproses karena keterbatasan API dan/atau klien MCP Anda.

Alat

Alat Database

Alat yang dapat digunakan untuk menyiapkan, memproses, menanyakan, dan menghapus database ephemeral di memori.

process_data
execute_query
clear_table

Alat Fetch

Alat yang dapat digunakan untuk mengambil data secara langsung

get_ramp_categories
get_currencies

Alat Muat

Memuat data ke server yang dapat diambil oleh klien. Berdasarkan alat yang ingin Anda gunakan, pastikan untuk mengaktifkan cakupan tersebut pada klien Ramp Anda dan sertakan cakupan saat memulai server sebagai argumen CLI.

Alat	Cakupan
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

Untuk dataset besar, disarankan untuk secara eksplisit meminta Claude agar tidak menggunakan REPL dan menjaga respons tetap ringkas untuk menghindari timeout atau penggunaan token yang berlebihan.

Penyiapan

Penyiapan Ramp

Buat klien baru dari halaman pengembang Ramp (Profil di kanan atas > Developer > Create app)
Berikan cakupan yang Anda inginkan (berdasarkan alat) kepada klien dan aktifkan kredensial klien (Klik App > Grant Types / Scopes)
Sertakan ID klien dan rahasia di file konfigurasi serta cakupan yang ingin Anda gunakan

Penyiapan Lokal

Kloning repo Github ini melalui git clone [email protected]:ramp/ramp-mcp.git atau yang setara
Instal uv

Penggunaan

Jalankan server MCP dari CLI Anda dengan:

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

Konfigurasi

Penggunaan dengan Claude Desktop

Tambahkan ini ke claude_desktop_config.json Anda:

{
  "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>"
      }
    }
  }
}

Jika file ini belum ada, buat satu di /<ABSOLUTE-PATH-TO>/Library/Application Support/Claude/