Как подключить Ramp к Gemini через MCP

💡 Без установки? Используйте cloud.anythingmcp.com напрямую. Войдите, нажмите Connectors → Ramp, вставьте учётные данные, создайте MCP API key, и готово. Без Docker, без git clone, без локального сервера.

Ramp + Gemini

Дайте ИИ читать ваш аккаунт Ramp: карты, фонды и лимиты расходов, транзакции, возмещения, счета к оплате, поставщиков, чеки, выписки, счета главной книги и пользователей. OAuth-scopes только для чтения; он не может отправлять или утверждать платежи. Блокировка карты и заметка необязательны и по умолчанию выключены.

Предварительные требования

Полные инструкции по настройке встроены в коннектор (видны в магазине при выборе коннектора). Требуемые переменные окружения:

RAMP_CLIENT_ID, RAMP_CLIENT_SECRET

Шаг 1 — Получите учётные данные

Он не может переводить деньги и ничего не утверждает, и это сделано намеренно. У коннектора нет инструмента для оплаты счетов, выплаты возмещений, переводов, выпуска карт или изменения лимитов, даже выключенного, и он не может утвердить счёт, возмещение или транзакцию. Финансовый отдел может спрашивать ИИ о расходах, не давая ему возможности платить.

1. Войдите в https://app.ramp.com как admin или business owner и откройте Company, затем Developer. Нажмите Create New App, дайте приложению имя (например, AnythingMCP) и примите условия.
2. В разделе Grant types добавьте Client Credentials.
3. В разделе Scopes нажмите Configure allowed scopes и разрешите все эти scopes только для чтения: business:read, users:read, departments:read, locations:read, entities:read, cards:read, funds:read, spend_programs:read, transactions:read, reimbursements:read, bills:read, vendors:read, receipts:read, accounting:read, statements:read. Коннектор запрашивает их все при получении токена, поэтому каждый должен быть разрешён в приложении; если какого-то нет, Ramp отказывает в токене с ошибкой invalid_scope.
4. Скопируйте Client ID в RAMP_CLIENT_ID, а Client Secret в RAMP_CLIENT_SECRET и установите коннектор. AnythingMCP получает access token (действует 10 дней) и обновляет его сам.
5. Проверьте настройку с помощью ramp_get_business: он показывает название компании и включены ли возмещения.

Никогда не разрешайте этому приложению: bills:write, reimbursements:write, cards:read_vault, limits:write. Со scopes для чтения, перечисленными выше, токен ничего не может изменить в Ramp.

Выключены при установке: ramp_lock_card и ramp_unlock_card (приостанавливают потерянную карту и снимают приостановку) и ramp_update_transaction_memo (задаёт заметку длиной до 255 символов и заменяет прежнюю). Чтобы ими пользоваться, разрешите cards:write или memos:write в приложении Ramp, добавьте тот же scope в список scopes в настройках OAuth коннектора и включите инструмент. ИИ показывает название карты и последние четыре цифры или транзакцию и новую заметку и ждёт вашего согласия. Scope cards:write в Ramp позволил бы программе ещё и выпускать карты; у этого коннектора такого инструмента нет.

Финансовые данные конфиденциальны: остатки, транзакции, счета, возмещения, карты и данные сотрудников являются конфиденциальной информацией компании. Делитесь MCP-сервером только с теми, кому разрешено их видеть; ИИ читает только то, о чём вы просите. Полные номера карт и CVC никогда не возвращаются (хранилище карт Ramp не используется), а банковские реквизиты юрлиц и поставщиков и налоговые номера поставщиков не передаются.

Что он читает: данные и баланс компании (лимит по картам, доступный лимит, остаток по выписке и даты выставления); пользователей, отделы, офисы и юрлица; физические и виртуальные карты; фонды (лимиты расходов) с остатком и ограничениями, а также spend programs; карточные транзакции с продавцом, категорией, заметкой, чеками и статусом синхронизации с бухгалтерией, где requires_memo находит те, у которых ещё нет заметки; возмещения личных расходов и пробега; счета из Bill Pay со статусом утверждения, сроком и датой оплаты; поставщиков с суммами расходов; чеки со временной ссылкой на скачивание и, по запросу, суммами, которые Ramp распознал в них; счета главной книги, синхронизированные из вашей бухгалтерской системы; и выписки по картам со временной ссылкой на PDF.

Суммы: сумма транзакции указана простым числом в долларах (90.0), а объекты сумм указаны в центах (9000 означает 90,00 USD). ИИ пересчитывает их.

Песочница: для приложения из песочницы Ramp замените базовый URL коннектора на https://demo-api.ramp.com/developer/v1, а URL токена на https://demo-api.ramp.com/developer/v1/token. Учётные данные для боевой среды и песочницы разные.

Ограничение запросов: 200 запросов за 10 секунд с одного IP-адреса; 429 означает, что нужно подождать несколько секунд.

Частые ошибки: нет access token: неверный client ID или secret, не добавлен Client Credentials или в приложении не разрешён какой-то scope (invalid_scope). 403: у токена нет scope этого инструмента. 404 с DEVELOPER_7002: Ramp не знает этот токен, например приложение из песочницы используется с боевой средой; здесь Ramp отвечает 404 вместо 401. Любой другой 404: такого id нет.

Коннектор не оплачивает счета и возмещения, не переводит деньги, не выпускает и не закрывает карты, не меняет фонды и лимиты, ничего не утверждает, не загружает чеки и не управляет пользователями, поставщиками и настройками бухгалтерии.

Шаг 2 — Установите адаптер

curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d

Шаг 3 — Добавьте коннектор в Gemini

URL вашего сервера: в AnythingMCP откройте MCP Servers → сервер, на котором находится этот коннектор, и скопируйте его URL (https://cloud.anythingmcp.com/mcp/…). Используйте его везде, где в этом руководстве указано YOUR_SERVER_ID.

Gemini CLI читает MCP-серверы из ~/.gemini/settings.json (в Windows: %USERPROFILE%\.gemini\settings.json). Добавь:

{
  "mcpServers": {
    "anythingmcp": {
      "httpUrl": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
      "headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
    }
  }
}

1. Создай MCP API-ключ в AnythingMCP в разделе MCP Servers → твой сервер → API keys и вставь его вместо YOUR_MCP_API_KEY.
2. Сохрани файл и перезапусти gemini.
3. Выполни /mcp в Gemini CLI (или gemini mcp list в терминале): anythingmcp должен отображаться как подключённый.
4. Начинай писать промпты: Gemini CLI теперь может вызывать инструменты Ramp.

Доступные инструменты

Примеры запросов

• «У каких карточных транзакций прошлой недели ещё нет заметки или чека? Покажи владельца карты, продавца и сумму.»
• «Какие счета нужно оплатить в ближайшие 14 дней? Покажи поставщика, сумму, срок и статус утверждения.»
• «Покажи возмещения, поданные в этом месяце и ещё не выплаченные, с группировкой по сотрудникам.»
• «У каких фондов в этом периоде осталось меньше 20 процентов лимита?»
• «Какой у нас остаток по выписке Ramp, доступный лимит по картам и дата следующего выставления?»

FAQ

Где Gemini CLI ищет MCP-серверы? В ~/.gemini/settings.json для твоего пользователя или в .gemini/settings.json внутри проекта. gemini mcp list показывает каждый сервер и статус подключения.

Следующие шаги

• Страница коннектора
• Подключить к Claude
• Подключить к ChatGPT