# AI 辅助集成

使用 AI 编码助手在您的项目中集成和配置 Pushwoosh iOS 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 iOS SDK 文档、代码片段和 API 参考——而不是依赖可能过时的训练数据。

Pushwoosh iOS SDK 在 Context7 上的库 ID 为：**/pushwoosh/pushwoosh-ios-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
Integrate Pushwoosh iOS SDK into my iOS project using Swift Package Manager.

Requirements:
- Add SPM dependency from https://github.com/Pushwoosh/Pushwoosh-XCFramework
- Configure Info.plist with Pushwoosh App ID: YOUR_APP_ID
- Register for push notifications in AppDelegate

Use Context7 MCP to fetch Pushwoosh iOS SDK documentation.
```

### 推送通知处理

```text
Show me how to handle push notification callbacks (receive, open) with
Pushwoosh SDK in iOS. I want to implement PWMessagingDelegate and add
analytics tracking for these events.

Use Context7 MCP to fetch Pushwoosh iOS SDK documentation for PWMessagingDelegate.
```

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

```text
Show me how to use Pushwoosh tags for user segmentation in iOS.
Create example helper class with methods for setting and getting tags.

Use Context7 MCP to fetch Pushwoosh iOS SDK documentation for setTags and getTags.
```

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

## AI 助手获取的内容

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

- **安装说明** — SPM 和 CocoaPods 设置
- **API 参考** — 公共类、方法、属性和协议
- **代码示例** — 适用于常见用例的 Swift 和 Objective-C 代码片段
- **模块文档** — 每个 SDK 模块（VoIP、Live Activities、Geozones 等）的指南
- **配置详情** — Info.plist 键、授权和功能设置