Ramp MCP Server

आधिकारिक

Ramp के डेवलपर API के साथ इंटरैक्ट करके अपने खर्च का विश्लेषण करें और LLMs का उपयोग करके जानकारी प्राप्त करें

दस्तावेज़

ramp-mcp: एक Ramp MCP सर्वर

अवलोकन

डेटा प्राप्त करने और विश्लेषण करने या Ramp के लिए Developer API का उपयोग करके कार्य चलाने के लिए एक Model Context Protocol सर्वर। टोकन और इनपुट आकार सीमाओं से निपटने के लिए, यह सर्वर एक सरल ETL पाइपलाइन + एलएलएम द्वारा विश्लेषण के लिए मेमोरी में अस्थायी sqlite डेटाबेस लागू करता है। सभी अनुरोध डिफ़ॉल्ट रूप से डेमो पर किए जाते हैं, लेकिन 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 सेटअप

Ramp डेवलपर पेज से एक नया क्लाइंट बनाएं (ऊपर दाईं ओर प्रोफ़ाइल > डेवलपर > ऐप बनाएं)
क्लाइंट को वे स्कोप प्रदान करें जो आप चाहते हैं (उपकरणों के आधार पर) और क्लाइंट क्रेडेंशियल सक्षम करें (ऐप पर क्लिक करें > ग्रांट प्रकार / स्कोप)
कॉन्फ़िग फ़ाइल में क्लाइंट आईडी और सीक्रेट के साथ-साथ वे स्कोप शामिल करें जिनका आप उपयोग करना चाहते हैं

स्थानीय सेटअप

इस Github रेपो को git clone [email protected]:ramp/ramp-mcp.git या समकक्ष के माध्यम से क्लोन करें
uv इंस्टॉल करें

उपयोग

अपने CLI से MCP सर्वर चलाएं:

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/ में एक बनाएं