Ramp MCP Server

chính thức

Interact with Ramp's Developer API to run analysis on your spend and gain insights leveraging LLMs

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