Ramp MCP Server

официальный

Взаимодействуйте с Developer API Ramp для анализа ваших расходов и получения инсайтов с помощью LLM.

Документация

ramp-mcp: Ramp MCP-сервер

Обзор

Сервер Model Context Protocol для получения и анализа данных или выполнения задач для Ramp с использованием Developer API. Чтобы обойти ограничения по токенам и размеру входных данных, этот сервер реализует простой ETL-конвейер + эфемерную базу данных sqlite в памяти для анализа с помощью LLM. По умолчанию все запросы направляются в демо-среду, но это можно изменить, задав RAMP_ENV=prd. Обработка больших наборов данных может быть невозможна из-за ограничений API и/или вашего MCP-клиента.

Инструменты

Инструменты базы данных

Инструменты, которые можно использовать для настройки, обработки, запросов и удаления эфемерной базы данных в памяти.

process_data
execute_query
clear_table

Инструменты получения данных

Инструменты, которые можно использовать для прямого получения данных

get_ramp_categories
get_currencies

Инструменты загрузки

Загружают данные на сервер, которые клиент может получить. В зависимости от инструментов, которые вы хотите использовать, убедитесь, что вы включили соответствующие области доступа в вашем клиенте Ramp и указали их при запуске сервера в качестве аргумента командной строки.

Инструмент	Область доступа
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)
Предоставьте нужные области доступа (в зависимости от инструментов) клиенту и включите client credentials (Нажмите на приложение > Grant Types / Scopes)
Укажите идентификатор клиента и секрет в файле конфигурации, а также области доступа, которые вы хотите использовать

Локальная настройка

Клонируйте этот репозиторий GitHub через git clone [email protected]:ramp/ramp-mcp.git или аналогичным способом
Установите uv

Использование

Запустите 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/