Ramp

chính thức

Tương tác với API dành cho nhà phát triển của Ramp để phân tích chi tiêu và thu thập thông tin chi tiết bằng cách tận dụng LLM.

GitHub

Bạn có thể làm gì với Ramp MCP?

Tải dữ liệu tài chính vào cơ sở dữ liệu trong bộ nhớ — sử dụng load_transactions, load_bills, load_reimbursements và các công cụ tải khác để kéo dữ liệu Ramp vào cơ sở dữ liệu SQLite tạm thời để phân tích.
Truy vấn dữ liệu đã tải bằng SQL — chạy các truy vấn SQL tùy ý trên cơ sở dữ liệu trong bộ nhớ bằng execute_query để lọc, tổng hợp hoặc kết hợp các tập dữ liệu đã tải.
Truy xuất dữ liệu tham chiếu trực tiếp — truy xuất danh mục Ramp và các loại tiền tệ được hỗ trợ qua get_ramp_categories và get_currencies mà không cần tải chúng vào cơ sở dữ liệu.
Quản lý cơ sở dữ liệu tạm thời — xử lý các phản hồi API thô thành các bảng có thể truy vấn bằng process_data và xóa các bảng bằng clear_table khi hoàn tất.

Tài liệu

ramp-mcp: Máy chủ MCP Ramp

Tổng quan

Máy chủ Giao thức Ngữ cảnh Mô hình dùng để truy xuất và phân tích dữ liệu hoặc chạy tác vụ cho Ramp bằng API Nhà phát triển. Để khắc phục các giới hạn về token và kích thước đầu vào, máy chủ này triển khai một pipeline ETL đơn giản cùng cơ sở dữ liệu sqlite tạm thời trong bộ nhớ để LLM phân tích. Tất cả yêu cầu mặc định được gửi đến bản demo, nhưng có thể thay đổi bằng cách đặt RAMP_ENV=prd. Các tập dữ liệu lớn có thể không xử lý được do giới hạn của API và/hoặc máy khách MCP của bạn.

Công cụ

Công cụ cơ sở dữ liệu

Các công cụ dùng để thiết lập, xử lý, truy vấn và xóa cơ sở dữ liệu tạm thời trong bộ nhớ.

process_data
execute_query
clear_table

Công cụ tìm nạp

Các công cụ dùng để tìm nạp dữ liệu trực tiếp

get_ramp_categories
get_currencies

Công cụ tải

Tải dữ liệu lên máy chủ để máy khách có thể tìm nạp. Dựa trên các công cụ bạn muốn sử dụng, hãy đảm bảo bật các phạm vi đó trên máy khách Ramp của bạn và bao gồm các phạm vi khi khởi động máy chủ dưới dạng đối số CLI.

Công cụ	Phạm vi
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

Đối với các tập dữ liệu lớn, bạn nên yêu cầu Claude một cách rõ ràng không sử dụng REPL và giữ cho phản hồi ngắn gọn để tránh hết thời gian chờ hoặc sử dụng token quá mức.

Thiết lập

Thiết lập Ramp

Tạo một máy khách mới từ trang nhà phát triển Ramp (Hồ sơ ở góc trên bên phải > Nhà phát triển > Tạo ứng dụng)
Cấp các phạm vi bạn muốn (dựa trên công cụ) cho máy khách và bật thông tin xác thực máy khách (Nhấp vào Ứng dụng > Loại cấp / Phạm vi)
Bao gồm ID máy khách và bí mật trong tệp cấu hình cũng như các phạm vi bạn muốn sử dụng

Thiết lập cục bộ

Sao chép repo Github này qua git clone git@github.com:ramp/ramp-mcp.git hoặc tương đương
Cài đặt uv

Cách sử dụng

Chạy máy chủ MCP từ CLI của bạn bằng:

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

Cấu hình

Sử dụng với Claude Desktop

Thêm phần này vào claude_desktop_config.json của bạn:

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

Nếu tệp này chưa tồn tại, hãy tạo một tệp trong /<ABSOLUTE-PATH-TO>/Library/Application Support/Claude/