Singular MCPによるAI SDK統合 – ヘルプセンター

概要

モバイルSDKの統合では通常、最初のイベントが送信されるまでに、ドキュメントを読み、定型コードを書き、エッジケースをデバッグするのに何時間もかかります。Singular SDK Integration Skillを使えば、その作業がAIコーディングアシスタントとの1回の会話で完了します。

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に接続: お使いのアシスタント向けの設定ガイドに従って、Singular MCPをAIコーディングアシスタントに接続します。設定ガイド: Singular MCP。MCP URLは https://mcp.singular.net/mcp-server/mcp です（SingularのログインでOAuth認証）。
スキャン: アシスタントがプロジェクトをスキャンし、プラットフォーム、フレームワーク、プライバシー要件、ディープリンクの設定、マネタイズ、既存の分析イベントを検出します。
既存の統合の確認: Singularのコードがすでにある場合は、不足部分を補う、最初からやり直す、終了する、のいずれかを選びます。
絞り込んだ質問: アシスタントは検出できなかった項目だけを1つずつ質問します。プラットフォーム、フレームワーク、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（アプリにサインインのフローがある場合）

よくある質問

Singularの統合が一部だけ済んでいる場合でも使えますか?

はい。既存のSingularコードを検出すると、不足部分を補うか、最初からやり直すか、何もしないかを確認します。部分的な統合にも対応するよう設計されています。

SDK統合をサーバー間（S2S）の設定と併用できますか?

はい。よくあるパターンは、ほとんどのイベントをS2Sで送信し、初期化、プライバシーコンプライアンス、ディープリンク、一部のイベントにSDK Integration Skillを使う方法です。混在構成も完全にサポートされています。

アシスタントはどのSDKキーを使えばよいかをどう判断しますか?

スキルは質問フェーズで、SDKキーとシークレットの保存場所を尋ねます。認証情報をソースファイルにハードコードすることはありません。一般的なパターンには、環境変数、ビルド設定ファイル、プラットフォーム固有のシークレット（例: ExpoのEASシークレット）があります。

統合コードはファイルに書き込まれる前に確認できますか?

はい。フローのステップ5で、ファイルを変更する前に実装内容の全体概要が表示されます。アシスタントがコードを書く前に、必ず確認が必要です。

サードパーティのサブスクリプションベンダーや広告マネタイズベンダーとの連携はサポートされていますか?

直接はサポートしていません。スキルが扱うのは、SDKベースのIAP収益と標準のサブスクリプションイベントです。次のようなサードパーティベンダーとの連携は設定しません: RevenueCat、Adapty、Superwall。また、サーバー間（S2S）のサブスクリプションフローや、広告マネタイズ収益のアトリビューションも設定しません。

これらについては、関連するSingularのドキュメントを参照してください。

サブスクリプションイベントトラッキング実装ガイド: SDK、S2S、サードパーティの選択肢を説明しています
広告収益の帰属FAQとトラブルシューティング
Ad Monetization Analytics FAQ
Server-to-Server - 基礎

このスキルの対象外となるものは、ほかに何がありますか?

次の機能はSDK Integration Skillの対象外です。各項目から関連するSingularのドキュメントに移動できます。

リファラーショートリンク: Android、iOS、React Native、Flutter、Unity、Cordova、Unreal Engine。サーバーからショートリンクを作成する場合は、ダイナミック・ショートリンクとリファラルトラッキングを参照してください。
グローバルプロパティ: Android、iOS、React Native、Flutter、Unity、Cordova

セッション中にこれらのトピックについて質問すると、スキルが関連ドキュメントを案内します。

自分のプラットフォームがベータ（Unity、Cordova/Ionic、Unreal Engine）と表示されています。どういう意味ですか?

ベータのプラットフォームでは、アシスタントは事前検証済みの専用リファレンスファイルではなく、最新のSingularヘルプセンターのドキュメントを使用します。ほとんどの場合は問題なく統合できますが、マージや本番環境へのリリースの前に、生成されたコード、特に差分を慎重に確認してください。

統合コードが書き込まれた後はどうなりますか?

アシスタントが検証チェックリスト（インストール、初期化、SKAdNetwork、イベント、ディープリンク、収益、プライバシー）を実行し、失敗した項目の修正を提案します。また、プロジェクトのエージェント設定ファイルにSingularのセクションを書き込み、以降のセッションでも統合に関する文脈が引き継がれるようにします。