# AI 辅助集成

使用 AI 编码助手在您的项目中集成和配置 Pushwoosh Android SDK。通过将您的助手连接到 [Context7](https://context7.com/) MCP 服务器，它可以访问最新的 SDK 文档、代码示例和 API 参考——从而生成准确、可用的集成代码。

<Aside type="note">
您的 AI 助手必须支持 [MCP (Model Context Protocol)](https://modelcontextprotocol.io/) 才能使用 Context7。支持的工具包括 **Claude Code**、**Cursor**、**Windsurf**、**Cline** 等。
</Aside>

## 工作原理

Context7 是一个 MCP 服务器，为 AI 助手提供最新的库文档。当您的助手可以访问 Context7 时，它可以在对话期间直接获取最新的 Pushwoosh Android SDK 文档、代码片段和 API 参考——而不是依赖可能过时的训练数据。

Context7 上的 Pushwoosh Android SDK 库 ID 为：**`/pushwoosh/pushwoosh-android-sdk`**

## 设置 Context7

将 [Context7](https://github.com/upstash/context7#installation) 添加到您的 AI 助手的 MCP 配置中：

<Tabs>
  <TabItem label="Claude Code">
运行以下命令：

```bash
claude mcp add --scope user context7 -- npx -y @upstash/context7-mcp --api-key YOUR_API_KEY
```
  </TabItem>
  <TabItem label="Cursor / Windsurf">
添加到您的 MCP 配置文件（`.cursor/mcp.json` 或等效文件）：

```json
{
  "mcpServers": {
    "context7": {
      "command": "npx",
      "args": ["-y", "@upstash/context7-mcp@latest"]
    }
  }
}
```
  </TabItem>
</Tabs>

## 示例提示

配置好 Context7 后，您可以使用自然语言提示来集成 SDK。以下是用于常见任务的即用型提示。

### 基本 SDK 集成

```text
将 Pushwoosh Android SDK 集成到我的 Android 项目中，并使用 Firebase Cloud Messaging (FCM)。

要求：
- 添加 gradle 依赖项 (pushwoosh, pushwoosh-firebase)
- 使用 Pushwoosh App ID 配置 AndroidManifest.xml：YOUR_APP_ID
- 在 MainActivity 中注册推送通知

使用 Context7 MCP 获取 Pushwoosh Android SDK 文档。
```

### 推送通知处理

```text
向我展示如何在 Android 中使用 Pushwoosh SDK 处理推送通知回调（接收、打开）。我想为这些事件添加分析跟踪。

使用 Context7 MCP 获取关于 NotificationServiceExtension 的 Pushwoosh Android SDK 文档。
```

### 使用标签进行用户分群

```text
向我展示如何在 Android 中使用 Pushwoosh 标签进行用户分群。
创建一个包含设置和获取标签方法的示例辅助类。

使用 Context7 MCP 获取关于 setTags 和 getTags 的 Pushwoosh Android SDK 文档。
```

<Aside type="tip">
在提示末尾添加 **“使用 Context7 MCP 获取 Pushwoosh Android SDK 文档”** 会告知 AI 助手在生成代码前拉取最新的 SDK 文档。
</Aside>

## AI 助手获取的内容

当您的助手向 Context7 查询 Pushwoosh Android SDK 时，它会收到：

- **安装说明** — Gradle 依赖项和清单配置
- **API 参考** — 公共类、方法和接口
- **代码示例** — 适用于常见用例的 Java 和 Kotlin 代码片段
- **模块文档** — 每个 SDK 模块（Firebase、Huawei、Geozones 等）的指南
- **配置详情** — AndroidManifest.xml 设置、Firebase 设置和权限