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

AI 辅助集成设置

AppCoins MCP 服务器将您的 AI 助手连接到实时的 SDK 文档和集成工具。配置完成后,您的助手可以读取您的代码库,并使用准确的、针对项目的上下文,实现完整的 AppCoins 计费集成,或将其添加到现有计费方案旁。

📘
您的代码永远不会离开您的计算机。MCP 服务器只为您本地的 AI 助手提供文档和工具。任何 Aptoide 服务都不会接收您的源代码。

连接您的 AI 助手

在编辑器的 MCP 配置中添加一个条目,然后重启。

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 共用一个二进制文件。
  • 独立构建 — 您的 main 分支保持现有计费不变。aptoide 分支使用 AppCoins 作为唯一的计费路径。两个二进制文件,无需运行时检查。
  • 新应用 — 从一开始就将 AppCoins 作为唯一的计费路径。

随后,智能体会结合分步指南和针对您具体方案的迁移指南来实现集成,处理 Xcode 功能配置、每个入口点的 SDK 初始化、交易完成,以及启动时的未完成交易恢复。

有关各策略的完整比较,请参阅 iOS 计费集成策略


诊断您的集成

/appcoins-diagnose

运行此命令之前,请先在编辑器中打开您的项目。

智能体会根据已知的故障点审核您的集成:Keychain Sharing 配置、URL scheme、MKSellsDigitalGoods、每个入口点的 SDK 初始化、未完成交易的处理等。它会按文件和行号报告问题,并提议自动修复。

请在发布前,或在可能丢失了功能配置的 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。