Ramp

ทางการ

โต้ตอบกับ Developer API ของ Ramp เพื่อวิเคราะห์ค่าใช้จ่ายของคุณและรับข้อมูลเชิงลึกโดยใช้ LLMs

GitHub

คุณทำอะไรได้บ้างด้วย Ramp MCP?

โหลดข้อมูลทางการเงินเข้าสู่ฐานข้อมูลในหน่วยความจำ — ใช้ load_transactions, load_bills, load_reimbursements และเครื่องมือโหลดอื่นๆ เพื่อดึงข้อมูล Ramp เข้าสู่ฐานข้อมูล SQLite ชั่วคราวสำหรับการวิเคราะห์
สอบถามข้อมูลที่โหลดแล้วด้วย SQL — รันคำสั่ง SQL ใดๆ กับฐานข้อมูลในหน่วยความจำโดยใช้ execute_query เพื่อกรอง รวมกลุ่ม หรือเชื่อมชุดข้อมูลที่โหลดไว้
ดึงข้อมูลอ้างอิงโดยตรง — ดึงหมวดหมู่ Ramp และสกุลเงินที่รองรับผ่าน get_ramp_categories และ get_currencies โดยไม่ต้องโหลดเข้าสู่ฐานข้อมูล
จัดการฐานข้อมูลชั่วคราว — ประมวลผลการตอบสนอง API ดิบเป็นตารางที่สามารถสอบถามได้ด้วย process_data และล้างตารางโดยใช้ clear_table เมื่อเสร็จสิ้น

เอกสาร

ramp-mcp: เซิร์ฟเวอร์ MCP ของ Ramp

ภาพรวม

เซิร์ฟเวอร์ Model Context Protocol สำหรับการดึงและวิเคราะห์ข้อมูลหรือรันงานสำหรับ Ramp โดยใช้ Developer API เพื่อหลีกเลี่ยงข้อจำกัดด้านขนาดโทเค็นและอินพุต เซิร์ฟเวอร์นี้ใช้ไปป์ไลน์ ETL อย่างง่าย + ฐานข้อมูล sqlite ชั่วคราวในหน่วยความจำสำหรับการวิเคราะห์โดย LLM คำขอทั้งหมดจะถูกส่งไปยังเดโมตามค่าเริ่มต้น แต่สามารถเปลี่ยนแปลงได้โดยการตั้งค่า RAMP_ENV=prd ชุดข้อมูลขนาดใหญ่อาจไม่สามารถประมวลผลได้เนื่องจากข้อจำกัดของ API และ/หรือไคลเอนต์ MCP ของคุณ

เครื่องมือ

เครื่องมือฐานข้อมูล

เครื่องมือที่สามารถใช้ในการตั้งค่า ประมวลผล สืบค้น และลบฐานข้อมูลชั่วคราวในหน่วยความจำ

process_data
execute_query
clear_table

เครื่องมือดึงข้อมูล

เครื่องมือที่สามารถใช้ในการดึงข้อมูลโดยตรง

get_ramp_categories
get_currencies

เครื่องมือโหลดข้อมูล

โหลดข้อมูลไปยังเซิร์ฟเวอร์ซึ่งไคลเอนต์สามารถดึงข้อมูลได้ ตามเครื่องมือที่คุณต้องการใช้ ตรวจสอบให้แน่ใจว่าได้เปิดใช้งานขอบเขตเหล่านั้นบนไคลเอนต์ Ramp ของคุณและรวมขอบเขตเมื่อเริ่มต้นเซิร์ฟเวอร์เป็นอาร์กิวเมนต์ CLI

เครื่องมือ	ขอบเขต
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

สำหรับชุดข้อมูลขนาดใหญ่ ขอแนะนำให้แจ้ง Claude อย่างชัดเจนไม่ให้ใช้ REPL และให้ตอบกลับอย่างกระชับเพื่อหลีกเลี่ยงการหมดเวลาหรือการใช้โทเค็นมากเกินไป

การตั้งค่า

การตั้งค่า Ramp

สร้างไคลเอนต์ใหม่จากหน้า developer ของ Ramp (โปรไฟล์ที่มุมขวาบน > Developer > Create app)
ให้สิทธิ์ขอบเขตที่คุณต้องการ (ตามเครื่องมือ) แก่ไคลเอนต์และเปิดใช้งาน client credentials (คลิกที่ App > Grant Types / Scopes)
รวม client ID และ secret ในไฟล์กำหนดค่า รวมถึงขอบเขตที่คุณต้องการใช้

การตั้งค่าในเครื่อง

โคลน Github repo นี้ผ่าน git clone git@github.com:ramp/ramp-mcp.git หรือเทียบเท่า
ติดตั้ง uv

การใช้งาน

รันเซิร์ฟเวอร์ MCP จาก CLI ของคุณด้วย:

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

การกำหนดค่า

การใช้งานกับ Claude Desktop

เพิ่มสิ่งนี้ลงใน claude_desktop_config.json ของคุณ:

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

หากไฟล์นี้ยังไม่มีอยู่ ให้สร้างใน /<ABSOLUTE-PATH-TO>/Library/Application Support/Claude/