Ramp MCP Server

resmi

Ramp'in Geliştirici API'si ile etkileşime geçerek harcamalarınız üzerinde analiz yapın ve LLM'leri kullanarak içgörüler elde edin.

GitHub

Dokümantasyon

ramp-mcp: Bir Ramp MCP sunucusu

Genel Bakış

Developer API kullanarak Ramp için veri almak, analiz etmek veya görev çalıştırmak üzere bir Model Context Protocol sunucusu. Token ve girdi boyutu sınırlamalarını aşmak için bu sunucu, bir LLM tarafından analiz edilmek üzere basit bir ETL hattı + bellekte geçici sqlite veritabanı uygular. Tüm istekler varsayılan olarak demo ortamına yapılır, ancak RAMP_ENV=prd ayarlanarak değiştirilebilir. Büyük veri kümeleri, API ve/veya MCP istemci sınırlamaları nedeniyle işlenemeyebilir.

Araçlar

Veritabanı araçları

Bellekte geçici bir veritabanı kurmak, işlemek, sorgulamak ve silmek için kullanılabilecek araçlar.

process_data
execute_query
clear_table

Getirme araçları

Doğrudan veri getirmek için kullanılabilecek araçlar.

get_ramp_categories
get_currencies

Yükleme araçları

İstemcinin getirebileceği verileri sunucuya yükler. Kullanmak istediğiniz araçlara göre, Ramp istemcinizde bu kapsamları etkinleştirdiğinizden ve sunucuyu bir CLI argümanı olarak başlatırken kapsamları dahil ettiğinizden emin olun.

Araç	Kapsam
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

Büyük veri kümeleri için, zaman aşımı veya aşırı token kullanımını önlemek amacıyla Claude'a REPL kullanmamasını ve yanıtları kısa tutmasını açıkça belirtmeniz önerilir.

Kurulum

Ramp Kurulumu

Ramp geliştirici sayfasından yeni bir istemci oluşturun (Sağ üstte Profil > Developer > Create app)
İstemciye kullanmak istediğiniz kapsamları (araçlara göre) verin ve istemci kimlik bilgilerini etkinleştirin (App > Grant Types / Scopes üzerine tıklayın)
İstemci kimliğini ve sırrını yapılandırma dosyasına, ayrıca kullanmak istediğiniz kapsamları ekleyin

Yerel Kurulum

Bu Github deposunu git clone [email protected]:ramp/ramp-mcp.git veya eşdeğeri aracılığıyla klonlayın
uv yükleyin

Kullanım

MCP sunucusunu CLI'nızdan şu komutla çalıştırın:

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

Yapılandırma

Claude Desktop ile Kullanım

Bunu claude_desktop_config.json dosyanıza ekleyin:

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

Bu dosya henüz mevcut değilse, /<ABSOLUTE-PATH-TO>/Library/Application Support/Claude/ içinde oluşturun.