# AI 辅助集成

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

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

## 工作原理

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

Pushwoosh Cordova 插件在 Context7 上的库 ID 为：**`/pushwoosh/pushwoosh-phonegap-plugin`**

## 设置 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 后，您可以使用自然语言提示来集成插件。以下是用于常见任务的即用型提示。

### 基本插件集成

```text
Integrate Pushwoosh Cordova plugin into my Cordova project.

Requirements:
- Install pushwoosh-cordova-plugin via cordova plugin add
- Initialize Pushwoosh with my App ID in onDeviceReady
- Register for push notifications and handle push-receive and push-notification events

Use Context7 MCP to fetch Pushwoosh Cordova plugin documentation.
```

### 推送通知处理

```text
Show me how to handle push notification callbacks (receive, open) with
Pushwoosh Cordova plugin. I want to process push payload data and navigate
to specific pages based on custom data.

Use Context7 MCP to fetch Pushwoosh Cordova plugin documentation for push event handling.
```

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

```text
Show me how to use Pushwoosh tags for user segmentation in a Cordova app.
I need to set tags, get tags, and set user ID for cross-device tracking.

Use Context7 MCP to fetch Pushwoosh Cordova plugin documentation for setTags and getTags.
```

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

## AI 助手获取的内容

当您的助手向 Context7 查询 Pushwoosh Cordova 插件时，它会收到：

- **安装说明** — 插件安装和平台特定设置
- **API 参考** — 公共方法、事件和回调签名
- **代码示例** — 适用于常见用例的 JavaScript 代码片段
- **事件文档** — `push-receive`、`push-notification` 和其他事件处理程序
- **配置详情** — 插件变量、平台特定设置和权限