Ramp MCP Server

ramp-mcp: Um servidor MCP da Ramp

Visão geral

Um servidor Model Context Protocol para recuperar e analisar dados ou executar tarefas para a Ramp usando a API do desenvolvedor. Para contornar as limitações de tamanho de tokens e entrada, este servidor implementa um pipeline ETL simples + banco de dados sqlite efêmero em memória para análise por um LLM. Todas as requisições são feitas para demonstração por padrão, mas podem ser alteradas configurando RAMP_ENV=prd. Grandes conjuntos de dados podem não ser processáveis devido às 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 incluir os escopos ao iniciar o servidor como um argumento 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 grandes conjuntos de dados, é recomendado instruir explicitamente o Claude a não usar REPL e manter as respostas concisas para evitar timeout 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 e o segredo do cliente no arquivo de configuração, bem como os escopos que deseja usar

Configuração local

1. Clone este repositório do Github via git clone [email protected]:ramp/ramp-mcp.git ou equivalente
2. Instale o uv

Uso

Execute o servidor MCP a partir da sua CLI com:

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

Configuração

Uso com o 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 está licenciado sob a Licença MIT encontrada no arquivo LICENSE no diretório raiz desta árvore de código-fonte.