ramp-mcp: Ramp MCP サーバー

概要

Developer APIを使用してRampのデータを取得・分析したり、タスクを実行したりするためのモデルコンテキストプロトコルサーバーです。トークンと入力サイズの制限を回避するため、このサーバーは LLM による分析用に、シンプルな ETL パイプラインと一時的な SQLite データベースをメモリ内に実装しています。すべてのリクエストはデフォルトでデモに送信されますが、 RAMP_ENV=prdを設定することで変更できます。API や MCP クライアントの制限により、大規模なデータセットを処理できない場合があります。

ツール

データベースツール

メモリ内の一時データベースを設定、処理、クエリ、および削除するために使用できるツール。

process_data
execute_query
clear_table

フェッチツール

データを直接取得するために使用できるツール

get_ramp_categories
get_currencies

ツールをロードする

クライアントが取得できるデータをサーバーにロードします。使用するツールに応じて、Rampクライアントでこれらのスコープを有効にし、サーバーの起動時にCLI引数としてスコープを含めてください。

道具	範囲
ロードトランザクション	トランザクション:読み取り
払い戻しの負担	払い戻し：読む
請求書のロード	請求書:読む
ロード場所	場所:読む
部門の読み込み	部門:読む
銀行口座の読み込み	銀行口座:読み取り
ロードベンダー	ベンダー:読む
ベンダー銀行口座の読み込み	ベンダー:読む
ロードエンティティ	エンティティ:読み取り
ロード支出制限	制限:読み取り
ロード支出プログラム	支出プログラム:読む
ロードユーザー	ユーザー:読み取り

大規模なデータセットの場合、タイムアウトや過剰なトークンの使用を避けるために、Claude に REPL を使用しないように明示的に指示し、応答を簡潔にしておくことをお勧めします。

設定

ランプのセットアップ

Ramp 開発者ページから新しいクライアントを作成します (右上のプロフィール > 開発者 > アプリの作成)
必要なスコープ（ツールに基づいて）をクライアントに付与し、クライアントの資格情報を有効にします（[アプリ] > [付与タイプ/スコープ] をクリックします）。
設定ファイルにクライアントIDとシークレット、および使用したいスコープを含めます。

ローカルセットアップ

この Github リポジトリgit clone git@github.com: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/に作成してください。

Ramp MCP Server

Integrations