개요
모바일 SDK를 연동하려면 보통 첫 이벤트가 전송되기까지 문서를 읽고, 보일러플레이트 코드를 작성하고, 예외 상황을 디버깅하는 데 몇 시간이 걸립니다. Singular SDK Integration Skill을 사용하면 이 작업이 AI 코딩 어시스턴트와의 대화 한 번으로 끝납니다.
Singular MCP를 연결하고 앱을 설명하면 나머지는 어시스턴트가 처리합니다. 플랫폼과 프레임워크를 감지하고, 스스로 파악할 수 없는 것만 질문하고, 코드를 작성하고, 결과를 검증합니다. 이 모든 작업이 에디터를 벗어나지 않고 진행됩니다. 완료되면 초기화, 개인정보 보호 규정 준수(ATT, COPPA, GDPR, CCPA, LGPD), 딥링크, 수익 트래킹, 이벤트 매핑까지 모두 연결된 Singular SDK를 갖게 됩니다.
Claude, Cursor, ChatGPT(Developer Mode), Gemini CLI, VS Code Copilot 및 기타 MCP 지원 어시스턴트에서 사용할 수 있습니다.
진행 방식
Singular MCP를 연결하고 코딩 어시스턴트에서 프로젝트 폴더를 열면 SDK Integration Skill이 안내형 대화로 진행됩니다. 진행 순서는 다음과 같습니다.
-
MCP 연결: 사용하는 어시스턴트에 맞는 설정 가이드를 따라 AI 코딩 어시스턴트에 Singular MCP를 연결합니다. 설정 가이드: Singular MCP. MCP URL은
https://mcp.singular.net/mcp-server/mcp입니다(Singular 로그인으로 OAuth 인증). - 스캔: 어시스턴트가 프로젝트를 스캔하여 플랫폼, 프레임워크, 개인정보 보호 요구사항, 딥링크 설정, 수익화, 기존 분석 이벤트를 감지합니다.
- 기존 연동 확인: Singular 코드가 이미 있으면 누락된 부분 채우기, 처음부터 다시 시작, 종료 중에서 선택합니다.
- 맞춤 질문: 어시스턴트는 감지하지 못한 항목만 한 번에 하나씩 질문합니다: 플랫폼, 프레임워크, SDK 키와 시크릿을 저장할 위치, 개인정보 보호 요구사항, ATT, 딥링크, 수익, 이벤트 트래킹.
- 요약 및 확인: 코드를 작성하기 전에 어시스턴트가 계획된 연동의 전체 요약을 보여줍니다. 확인하기 전까지는 어떤 파일도 변경되지 않습니다.
- 구현: 어시스턴트가 확인된 설정에 맞는 최신 Singular 문서를 가져와 프로젝트에 코드를 작성합니다.
-
프로젝트 메모리: 어시스턴트가 에이전트 구성 파일(
CLAUDE.md,AGENTS.md또는GEMINI.md)에 Singular 섹션을 작성하고, 프레임워크용KNOWN_ISSUES.md파일을 추가합니다. - 검증: 어시스턴트가 설치, 초기화, SKAdNetwork, 이벤트, 딥링크, 수익, 개인정보 보호를 다루는 통과/실패 체크리스트를 실행합니다. 실패한 항목이 있으면 수정 방법을 제안합니다.
- "테스트 전" 체크리스트: 어시스턴트가 Android 패키지 이름 또는 iOS 번들 ID를 출력하고, 해당 앱이 Singular 계정에 등록되어 있는지 확인합니다. 등록되어 있지 않으면 앱을 실행하기 전에 Singular 플랫폼에서 앱을 생성하라는 안내가 표시됩니다.
소요 시간은? 일반적으로 약 30분이 걸립니다. 대부분은 질문 단계에서 답변을 기다리는 시간입니다.
지원되는 AI 어시스턴트
원격 MCP 서버를 지원하는 모든 AI 코딩 어시스턴트에서 SDK Integration Skill을 실행할 수 있습니다. 지원 대상은 다음과 같습니다.
- Claude / Claude Code (유료 플랜)
- Cursor
- ChatGPT (Developer Mode)
- Gemini CLI
- VS Code Copilot
- Codex 등 기타 MCP 지원 어시스턴트. Singular MCP 설정 가이드에는 이러한 어시스턴트가 포함되어 있지 않으므로, 원격 MCP 서버 추가에 관한 해당 어시스턴트의 안내를 따르세요.
지원 플랫폼
| 플랫폼 / 프레임워크 | 상태 |
|---|---|
| 네이티브 Android(Kotlin / Java) | 지원 |
| 네이티브 iOS(Swift / Objective-C) | 지원 |
| React Native(bare 및 Expo) | 지원 |
| Flutter | 지원 |
| Unity | 베타 |
| Cordova / Ionic | 베타 |
| Unreal Engine | 베타 |
스킬 지원 범위
- SDK 종속성 설치
- 앱 수명 주기의 올바른 시점에서
SingularConfig를 사용한 SDK 초기화 - SDK 키와 시크릿의 안전한 저장(하드코딩하지 않음)
- ATT 프롬프트 및
NSUserTrackingUsageDescription(iOS) - 개인정보 동의 연결: COPPA, GDPR, CCPA, LGPD
- 딥링크: Universal Links, App Links, 디퍼드 딥링크, Singular Link 콜백
- IAP 수익 및 SDK 기반 구독 수익
- Singular 표준 이벤트 또는 커스텀 이벤트에 매핑된 이벤트 트래킹
- 사용자 ID(앱에 로그인 흐름이 있는 경우)
FAQ
네. 스킬이 기존 Singular 코드를 감지하면 누락된 부분을 채울지, 처음부터 다시 시작할지, 아무것도 하지 않을지 묻습니다. 부분 연동에서도 동작하도록 설계되었습니다.
네. 일반적인 방식은 대부분의 이벤트를 S2S로 전송하고, 초기화, 개인정보 보호 규정 준수, 딥링크, 일부 이벤트에는 SDK Integration Skill을 사용하는 것입니다. 혼합 구성이 완전히 지원됩니다.
스킬은 질문 단계에서 SDK 키와 시크릿을 저장할 위치를 묻습니다. 자격 증명을 소스 파일에 하드코딩하지 않습니다. 일반적인 방식으로는 환경 변수, 빌드 구성 파일, 플랫폼별 시크릿(예: Expo의 EAS 시크릿)이 있습니다.
네. 진행 방식의 5단계에서 파일이 수정되기 전에 구현될 내용의 전체 요약을 보여줍니다. 어시스턴트가 코드를 작성하기 전에 반드시 확인해야 합니다.
직접 지원되지는 않습니다. 스킬은 SDK 기반 IAP 수익과 표준 구독 이벤트를 처리합니다. 다음과 같은 서드파티 벤더와의 연동은 구성하지 않습니다: RevenueCat,Adapty,Superwall. 또한 서버 간(S2S) 구독 흐름이나 광고 수익화 수익 어트리뷰션도 설정하지 않습니다.
이러한 항목은 관련 Singular 문서를 참조하세요.
- 구독 이벤트 트래킹 구현 가이드: SDK, S2S, 서드파티 옵션을 다룹니다
- 광고 수익 어트리뷰션 FAQ 및 트러블슈팅
- 광고 수익화 분석 FAQ
- Server-to-Server - 기본 사항
다음 기능은 SDK Integration Skill의 범위를 벗어납니다. 각 항목은 관련 Singular 문서로 연결됩니다.
- 리퍼러 쇼트 링크: Android, iOS, React Native, Flutter, Unity, Cordova, Unreal Engine. 서버에서 쇼트 링크를 생성하려면 다음을 참조하세요: 동적 쇼트 링크 및 추천 추적.
- 글로벌 속성: Android, iOS, React Native, Flutter, Unity, Cordova
세션 중에 이러한 주제에 대해 질문하면 스킬이 관련 문서를 안내합니다.
베타 플랫폼의 경우 어시스턴트는 사전 검증된 전용 참조 파일 대신 최신 Singular 도움말 센터 문서를 사용합니다. 대부분의 경우 연동이 정상적으로 작동하지만, 병합하거나 프로덕션에 배포하기 전에 생성된 코드, 특히 diff를 꼼꼼히 검토하세요.
어시스턴트가 검증 체크리스트(설치, 초기화, SKAdNetwork, 이벤트, 딥링크, 수익, 개인정보 보호)를 실행하고 실패 항목에 대한 수정 방법을 제안합니다. 또한 프로젝트의 에이전트 구성 파일에 Singular 섹션을 작성하여 이후 세션에서도 연동에 관한 맥락이 유지되도록 합니다.