Ramp

ramp-mcp: Un servidor MCP de Ramp

Resumen

Un servidor de Protocolo de Contexto de Modelo para recuperar y analizar datos o ejecutar tareas para Ramp usando la API de Desarrollador. Para sortear las limitaciones de tamaño de tokens y entradas, este servidor implementa un pipeline ETL simple + una base de datos sqlite efímera en memoria para el análisis por un LLM. Todas las solicitudes se realizan al entorno de demostración por defecto, pero se pueden cambiar configurando RAMP_ENV=prd. Los conjuntos de datos grandes pueden no ser procesables debido a las limitaciones de la API y/o de tu cliente MCP.

Herramientas

Herramientas de base de datos

Herramientas que se pueden usar para configurar, procesar, consultar y eliminar una base de datos efímera en memoria.

1. process_data
2. execute_query
3. clear_table

Herramientas de recuperación

Herramientas que se pueden usar para recuperar datos directamente

1. get_ramp_categories
2. get_currencies

Herramientas de carga

Carga datos al servidor que el cliente puede recuperar. Según las herramientas que desees usar, asegúrate de habilitar esos alcances en tu cliente de Ramp e incluye los alcances al iniciar el servidor como argumento de línea de comandos.

Herramienta	Alcance
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

Para conjuntos de datos grandes, se recomienda indicar explícitamente a Claude que no use REPL y que mantenga las respuestas concisas para evitar tiempos de espera o uso excesivo de tokens.

Configuración

Configuración de Ramp

1. Crea un nuevo cliente desde la página de desarrollador de Ramp (Perfil en la esquina superior derecha > Desarrollador > Crear aplicación)
2. Otorga los alcances que desees (según las herramientas) al cliente y habilita las credenciales del cliente (Haz clic en Aplicación > Tipos de concesión / Alcances)
3. Incluye el ID y secreto del cliente en el archivo de configuración, así como los alcances que desees usar

Configuración local

1. Clona este repositorio de Github mediante git clone git@github.com:ramp/ramp-mcp.git o equivalente
2. Instala uv

Uso

Ejecuta el servidor MCP desde tu CLI con:

RAMP_CLIENT_ID=... RAMP_CLIENT_SECRET=... RAMP_ENV=<demo|prd> uv run ramp-mcp -s <COMMA-SEPARATED-SCOPES>

Configuración

Uso con Claude Desktop

Agrega esto a tu 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>"
      }
    }
  }
}

Si este archivo aún no existe, crea uno en /<ABSOLUTE-PATH-TO>/Library/Application Support/Claude/

Licencia

Copyright (c) 2025, Ramp Business Corporation Todos los derechos reservados. Este código fuente está licenciado bajo la Licencia MIT que se encuentra en el archivo LICENSE en el directorio raíz de este árbol de código fuente.