Ramp MCP Server

公式

RampのDeveloper APIと連携し、支出分析を実行してLLMを活用したインサイトを得ることができます。

ドキュメント

ramp-mcp: Ramp MCP サーバー

概要

Developer API を使用して Ramp のデータ取得・分析やタスク実行を行うための Model Context Protocol サーバーです。トークンや入力サイズの制限に対応するため、このサーバーはシンプルな 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 のセットアップ

Ramp 開発者ページ（右上のプロフィール > Developer > Create app）から新しいクライアントを作成します。
使用したいスコープ（ツールに基づく）をクライアントに付与し、クライアント認証情報を有効にします（App > Grant Types / Scopes をクリック）。
クライアント ID とシークレット、および使用するスコープを設定ファイルに含めます。

ローカルセットアップ

git clone [email protected]:ramp/ramp-mcp.git または同等の方法でこの GitHub リポジトリをクローンします。
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/ に作成してください。