Как подключить MCP-сервер RevenueCat к Claude Code

У RevenueCat есть хостируемый MCP-сервер по адресу https://mcp.revenuecat.ai/mcp, и Claude Code начинает с ним работать после одной команды. Подключить его можно двумя способами: через официальный плагин или напрямую. Ниже оба варианта, коротко. Я пользуюсь им в Council, а общий сетап вместе с Supabase и Vercel описан в статье про три сервера.

Вариант 1: плагин RevenueCat

Для Claude Code документация RevenueCat советует именно его. Плагин регистрирует MCP-сервер и добавляет поверх скиллы: интеграция SDK, сборка пейволла, разбор ситуации «offerings пустые».

claude plugins marketplace add RevenueCat/ai-toolkit
claude plugins install revenuecat

Инструменты при такой установке называются mcp__plugin_RevenueCat_RevenueCat__<tool>. Этот префикс понадобится, когда дойдёт до правил разрешений.

Вариант 2: только хостируемый MCP-сервер

Если нужны одни инструменты, без скиллов:

claude mcp add --transport http revenuecat https://mcp.revenuecat.ai/mcp

Локально ничего не ставится. Сервер удалённый, Claude Code обращается к нему по HTTP.

OAuth или API-ключ

OAuth используется по умолчанию, и RevenueCat рекомендует его. При первом обращении к серверу откроется браузер: входите в RevenueCat и выдаёте доступ. Команда /mcp внутри Claude Code запускает вход вручную и показывает состояние подключения. Хранить ключ не нужно.

Секретный ключ API v2 работает везде, в том числе в клиентах без OAuth. Создайте его в разделе API Keys в дашборде RevenueCat и передайте заголовком:

claude mcp add --transport http revenuecat https://mcp.revenuecat.ai/mcp \
  --header "Authorization: Bearer sk_..."

С ключом важны три вещи:

• Выбирайте права осознанно. Ключа только на чтение хватит, чтобы смотреть продукты, offerings и метрики. Чтобы что-то создавать или менять, нужен ключ с правом записи.
• Заведите отдельный ключ под MCP. Его можно отозвать, не трогая тот, на котором работает бэкенд.
• Не кладите его в репозиторий. Не добавляйте сервер с --scope project, если в команде есть ключ: этот scope пишет в .mcp.json, который рассчитан на коммит.

Как проверить, что всё работает

Попросите что-нибудь, что только читает:

Покажи мои проекты в RevenueCat.

Claude Code должен вызвать list-projects и вернуть названия проектов. Если он отвечает по памяти, сервер не подключён: причину покажет /mcp.

Что он умеет

Сервер покрывает большую часть дашборда. Группы, которыми я пользуюсь чаще всего:

Область	Примеры инструментов
Продукты и цены	list-products, create-product, get-product-store-state
Entitlements	create-entitlement, attach-products-to-entitlement
Offerings и пакеты	create-offering, create-packages, attach-products-to-package
Клиенты	get-customer, list-subscriptions
Метрики	get-overview-metrics, get-chart-data

Есть ещё инструменты для пейволлов, экспериментов, таргетинга, виртуальных валют и вебхуков.

В Council больше всего времени сэкономила настройка каталога. Для встроенных покупок нужны продукты, entitlements, offerings и пакеты: в правильном порядке, и каждая сущность ссылается на остальные. С подключённым сервером это один запрос: создать entitlement pro, привязать месячный и годовой продукты, положить их в default offering. Claude Code сделал вызовы и потом перечитал состояние, чтобы убедиться, что всё на месте.

Чтение разрешить, запись пусть спрашивает

MCP-инструменты проходят через обычную систему разрешений Claude Code. В .claude/settings.json у Council безобидные инструменты чтения работают без подтверждения:

{
  "permissions": {
    "allow": [
      "mcp__plugin_RevenueCat_RevenueCat__list-projects",
      "mcp__plugin_RevenueCat_RevenueCat__list-products",
      "mcp__plugin_RevenueCat_RevenueCat__get-product-store-state"
    ]
  }
}

Всё, что создаёт, меняет или отправляет в стор, по-прежнему спрашивает. Если сервер подключён напрямую, как во втором варианте, имена будут вида mcp__revenuecat__<tool>.

Если вы делаете продукт с подписками на вебе и в мобильном приложении и хотите довести его до продакшена под ключ, напишите мне.