AI Toolkit은 GitHub 저장소 하나에서 플러그인 마켓플레이스 형태로 배포됩니다. 바로 RevenueCat/ai-toolkit입니다. 여기에는 두 개의 플러그인이 함께 제공됩니다.

RevenueCat 플러그인

대부분의 사용자가 원하는 플러그인입니다. 두 가지를 하나로 합쳐 놓았습니다.

RevenueCat MCP 서버는 mcp.revenuecat.ai에서 호스팅되는 Model Context Protocol 서버로, 에이전트가 RevenueCat 계정에 인증된 상태로 접근하게 해 줍니다. 이를 통해 에이전트는 프로젝트, 앱, 프로덕트, 엔타이틀먼트, 오퍼링, 패키지를 생성하고 살펴보며, 분석 데이터를 조회할 수 있습니다.

크로스플랫폼 연동 스킬은 엄선되고 버전이 관리되는 지침으로, iOS, Android, Kotlin Multiplatform, Flutter, React Native에서 흔히 하는 RevenueCat 작업을 올바른 방식으로 처리하도록 에이전트를 가르칩니다.

• integrate-revenuecat: 대시보드 쪽은 MCP로 설정하고 앱에는 Purchases SDK를 설치하고 구성하는, 처음부터 끝까지의 연동입니다.
• create-revenuecat-project: 앱, 프로덕트, 엔타이틀먼트, 오퍼링, 패키지를 올바른 순서로 만들어 완전한 프로젝트를 처음부터 설정합니다.
• revenuecat-paywall: RevenueCatUI SDK로 페이월을 표시합니다.
• revenuecat-purchase-flow: 구매, 오류 처리, 복원을 구현합니다.
• revenuecat-entitlements-gate: 프리미엄 기능을 엔타이틀먼트로 잠급니다.
• revenuecat-identify-user: RevenueCat의 사용자 식별을 앱의 인증 시스템과 연결합니다.
• revenuecat-customer-center: 셀프서비스 구독 관리 UI를 추가합니다.
• revenuecat-testing-setup: 실제 돈을 쓰지 않고 테스트할 수 있도록 샌드박스/테스트 환경을 설정합니다.
• revenuecat-troubleshoot: 대시보드 구성과 SDK 디버그 로그로 연동 문제를 진단합니다.
• revenuecat-migrate: 순수 StoreKit이나 Play Billing에서, 또는 SDK 메이저 버전 간에 마이그레이션합니다.
• revenuecat-status: 프로젝트 구성을 빠르게 훑어봅니다.
• revenuecat-charts: 데이터, 분석, KPI에 관한 질문에 답합니다.

revenuecat-play-billing 플러그인

RevenueCat Android SDK를 위한 20개의 심층 Google Play 스킬을 담은 선택형 두 번째 플러그인입니다. Google Play 구독 생명주기를 핸드북 수준으로 다룹니다. 구매, 요금제와 가격 변경, 결제 복구, 일시 정지와 취소, 윈백(win-back), 웹훅, 보안 등을 포함합니다. 이 플러그인은 RevenueCat/play-billing-skills에서 동기화되며, 해당 저장소가 원본입니다.

팁: RevenueCat 플러그인으로 시작하세요. Android를 출시하고 Google Play 결제 동작을 핸드북 수준으로 깊이 다루고 싶다면 그 위에 revenuecat-play-billing을 추가하면 됩니다.

Claude Code는 플러그인 마켓플레이스를 기본으로 지원하므로 설치가 1분도 걸리지 않습니다. 방법은 두 가지입니다.

Claude Code 안에서

프로젝트에서 Claude Code를 실행하고 다음을 입력하세요.

/plugin

그다음 Marketplace → + Add Marketplace를 선택하고 RevenueCat/ai-toolkit을 입력하세요. 마켓플레이스가 추가되면 RevenueCat 플러그인을 선택해 설치합니다. Android를 출시하고 Google Play를 핸드북 수준으로 깊이 다루고 싶다면 revenuecat-play-billing도 함께 선택하세요.

명령줄에서

터미널이 더 편한가요? 같은 작업을 세 개의 명령으로 끝낼 수 있습니다.

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

이게 전부입니다. 플러그인이 RevenueCat MCP 서버를 등록하고 모든 스킬을 Claude에서 쓸 수 있게 해 줍니다. 설치가 잘 됐는지는 Claude Code에서 /를 입력해 확인할 수 있습니다. 명령 목록에 /revenuecat-status 같은 RevenueCat 스킬이 보일 것입니다.

Toolkit은 주요 AI 코딩 환경 전반에서 동작합니다. 아래에서 사용하는 환경을 고르세요.

OpenAI Codex CLI

codex plugin marketplace add RevenueCat/ai-toolkit

그다음 Codex를 실행하고 /plugins를 입력해 RevenueCat을 검색한 뒤 설치하세요. Codex 데스크톱 앱이라면 먼저 위의 터미널 명령을 실행하고, 앱에서 Plugins를 클릭한 다음 드롭다운에서 RevenueCat을 선택하고 플러그인 옆의 + 버튼을 클릭하세요.

Gemini CLI

gemini extensions install https://github.com/RevenueCat/ai-toolkit

Gemini에는 마켓플레이스가 없고 저장소당 확장 프로그램 하나만 지원하므로, RevenueCat 플러그인만 설치됩니다. revenuecat-play-billing 플러그인은 Claude Code, Cursor, Codex, VS Code에서 사용할 수 있습니다.

Visual Studio Code

VS Code에서는 현재 플러그인 마켓플레이스 지원이 베타 단계입니다. 공식 안내를 따라 RevenueCat/ai-toolkit을 플러그인 마켓플레이스로 추가한 다음, 마켓플레이스에서 플러그인을 설치하세요.

Cursor

마켓플레이스 지원은 곧 제공될 예정입니다. 그때까지는 RevenueCat MCP 서버를 직접 추가해 대시보드 도구를 사용할 수 있습니다.

그 밖의 에이전트

플러그인을 지원하지 않는 에이전트형 코딩 환경이라면 npx로 스킬만 설치할 수 있습니다.

npx skills add RevenueCat/ai-toolkit

참고: 이 방법은 스킬만 설치하고 MCP 서버는 설치하지 않습니다. MCP 설정 안내를 따라 환경에 MCP를 직접 구성하세요.

MCP 서버는 여러분의 RevenueCat 계정을 대신해 동작해야 하므로 브라우저에서 OAuth로 인증합니다. 여기저기 복사해 옮길 API 키가 없습니다. 접근 권한은 RevenueCat 계정 권한에 따라 부여되며 모든 프로젝트에 적용됩니다.

인증 프롬프트가 언제 나타나는지는 환경에 따라 다릅니다.

• 즉시: 어떤 환경은 플러그인을 설치하자마자 인증을 요청합니다.
• 첫 사용 시: 어떤 환경은 에이전트가 RevenueCat 도구를 처음 호출할 때까지 기다립니다.
• 수동으로: Gemini CLI에서는 /mcp auth revenuecat를 실행해 직접 인증을 시작합니다.

어느 경우든 흐름은 같습니다. 브라우저가 열리고, (아직 로그인하지 않았다면) RevenueCat에 로그인한 뒤 접근 요청을 승인합니다. 이 과정이 끝나면 에이전트가 연결됩니다.

전체 과정이 잘 동작하는지 빠르게 확인하려면 프로젝트 상태를 물어보세요.

You: What is the status of my RevenueCat project?

Agent: RevenueCat Project Status
       ============================
       Project: Fitness App (proj123)

       Apps: 2 (iOS, Android)
       Products: 4
       Entitlements: 2
       Offerings: 1

       ✅ Configuration looks healthy!

이와 같은 요약이 보이면 인증에 성공했고 MCP 연결이 살아 있는 것입니다. 아직 프로젝트가 없어도 걱정하지 마세요. 다음 단계에서 하나 만들어 봅니다.

참고: Toolkit은 실제 RevenueCat 구성을 읽고 수정할 수 있습니다. 코드를 다룰 때와 똑같이, 변경을 승인하기 전에 에이전트가 제안한 내용을 검토하세요.

Toolkit의 진가가 드러나는 부분입니다. 기존 방식으로 RevenueCat을 설정하려면 대시보드를 클릭해 가며 앱, 프로덕트, 엔타이틀먼트, 오퍼링, 패키지를 (올바른 순서로) 만든 다음 코드에서 SDK를 연결해야 했습니다. Toolkit을 설치하면 원하는 결과만 설명하고 나머지 양쪽 작업은 에이전트가 처리합니다.

대시보드 구성 만들기

프로젝트에서 다음과 같은 프롬프트로 시작하세요.

You: Set up RevenueCat for my fitness app

Agent: I'll help you set up RevenueCat. What platforms are you building for?

You: iOS and Android

Agent: Creating your iOS app... [creates app]
       Creating your Android app... [creates app]
       What subscription tiers do you want? (e.g., monthly, annual)

You: Monthly at $9.99 and annual at $79.99

Agent: [Creates products, entitlements, offering, packages]

       Setup complete! Here are your API keys:
       iOS: appl_xxxxx
       Android: goog_xxxxx

이때 뒤에서는 create-revenuecat-project 스킬이 MCP 서버를 움직여 모든 것을 올바른 의존성 순서로 만듭니다. 먼저 앱, 그다음 프로덕트, 이어서 그 프로덕트에 연결된 엔타이틀먼트(예: premium), 마지막으로 월간과 연간 패키지를 담은 오퍼링입니다. 이들은 RevenueCat 대시보드에 실제로 만들어지는 리소스입니다. 브라우저에서 대시보드를 열어 보면 확인할 수 있습니다.

SDK 연동하기

이미 존재하는 앱 코드베이스에서 작업하고 있다면, 처음부터 끝까지의 연동 스킬을 대신 사용하세요. 이 스킬은 대시보드 쪽 작업을 처리하는 것은 물론 프로젝트에 Purchases SDK를 설치하고 구성합니다.

You: Integrate RevenueCat into this app

integrate-revenuecat 스킬은 플랫폼(iOS, Android, KMP, Flutter, React Native)을 감지하고, SDK 의존성을 추가하고, MCP를 통해 프로젝트에서 올바른 공개 API 키를 가져온 뒤, 모범 사례에 따라 앱 실행 시점에 Purchases를 구성합니다. 이는 이 사이트의 플랫폼별 코드랩에서 가르치는 것과 동일한 패턴입니다.

팁: 작업을 마쳤다면 /revenuecat-status를 실행하거나 그냥 "what's my project status?"라고 물어서 앱, 프로덕트, 엔타이틀먼트, 오퍼링이 모두 제자리에 있는지 확인하세요.

프로젝트를 구성하고 나면, 연동 스킬이 각 수익화 기능을 올바른 방식으로 만들도록 에이전트를 돕습니다. 스킬을 이름으로 직접 호출할 필요는 없습니다. 요청 내용과 맞으면 자동으로 활성화됩니다. 각 스킬을 불러오는 프롬프트는 다음과 같습니다.

페이월 보여 주기

You: Gate the premium analytics screen behind a paywall

revenuecat-paywall 스킬은 RevenueCatUI SDK를 연결합니다. iOS에서는 PaywallView, Android에서는 PaywallActivity나 페이월 컴포저블, 그리고 필요한 곳에서는 presentPaywallIfNeeded를 사용합니다. 대시보드의 Paywall Editor에서 구성한 페이월이 그대로 쓰입니다.

구매, 복원, 엔타이틀먼트 게이트

"implement the purchase flow for the annual package, with restore"처럼 구매 로직을 요청하면 revenuecat-purchase-flow가 활성화됩니다. 이 스킬은 오퍼링을 가져오고, 패키지를 구매하고, 사용자 취소와 오류를 처리하고, 복원을 구현합니다. "only show this feature to subscribers"라고 요청하면 revenuecat-entitlements-gate가 활성화되어 CustomerInfo에서 활성 엔타이틀먼트를 확인하고 엔타이틀먼트 변화에 반응합니다.

사용자 식별과 Customer Center

RevenueCat을 인증 시스템과 연결할 때, 예를 들어 "sync RevenueCat with my Firebase Auth user on login and logout"이라고 하면 revenuecat-identify-user 스킬이 logIn/logOut과 익명 사용자에서 식별된 사용자로의 전환을 처리합니다. 그리고 "add a manage subscription screen"이라고 하면 revenuecat-customer-center가 활성화되어 셀프서비스 Customer Center UI를 넣어 줍니다.

돈을 쓰지 않고 테스트하기

You: How do I test purchases without real money?

revenuecat-testing-setup 스킬은 플랫폼별 샌드박스 설정을 에이전트에게 차근차근 안내합니다. iOS에서는 StoreKit 구성 파일과 샌드박스 계정, Android에서는 라이선스 테스터와 내부 테스트 트랙을 다루므로, 전체 구매 흐름을 안전하게 확인할 수 있습니다. (더 빠르게 시작하려면 Test Store for iOS와 Test Store for Android 코드랩을 참고하세요.)

Toolkit은 설정용으로만 쓰이는 도구가 아닙니다. 구독 비즈니스를 운영하는 일상에서도 계속 쓸모가 있습니다.

데이터에 관해 질문하기

revenuecat-charts 스킬은 에이전트를 분석 콘솔로 바꿔 줍니다. "What's my MRR?", "How did trial conversion change after the last price test?", "Show me churn for the past quarter"처럼 물어보면, 에이전트가 MCP 서버를 통해 실제 차트 데이터를 조회하고 답을 정리해 줍니다.

대화하듯 문제 해결하기

뭔가 이상할 때(오퍼링이 비어 있거나, 구매 후에도 엔타이틀먼트가 활성화되지 않거나, 페이월이 로드되지 않을 때) 증상을 설명하세요.

You: My offerings are coming back empty on Android

revenuecat-troubleshoot 스킬은 MCP를 통해 대시보드 구성을 살펴보고, SDK 디버그 로그를 훑어보고, 코드 쪽에서 흔히 놓치는 부분을 점검합니다. 문제 해결 코드랩과 같은 방법론이되, 여러분의 실제 프로젝트를 대상으로 에이전트가 직접 실행합니다.

마이그레이션과 업그레이드

이미 순수 StoreKit이나 Google Play Billing 코드가 있나요? "Migrate this app to RevenueCat"이라고 하면 revenuecat-migrate가 활성화됩니다. 이 스킬은 옵저버 모드와 SDK 메이저 버전 업그레이드(예: v4 → v5)도 다룹니다.

Google Play를 깊이 파고들기

revenuecat-play-billing을 설치했다면, 에이전트는 Google Play 구독 생명주기에 대한 핸드북 수준의 스킬 20개를 갖추게 됩니다. 구독 상태, 요금제 변경, 가격 변경, 결제 복구, 취소와 일시 정지, 윈백, 일회성 프로덕트, 웹훅, 보안 등을 다룹니다. "what happens to a subscription in grace period?"나 "how do I handle a downgrade at renewal?"라고 물으면, 답은 공개된 웹이 아니라 RevenueCat이 엄선한 Play Billing 지식에서 나옵니다.

축하합니다! RevenueCat AI Toolkit을 설치하고, 계정에 인증하고, 프롬프트 하나로 완전한 RevenueCat 프로젝트를 설정했으며, AI 코딩 에이전트를 벗어나지 않고 페이월, 구매 흐름, 엔타이틀먼트 게이트, Customer Center를 만들고 데이터를 분석하고 문제를 해결하도록 스킬이 어떻게 돕는지 배웠습니다.

Toolkit은 RevenueCat의 모범 사례를, 에이전트가 자동으로 적용하는 무언가로 바꿔 줍니다. 여러분은 흐름에 머물고, 구성과 보일러플레이트와 그동안 쌓인 노하우가 알아서 여러분에게 옵니다.

다음 단계

플랫폼별로 더 깊이 파고들려면 실습형 코드랩과 Toolkit을 함께 쓰세요. iOS, Android, Kotlin Multiplatform, Flutter, React Native 코드랩이 있습니다. MCP 서버 자체에 대해서는 MCP 문서를 참고하세요.

아래 자료로도 더 자세히 알아볼 수 있습니다.

• GitHub: RevenueCat AI Toolkit
• 문서: RevenueCat MCP Server
• GitHub: Play Billing Skills
• Product Tutorials: RevenueCat을 시작하고 200% 활용하도록 돕는 동영상 튜토리얼입니다.

이제 멋진 것을 출시하고, 번거로운 일은 에이전트에게 맡기세요! 🤖💰