Ramp MCP Server

ทางการ

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

เอกสาร

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 [email protected]: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/