Ramp

officiel

Interagissez avec l'API développeur de Ramp pour analyser vos dépenses et obtenir des informations grâce aux LLM.

GitHub
33

Que pouvez-vous faire avec Ramp MCP ?

  • Charger des données financières dans une base de données en mémoire — utilisez load_transactions, load_bills, load_reimbursements et d'autres outils de chargement pour importer les données Ramp dans une base de données SQLite éphémère à des fins d'analyse.
  • Interroger les données chargées avec SQL — exécutez des requêtes SQL arbitraires sur la base de données en mémoire à l'aide de execute_query pour filtrer, agréger ou joindre les ensembles de données chargés.
  • Récupérer directement les données de référence — obtenez les catégories Ramp et les devises prises en charge via get_ramp_categories et get_currencies sans les charger dans la base de données.
  • Gérer la base de données éphémère — transformez les réponses brutes de l'API en tables interrogeables avec process_data et effacez les tables à l'aide de clear_table une fois terminé.

Documentation

ramp-mcp : Un serveur MCP Ramp

Aperçu

Un serveur Model Context Protocol pour récupérer et analyser des données ou exécuter des tâches pour Ramp en utilisant l'API Développeur. Afin de contourner les limitations de jetons et de taille d'entrée, ce serveur implémente un pipeline ETL simple ainsi qu'une base de données sqlite éphémère en mémoire pour l'analyse par un LLM. Toutes les requêtes sont effectuées vers la démo par défaut, mais cela peut être modifié en définissant RAMP_ENV=prd. Les jeux de données volumineux peuvent ne pas être traitables en raison des limitations de l'API et/ou de votre client MCP.

Outils

Outils de base de données

Outils pouvant être utilisés pour configurer, traiter, interroger et supprimer une base de données éphémère en mémoire.

  1. process_data
  2. execute_query
  3. clear_table

Outils de récupération

Outils pouvant être utilisés pour récupérer des données directement

  1. get_ramp_categories
  2. get_currencies

Outils de chargement

Charge les données sur le serveur que le client peut récupérer. Selon les outils que vous souhaitez utiliser, assurez-vous d'activer ces portées sur votre client Ramp et d'inclure les portées lors du démarrage du serveur en tant qu'argument CLI.

OutilPortée
load_transactionstransactions:read
load_reimbursementsreimbursements:read
load_billsbills:read
load_locationslocations:read
load_departmentsdepartments:read
load_bank_accountsbank_accounts:read
load_vendorsvendors:read
load_vendor_bank_accountsvendors:read
load_entitiesentities:read
load_spend_limitslimits:read
load_spend_programsspend_programs:read
load_usersusers:read

Pour les jeux de données volumineux, il est recommandé de demander explicitement à Claude de ne pas utiliser REPL et de garder les réponses concises afin d'éviter les délais d'attente ou une utilisation excessive de jetons.

Configuration

Configuration de Ramp

  1. Créez un nouveau client depuis la page développeur Ramp (Profil en haut à droite > Développeur > Créer une application)
  2. Accordez les portées souhaitées (selon les outils) au client et activez les identifiants client (Cliquez sur App > Types d'octroi / Portées)
  3. Incluez l'ID client et le secret dans le fichier de configuration ainsi que les portées que vous souhaitez utiliser

Configuration locale

  1. Clonez ce dépôt Github via git clone git@github.com:ramp/ramp-mcp.git ou équivalent
  2. Installez uv

Utilisation

Exécutez le serveur MCP depuis votre CLI avec :

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

Configuration

Utilisation avec Claude Desktop

Ajoutez ceci à votre 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 ce fichier n'existe pas encore, créez-en un dans /<ABSOLUTE-PATH-TO>/Library/Application Support/Claude/

Licence

Copyright (c) 2025, Ramp Business Corporation Tous droits réservés. Ce code source est sous licence MIT, telle que décrite dans le fichier LICENSE à la racine de ce dépôt.