Jak dodać serwer MCP RevenueCat do Claude Code

RevenueCat udostępnia hostowany serwer MCP pod adresem https://mcp.revenuecat.ai/mcp, a Claude Code zaczyna z nim pracować po jednej komendzie. Są dwa sposoby podłączenia: oficjalny plugin albo sam serwer. Poniżej oba, w skrócie. Używam go w Council, a cały setup razem z Supabase i Vercel opisałem we wpisie o trzech serwerach.

Opcja 1: plugin RevenueCat

Tę drogę dokumentacja RevenueCat zaleca dla Claude Code. Plugin rejestruje serwer MCP i dokłada do niego skille: integrację SDK, budowę paywalla, diagnozę pustych offerings.

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

Narzędzia zainstalowane w ten sposób nazywają się mcp__plugin_RevenueCat_RevenueCat__<tool>. Ten prefiks przyda się przy regułach uprawnień.

Opcja 2: sam hostowany serwer MCP

Jeśli potrzebujesz tylko narzędzi, bez skilli:

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

Lokalnie nic się nie instaluje. Serwer jest zdalny, a Claude Code łączy się z nim po HTTP.

OAuth czy klucz API

OAuth jest domyślny i to jego zaleca RevenueCat. Przy pierwszym użyciu serwera otwiera się przeglądarka: logujesz się do RevenueCat i przyznajesz dostęp. Komenda /mcp w Claude Code uruchamia logowanie ręcznie i pokazuje stan połączenia. Nie ma klucza do przechowywania.

Tajny klucz API v2 działa wszędzie, także w klientach bez obsługi OAuth. Utwórz go w sekcji API Keys w panelu RevenueCat i przekaż w nagłówku:

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

Przy kluczu liczą się trzy rzeczy:

• Świadomie wybierz uprawnienia. Klucz tylko do odczytu wystarczy, żeby przeglądać produkty, offerings i metryki. Tworzenie i zmiany wymagają klucza z prawem zapisu.
• Załóż osobny klucz dla MCP. Można go unieważnić bez ruszania tego, którego używa backend.
• Trzymaj go poza repozytorium. Nie dodawaj serwera z --scope project, jeśli komenda zawiera klucz: ten zakres zapisuje .mcp.json, który z założenia trafia do commita.

Sprawdź, czy działa

Poproś o coś, co tylko czyta:

Wypisz moje projekty w RevenueCat.

Claude Code powinien wywołać list-projects i zwrócić nazwy projektów. Jeśli odpowiada z pamięci, serwer nie jest podłączony: /mcp pokaże dlaczego.

Co potrafi

Serwer obejmuje większość panelu. Grupy, po które sięgam najczęściej:

Obszar	Przykładowe narzędzia
Produkty i ceny	list-products, create-product, get-product-store-state
Entitlements	create-entitlement, attach-products-to-entitlement
Offerings i pakiety	create-offering, create-packages, attach-products-to-package
Klienci	get-customer, list-subscriptions
Metryki	get-overview-metrics, get-chart-data

Są też narzędzia do paywalli, eksperymentów, targetowania, wirtualnych walut i webhooków.

W Council najbardziej opłaciła się konfiguracja katalogu. Zakupy w aplikacji wymagają produktów, entitlements, offerings i pakietów, tworzonych we właściwej kolejności i wskazujących na siebie nawzajem. Z podłączonym serwerem to była jedna prośba: utwórz entitlement pro, podepnij produkt miesięczny i roczny, włóż je do domyślnego offeringu. Claude Code wykonał wywołania, a potem odczytał stan, żeby potwierdzić wynik.

Odczyt na allowliście, zapis niech pyta

Narzędzia MCP przechodzą przez zwykły system uprawnień Claude Code. W .claude/settings.json Council nieszkodliwe narzędzia do odczytu działają bez pytania:

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

Wszystko, co tworzy, zmienia albo wysyła do sklepu, nadal pyta. Przy samym serwerze z opcji 2 nazwy mają postać mcp__revenuecat__<tool>.

Jeśli budujesz produkt z subskrypcjami na webie i w aplikacji mobilnej i chcesz go dowieźć od zera do produkcji, odezwij się.