メインコンテンツまでスキップ

AI 支援による連携セットアップ

AppCoins MCP サーバーは、AI アシスタントを最新の SDK ドキュメントと連携ツールに接続します。設定が完了すると、アシスタントはコードベースを読み取り、正確でプロジェクト固有のコンテキストを用いて、AppCoins 課金の完全な連携を実装したり、既存の課金と並行して追加したりできます。

📘
お客様のコードがマシンの外に出ることはありません。MCP サーバーは、ローカルの AI アシスタントにドキュメントとツールを提供するだけです。Aptoide のいかなるサービスもお客様のソースコードを受け取ることはありません。

AI アシスタントの接続

エディターの MCP 設定にエントリを 1 つ追加し、再起動します。

Claude Code

~/.claude.json (またはプロジェクトレベルの .claude/claude.json):

{
"mcpServers": {
"appcoins": {
"type": "http",
"url": "https://ios-sdk.aptoide.com/mcp"
}
}
}

Codex

~/.codex/config.toml:

[mcp_servers.appcoins]
enabled = true
url = "https://ios-sdk.aptoide.com/mcp"

Cursor

~/.cursor/mcp.json:

{
"mcpServers": {
"appcoins": {
"type": "http",
"url": "https://ios-sdk.aptoide.com/mcp"
}
}
}

GitHub Copilot (VS Code)

プロジェクトルートの .vscode/mcp.json:

{
"servers": {
"appcoins": {
"type": "http",
"url": "https://ios-sdk.aptoide.com/mcp"
}
}
}

連携の実行

/appcoins-integrate

このコマンドを実行する前に、エディターでプロジェクトを開いてください。エージェントはソースファイルをスキャンして現在のセットアップを把握します。

エージェントは既存の課金コードを読み取り、プラットフォーム (Swift または Unity) と課金の構成 (StoreKit 1/2、RevenueCat、Adapty、Unity IAP、旧バージョンの AppCoins SDK、または未導入) を特定します。Unity プロジェクトの場合は manifest.json を確認して Unity IAP のバージョンを判別します。v4 から v5 へのアップグレードパスは、既存の v5 プロジェクトに AppCoins を追加する場合とは異なるためです。

📘
すでに StoreKit 2 または Unity IAP v5 を使用していますか? AppCoins Swift SDK は意図的に StoreKit 2 API を踏襲しており、ProductTransactionVerificationResult は既存のものに直接対応します。Unity プラグインは Unity IAP v5 のカスタムストアプロバイダーとして構築されているため、既存のイベント、商品定義、確認ロジックがそのまま AppCoins 連携になります。エージェントはプロジェクトを読み取った後にこれを確認しますが、いずれの場合も、完了までの道のりは想像以上に短いはずです。

十分なコンテキストを得ると、エージェントはどの配信戦略を希望するかを尋ねます。

  • 単一ビルド — AppCoins が既存の課金と並行して動作します。isAvailable() により、Aptoide 経由で配信されたビルドでは AppCoins にルーティングされ、それ以外はすべて既存の課金が処理します。App Store と Aptoide の両方に対して 1 つのバイナリです。
  • 別ビルドmain ブランチでは既存の課金をそのまま維持します。aptoide ブランチでは AppCoins を唯一の課金パスとして使用します。2 つのバイナリで、実行時チェックは不要です。
  • 新規アプリ — 最初から AppCoins を唯一の課金パスとして使用します。

その後、エージェントはステップバイステップガイドと、お客様の構成に応じた移行ガイドの両方を用いて連携を実装し、Xcode の Capability 設定、すべてのエントリポイントでの SDK 初期化、トランザクションの完了処理、起動時の未完了トランザクションの回復を処理します。

各戦略の詳細な比較については、iOS 課金の連携戦略を参照してください。


連携の診断

/appcoins-diagnose

このコマンドを実行する前に、エディターでプロジェクトを開いてください。

エージェントは、既知の障害ポイントに対して連携を監査します。Keychain Sharing の設定、URL スキーム、MKSellsDigitalGoods、すべてのエントリポイントでの SDK 初期化、未完了トランザクションの処理などです。問題はファイルと行番号ごとに報告され、自動修正の提案が行われます。

リリース前や、Capability が失われた可能性のある Xcode のアップグレード後に実行してください。


質問する

/appcoins-help how do I handle a notEntitled error?
/appcoins-help what is the difference between single build and separate builds?
/appcoins-help what do I need to submit to Aptoide Connect?
/appcoins-help how do I recover unfinished transactions on app launch?

エージェントは最新の SDK ドキュメントに基づいて回答します。回答の範囲は AppCoins API に限定されます。