Ramp

ramp-mcp: Um servidor MCP da Ramp

Visão geral

Um servidor de Protocolo de Contexto de Modelo (MCP) para recuperar e analisar dados ou executar tarefas para Ramp usando a API de Desenvolvedor. Para contornar as limitações de tamanho de token e entrada, este servidor implementa um pipeline ETL simples + um banco de dados sqlite efêmero em memória para análise por um LLM. Todas as solicitações são feitas para o ambiente de demonstração por padrão, mas podem ser alteradas definindo RAMP_ENV=prd. Conjuntos de dados grandes podem não ser processáveis devido a limitações da API e/ou do seu cliente MCP.

Ferramentas

Ferramentas de banco de dados

Ferramentas que podem ser usadas para configurar, processar, consultar e excluir um banco de dados efêmero em memória.

1. process_data
2. execute_query
3. clear_table

Ferramentas de busca

Ferramentas que podem ser usadas para buscar dados diretamente

1. get_ramp_categories
2. get_currencies

Ferramentas de carregamento

Carrega dados para o servidor que o cliente pode buscar. Com base nas ferramentas que você deseja usar, certifique-se de habilitar esses escopos no seu cliente Ramp e inclua os escopos ao iniciar o servidor como um argumento de CLI.

Ferramenta	Escopo
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 dados grandes, é recomendado instruir explicitamente o Claude a não usar REPL e a manter as respostas concisas para evitar tempo limite ou uso excessivo de tokens.

Configuração

Configuração da Ramp

1. Crie um novo cliente na página de desenvolvedor da Ramp (Perfil no canto superior direito > Desenvolvedor > Criar aplicativo)
2. Conceda os escopos desejados (com base nas ferramentas) ao cliente e habilite as credenciais do cliente (Clique em Aplicativo > Tipos de Concessão / Escopos)
3. Inclua o ID do cliente e o segredo no arquivo de configuração, bem como os escopos que deseja usar

Configuração local

1. Clone este repositório Github via git clone git@github.com:ramp/ramp-mcp.git ou equivalente
2. Instale uv

Uso

Execute o servidor MCP a partir do seu CLI com:

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

Configuração

Uso com Claude Desktop

Adicione isto ao seu 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>"
      }
    }
  }
}

Se este arquivo ainda não existir, crie um em /<ABSOLUTE-PATH-TO>/Library/Application Support/Claude/

Licença

Copyright (c) 2025, Ramp Business Corporation Todos os direitos reservados. Este código-fonte é licenciado sob a Licença MIT encontrada no arquivo LICENSE no diretório raiz desta árvore de código-fonte.