ramp-mcp: Ramp MCP 서버

개요

개발자 API를 사용하여 Ramp 에서 데이터를 검색 및 분석하거나 작업을 실행하기 위한 모델 컨텍스트 프로토콜 서버입니다. 토큰 및 입력 크기 제한을 극복하기 위해 이 서버는 LLM에서 분석할 수 있도록 간단한 ETL 파이프라인과 임시 SQLite 데이터베이스를 메모리에 구현합니다. 모든 요청은 기본적으로 데모로 전송되지만, RAMP_ENV=prd 설정을 통해 변경할 수 있습니다. API 및/또는 MCP 클라이언트 제한으로 인해 대용량 데이터세트를 처리하지 못할 수 있습니다.

도구

데이터베이스 도구

메모리에 있는 임시 데이터베이스를 설정, 처리, 쿼리하고, 삭제하는 데 사용할 수 있는 도구입니다.

process_data
execute_query
clear_table

도구 가져오기

데이터를 직접 가져오는 데 사용할 수 있는 도구

get_ramp_categories
get_currencies

도구 로드

클라이언트가 가져올 수 있는 데이터를 서버로 로드합니다. 사용하려는 도구에 따라 Ramp 클라이언트에서 해당 범위를 활성화하고, 서버를 시작할 때 CLI 인수로 해당 범위를 포함해야 합니다.

도구	범위
로드_트랜잭션	거래:읽기
부하 상환	환불:읽기
로드_빌스	청구서:읽다
로드_위치	위치: 읽기
부하_부서	부서:읽기
로드_뱅크_계좌	은행 계좌: 읽기
로드_벤더	공급업체:읽기
로드_벤더_은행_계좌	공급업체:읽기
로드_엔티티	엔티티:읽기
부하 지출 한도	제한:읽기
로드_스펜드_프로그램	지출 프로그램: 읽기
로드_사용자	사용자:읽기

대용량 데이터 세트의 경우 클로드에게 REPL을 사용하지 않도록 명시적으로 요청하고 시간 초과나 과도한 토큰 사용을 방지하기 위해 응답을 간결하게 유지하는 것이 좋습니다.

설정

램프 설정

Ramp 개발자 페이지(오른쪽 상단 프로필 > 개발자 > 앱 만들기)에서 새 클라이언트를 만듭니다.
도구에 따라 원하는 범위를 클라이언트에 부여하고 클라이언트 자격 증명을 활성화합니다(앱 > 부여 유형/범위 클릭).
구성 파일에 클라이언트 ID와 비밀번호를 포함하고 사용하려는 범위도 포함합니다.

로컬 설정

git clone git@github.com:ramp/ramp-mcp.git 또는 이와 동등한 명령어를 통해 이 Github 저장소를 복제하세요.
uv 설치

용법

CLI에서 MCP 서버를 실행하세요.

지엑스피1

구성

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