Ramp MCP Server

공식

Ramp의 개발자 API와 상호작용하여 지출 분석을 실행하고 LLM을 활용한 인사이트를 얻습니다.

문서

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 인수로 범위를 포함해야 합니다.

도구	범위
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/에 생성하세요.