通过 Singular MCP 进行 AI SDK 集成

关注
Avatar
Support Team
Updated

概述

集成移动 SDK 通常需要花费数小时阅读文档、编写样板代码、调试边缘情况，才能发送第一个事件。Singular SDK Integration Skill 将这些工作简化为与 AI 编程助手的一次对话。

连接 Singular MCP 并描述您的应用，其余工作由助手完成：它会检测您的平台和框架，只询问它无法自行判断的内容，编写代码并验证结果，整个过程无需离开编辑器。完成后，您将获得一个完整接入的 Singular SDK：初始化、隐私合规（ATT、COPPA、GDPR、CCPA、LGPD）、深度链接、收入追踪和事件映射。

适用于 Claude、Cursor、ChatGPT（Developer Mode）、Gemini CLI、VS Code Copilot 以及其他支持 MCP 的助手。

流程说明

连接 Singular MCP 并在编程助手中打开项目文件夹后，SDK Integration Skill 会以引导式对话的方式运行。流程如下：

  1. 连接 MCP： 按照您所用助手的设置指南，将 Singular MCP 连接到您的 AI 编程助手。设置指南：Singular MCP。MCP URL 为 https://mcp.singular.net/mcp-server/mcp（使用您的 Singular 登录进行 OAuth 认证）。
  2. 扫描： 助手会扫描您的项目，检测平台、框架、隐私要求、深度链接设置、变现方式以及现有的分析事件。
  3. 现有集成检查： 如果项目中已有 Singular 代码，您可以选择补全缺失部分、从头开始或退出。
  4. 针对性提问： 助手只询问它无法检测到的内容，每次一个问题：平台、框架、SDK 密钥和密钥密文的存储位置、隐私要求、ATT、深度链接、收入以及事件追踪。
  5. 摘要与确认： 在编写任何代码之前，助手会向您展示计划集成的完整摘要。在您确认之前，不会更改任何文件。
  6. 实施： 助手会获取与您确认的设置对应的最新 Singular 文档，并将代码写入您的项目。
  7. 项目记忆： 助手会在您的智能体配置文件（CLAUDE.md、AGENTS.md 或 GEMINI.md）中写入一个 Singular 部分，并为您的框架添加一个 KNOWN_ISSUES.md 文件。
  8. 验证： 助手会运行一份通过/失败检查清单，涵盖安装、初始化、SKAdNetwork、事件、深度链接、收入和隐私。如有任何项目失败，助手会提出修复建议。
  9. “测试前”检查清单： 助手会显示您的 Android 包名或 iOS Bundle ID，并检查该应用是否已在您的 Singular 账户中注册。如果尚未注册，系统会提示您在运行应用之前先在 Singular 平台中创建该应用。

需要多长时间？ 一次典型运行大约需要 30 分钟，其中大部分时间是在提问步骤中等待您的回答。

支持的 AI 助手

任何支持远程 MCP 服务器的 AI 编程助手都可以运行 SDK Integration Skill，包括：

  • Claude / Claude Code（付费套餐）
  • Cursor
  • ChatGPT（Developer Mode）
  • Gemini CLI
  • VS Code Copilot
  • 其他支持 MCP 的助手，例如 Codex。Singular MCP 设置指南未涵盖这些助手，请按照您所用助手自身的说明添加远程 MCP 服务器。

支持的平台

平台 / 框架 状态
原生 Android（Kotlin / Java） 支持
原生 iOS（Swift / Objective-C） 支持
React Native（bare 和 Expo） 支持
Flutter 支持
Unity Beta
Cordova / Ionic Beta
Unreal Engine Beta

Skill 涵盖的内容

  • 安装 SDK 依赖项
  • 在应用生命周期的正确时间点使用 SingularConfig 初始化 SDK
  • 安全存储 SDK 密钥和密钥密文（绝不硬编码）
  • ATT 提示和 NSUserTrackingUsageDescription（iOS）
  • 隐私同意接入：COPPA、GDPR、CCPA、LGPD
  • 深度链接：Universal Links、App Links、延迟深度链接、Singular Link 回调
  • IAP 收入和基于 SDK 的订阅收入
  • 映射到 Singular 标准事件或自定义事件的事件追踪
  • 用户 ID（如果您的应用有登录流程）

常见问题

如果我已有部分完成的 Singular 集成，还能使用吗？

可以。当 Skill 检测到现有的 Singular 代码时，会询问您是要补全缺失部分、重新开始，还是不做任何操作。它专为部分集成的情况而设计。

可以将 SDK 集成与服务器到服务器（S2S）设置一起使用吗？

可以。常见做法是通过 S2S 发送大部分事件，并使用 SDK Integration Skill 处理初始化、隐私合规、深度链接和部分选定事件。完全支持混合设置。

助手如何知道要使用哪个 SDK 密钥？

Skill 会在提问阶段询问您将 SDK 密钥和密钥密文存储在何处。它绝不会将凭据硬编码到源文件中。常见做法包括环境变量、构建配置文件以及平台特定的密钥存储（例如 Expo 的 EAS secrets）。

集成代码写入我的文件之前会经过审核吗？

会。流程的第 5 步会在修改任何文件之前，向您展示将要实施内容的完整摘要。助手编写任何代码之前，您必须先确认。

是否支持与第三方订阅和广告变现供应商的集成？

不直接支持。Skill 处理基于 SDK 的 IAP 收入和标准订阅事件，但不会配置与第三方供应商的集成，例如 RevenueCat、Adapty或 Superwall，也不会设置服务器到服务器（S2S）订阅流程或广告变现收入归因。

如需了解这些内容，请参阅相关的 Singular 文档：

还有哪些内容不在此 Skill 的范围内？

以下功能不在 SDK Integration Skill 的范围内。每一项都链接到相关的 Singular 文档：

如果您在会话中询问这些主题，Skill 会为您指出相关文档。

我的平台显示为 Beta（Unity、Cordova/Ionic、Unreal Engine），这是什么意思？

对于 Beta 平台，助手会依据最新的 Singular 帮助中心文档，而不是专门的预先验证参考文件。大多数情况下集成可以正常工作，但在合并或发布到生产环境之前，请仔细检查生成的代码，尤其是差异（diff）。

集成代码写入后会发生什么？

助手会运行验证检查清单（安装、初始化、SKAdNetwork、事件、深度链接、收入、隐私），并针对任何失败项提出修复建议。它还会在项目的智能体配置文件中写入一个 Singular 部分，以便后续会话保留有关您集成的上下文。