TIMPush Agent Skill

English | 简体中文

@tencent-rtc/trtc-push-skill is an Agent Skill for Tencent Cloud TIMPush (Tencent Cloud IM Push / offline push). It helps developers integrate and troubleshoot TIMPush in Android, iOS, Flutter, and UniApp projects, including vendor push channels, APNs, registration issues, badges, and server API checks.

After installation, you do not need to manually browse documentation or configure an MCP server. Describe what you want in your AI IDE or AI plugin, for example "help me integrate TIMPush", and the agent will detect the project platform and guide the integration or troubleshooting flow step by step.

Install

Do not install this package with npm install. npm install @tencent-rtc/trtc-push-skill only downloads the npm package and will not install the skill or configure the MCP server. Use npx commands below to run the installer.

Project-level installation is recommended. Run the command from the app project root, or any subdirectory under that project. The installer resolves the project root and writes the skill and MCP configuration into that project, making the setup easier to share and reproduce with the team.

Install Into AI IDEs

If you use Cursor, Claude Code, CodeBuddy, Codex, or another supported AI IDE, run the installer inside your project:

# Auto-detect installed IDEs on this machine
npx -y @tencent-rtc/trtc-push-skill@latest add

# Install for one specific AI IDE
npx -y @tencent-rtc/trtc-push-skill@latest add --ide cursor
npx -y @tencent-rtc/trtc-push-skill@latest add --ide claude
npx -y @tencent-rtc/trtc-push-skill@latest add --ide codebuddy
npx -y @tencent-rtc/trtc-push-skill@latest add --ide codex

After installation, enable the MCP server if your IDE does not turn it on automatically (it powers the guided workflows):

| IDE | What to do after install | | --- | --- | | Cursor | Project MCP servers are disabled by default (recent Cursor versions show no prompt). Open the Cursor sidebar → Customize → MCP and toggle on trtc-push-mcp, then reload the window. | | Claude Code | Nothing to do — the installer pre-approves the server in .claude/settings.local.json. Start a new claude session; approve via /mcp if ever asked. | | CodeBuddy | Nothing to do — the server auto-enables from the project-root .mcp.json. Reload CodeBuddy. | | Codex | Run codex in the project and accept the trust prompt, so the project .codex/config.toml (and the MCP server) loads. |

Then ask in Agent mode:

help me integrate TIMPush

Install Into AI Plugins for Coding IDEs

The same installer also works for AI plugins inside traditional coding IDEs. Common plugin forms include:

• CodeBuddy plugins in Android Studio, IntelliJ IDEA, or JetBrains IDEs
• Cursor plugins, or plugins compatible with Cursor project configuration, in Visual Studio Code or Cursor-family IDEs
• AI coding plugins for Visual Studio Code or JetBrains IDEs that support MCP or Agent Skill project configuration
• Other AI plugins that can read project-level .cursor/, .codebuddy/, .claude/, or .codex/ configuration directories

The installer currently supports these --ide values directly: cursor, claude, codebuddy, and codex. If your plugin is compatible with one of these project configuration directories, choose the matching option.

For Android Studio with the CodeBuddy plugin, run this inside your Android project:

npx -y @tencent-rtc/trtc-push-skill@latest add --ide codebuddy

This generates .codebuddy/skills/ and a project-root .mcp.json in the current project. The MCP server auto-enables — restart Android Studio or reload the CodeBuddy plugin before use.

For a Cursor-related plugin, or a plugin compatible with Cursor project configuration, run this inside your project:

npx -y @tencent-rtc/trtc-push-skill@latest add --ide cursor

This generates .cursor/skills/ and .cursor/mcp.json in the current project. Restart or reload the plugin before use, and enable trtc-push-mcp in the MCP panel if it appears disabled (project-level MCP servers are off by default).

After-Install Self-Check: Confirm the MCP Server Is Enabled

The skill drives guided workflows through the trtc-push-mcp MCP server. Whichever install path you used, the setup only works once the MCP server is enabled and loaded. Use this table to self-check.

Installed into an AI IDE:

| IDE | MCP config written to | How to enable | You are done when | | --- | --- | --- | --- | | Cursor | .cursor/mcp.json | Sidebar → Customize → MCP → toggle on trtc-push-mcp → reload window | trtc-push-mcp shows enabled in the MCP panel | | Claude Code | project-root .mcp.json | Restart the claude session; approve via /mcp if asked | trtc-push-mcp tools are available to the agent | | CodeBuddy | project-root .mcp.json | Restart CodeBuddy | trtc-push-mcp tools are available | | Codex | .codex/config.toml | Run codex in the project and accept the trust prompt | trtc-push-mcp tools are available |

Installed into an AI plugin of a coding IDE:

| Plugin form | MCP config written to | How to enable | You are done when | | --- | --- | --- | --- | | CodeBuddy plugin in Android Studio / JetBrains IDEs | project-root .mcp.json | Restart the IDE or reload the CodeBuddy plugin | The plugin can call trtc-push-mcp tools | | Cursor-compatible plugin in VS Code / Cursor-family IDEs | .cursor/mcp.json | Enable trtc-push-mcp in the plugin's MCP panel, then reload | The plugin can call trtc-push-mcp tools | | Other compatible plugins | Depends on the config dir the plugin reads (.cursor/, .codebuddy/, .claude/, .codex/) | Confirm the config exists, enable it in the plugin, then reload | The plugin can call trtc-push-mcp tools |

The final check is the same in every case: the agent can see and call trtc-push-mcp tools (for example list_workflows). If not, the MCP server is still not enabled.

What It Can Do

The skill is triggered automatically when you mention TIMPush, offline push, vendor push channels, APNs, or related push delivery issues. No slash command is required.

| Scenario | What It Helps With | Examples | | --- | --- | --- | | Start from scratch | Detects the project platform and walks through SDK setup, configuration, registration code, and validation | "help me integrate TIMPush" · "set up Tencent Cloud offline push" | | Android vendor channels | Guides Huawei, Xiaomi, OPPO, vivo, Honor, FCM, and other vendor channel setup | "check my Huawei push config" · "Android offline push is not received" | | iOS APNs | Checks APNs certificates, Bundle ID, environment, BusinessID, and registration flow | "iOS registerPush succeeds but offline push is not received" | | Flutter / UniApp | Handles native project structure, plugin integration, and validation for cross-platform apps | "integrate TIMPush in a Flutter project" · "how to add offline push to uni-app" | | Registration troubleshooting | Analyzes registerPush, registrationID, error codes, and callback logs | "registerPush returns 800006" · "registrationID is empty" | | Delivery troubleshooting | Helps investigate push not received, delivered but not displayed, badges, console quotas, and server API issues | "offline push is delivered but not displayed" · "help me check badge issues" |

Usage Examples

After installing and restarting the IDE or plugin, ask the agent:

help me integrate TIMPush

Or:

My Android offline push is not received. Help me troubleshoot it.

iOS registerPush succeeds, but offline push is not received after the app is killed.

Help me check vendor channel and BusinessID configuration.

Contact Us

For technical support, enterprise integration, or feedback about TIMPush Skill, contact us at trtc.io/contact.

简体中文

English | 简体中文

@tencent-rtc/trtc-push-skill 是面向腾讯云 TIMPush（即时通信推送 / 离线推送）的 Agent Skill。它可以帮助开发者在 Android、iOS、Flutter、UniApp 等项目中完成 TIMPush 接入、厂商通道配置、APNs 配置、注册排障、角标、服务端 API 调试等工作。

安装后，你不需要手动翻文档或手动配置。直接在 AI IDE 或 Coding IDE 的 AI 插件里用自然语言描述需求，例如“帮我集成 TIMPush”，Agent 会自动识别项目平台，并调用配套能力逐步完成集成或排障。

安装

请不要使用 npm install 安装本包。 npm install @tencent-rtc/trtc-push-skill 只会下载 npm 包，不会安装 Skill，也不会配置 MCP Server。 请使用下面的 npx 命令执行安装器。

推荐使用项目级安装：在你希望 AI 助手处理的 App 工程根目录或任意子目录执行安装命令。安装器会向上解析项目根目录，并把 Skill 与 MCP 配置写入该项目，便于团队协作和项目复现。

安装到 AI IDE

如果你使用 Cursor、Claude Code、CodeBuddy、Codex 等 AI IDE，可以在项目中执行：

# 自动检测本机已安装的 IDE
npx -y @tencent-rtc/trtc-push-skill@latest add

# 只安装到指定 AI IDE
npx -y @tencent-rtc/trtc-push-skill@latest add --ide cursor
npx -y @tencent-rtc/trtc-push-skill@latest add --ide claude
npx -y @tencent-rtc/trtc-push-skill@latest add --ide codebuddy
npx -y @tencent-rtc/trtc-push-skill@latest add --ide codex

安装完成后，如果你的 IDE 不会自动开启 MCP Server（它驱动向导式流程），请按下表开启：

| IDE | 安装后需要做什么 | | --- | --- | | Cursor | 项目级 MCP 默认禁用（新版 Cursor 不再有弹窗提示）。打开 Cursor 侧边栏 → Customize → MCP，打开 trtc-push-mcp 开关，然后重载窗口。 | | Claude Code | 无需操作——安装器已在 .claude/settings.local.json 中预批准。重启 claude 会话即可；若仍提示审批，用 /mcp 批准。 | | CodeBuddy | 无需操作——MCP 从项目根 .mcp.json 自动启用。重载 CodeBuddy 即可。 | | Codex | 在项目中运行 codex 并接受 trust 提示，项目 .codex/config.toml（含 MCP）才会加载。 |

然后在 Agent 模式中提问：

帮我集成 TIMPush

安装到 Coding IDE 的 AI 插件

如果你使用的是传统 Coding IDE 中的 AI 插件，也可以使用同一个安装器。常见形态包括：

• Android Studio / IntelliJ IDEA / JetBrains 系 IDE 中的 CodeBuddy 插件
• Visual Studio Code / Cursor 系 IDE 中的 Cursor 插件或兼容 Cursor 项目配置的插件
• Visual Studio Code / JetBrains 系 IDE 中支持 MCP 或 Agent Skill 项目配置的 AI 编程插件
• 其他能读取项目级 .cursor/、.codebuddy/、.claude/、.codex/ 配置目录的 AI 插件

当前安装器直接支持的 --ide 参数为 cursor、claude、codebuddy、codex。如果插件兼容其中一种项目配置目录，可以选择对应参数安装。

例如，在 Android Studio 中使用 CodeBuddy 插件时，在 Android 工程内执行：

npx -y @tencent-rtc/trtc-push-skill@latest add --ide codebuddy

安装后会在当前项目下生成 .codebuddy/skills/ 和项目根 .mcp.json，MCP 自动启用，重启 Android Studio 或重新加载 CodeBuddy 插件后即可使用。

在 Visual Studio Code 中使用 Cursor 相关插件或兼容 Cursor 配置的插件时，在项目内执行：

npx -y @tencent-rtc/trtc-push-skill@latest add --ide cursor

安装后会在当前项目下生成 .cursor/skills/ 和 .cursor/mcp.json。重启或重载插件后，如果 MCP 面板里 trtc-push-mcp 是禁用状态（项目级 MCP 默认关闭），请手动开启再使用。

安装后自查：确认 MCP 已开启

Skill 通过 trtc-push-mcp MCP server 驱动向导式流程。无论用哪种方式安装，只有 MCP 已启用并加载后流程才能工作。按下表自查。

安装到 AI IDE：

| IDE | MCP 配置位置 | 启用动作 | 通过标准 | | --- | --- | --- | --- | | Cursor | .cursor/mcp.json | 侧边栏 → Customize → MCP → 打开 trtc-push-mcp → 重载窗口 | MCP 面板中 trtc-push-mcp 为启用状态 | | Claude Code | 项目根 .mcp.json | 重启 claude 会话；若提示审批，用 /mcp 批准 | Agent 可使用 trtc-push-mcp 工具 | | CodeBuddy | 项目根 .mcp.json | 重启 CodeBuddy | Agent 可使用 trtc-push-mcp 工具 | | Codex | .codex/config.toml | 在项目目录运行 codex 并接受 trust 提示 | Agent 可使用 trtc-push-mcp 工具 |

安装到 Coding IDE 的 AI 插件：

| 插件形态 | MCP 配置位置 | 启用动作 | 通过标准 | | --- | --- | --- | --- | | Android Studio / JetBrains + CodeBuddy 插件 | 项目根 .mcp.json | 重启 IDE 或重新加载 CodeBuddy 插件 | 插件内可调用 trtc-push-mcp 工具 | | VS Code / Cursor 系插件 | .cursor/mcp.json | 在插件 MCP 面板启用 trtc-push-mcp，然后 reload | 插件内可调用 trtc-push-mcp 工具 | | 其他兼容插件 | 取决于插件读取的配置目录（.cursor/ / .codebuddy/ / .claude/ / .codex/） | 确认配置已生成，在插件内启用后 reload | 插件内可调用 trtc-push-mcp 工具 |

所有场景的最终标准一致：Agent 能看到并调用 trtc-push-mcp 工具（如 list_workflows）。看不到就是 MCP 未启用，不要退回手动文档流程。

能做什么

当你提到 TIMPush、离线推送、厂商通道或 APNs 等关键词时，Skill 会自动触发，无需斜杠命令。

| 场景 | 能力说明 | 示例 | | --- | --- | --- | | 从零接入 | 识别项目平台，按步骤完成 TIMPush SDK、配置文件、注册代码和验证流程 | “帮我集成 TIMPush” · “接入腾讯云离线推送” | | Android 厂商通道 | 引导配置华为、小米、OPPO、vivo、荣耀、FCM 等厂商通道 | “帮我检查华为推送配置” · “Android 离线推送收不到” | | iOS APNs | 引导检查 APNs 证书、Bundle ID、环境、BusinessID 和注册流程 | “iOS registerPush 成功但离线推送不来” | | Flutter / UniApp | 结合跨平台工程结构处理原生配置、插件接入和验证步骤 | “Flutter 项目接入 TIMPush” · “uni-app 离线推送怎么接” | | 注册与回调排障 | 分析 registerPush、registrationID、错误码和回调日志 | “registerPush 报 800006” · “registrationID 获取不到” | | 业务排查 | 排查离线推送不达、送达不展示、角标、控制台额度、服务端 API 等问题 | “离线推送有送达但不展示” · “帮我查角标问题” |

使用示例

安装完成并重启 IDE / 插件后，在 Agent 对话中直接输入：

帮我集成 TIMPush

或者：

我的 Android 离线推送收不到，帮我排查

iOS registerPush 成功了，但杀进程后收不到离线推送

帮我检查厂商通道和 BusinessID 配置

联系我们

如需技术支持、企业接入或反馈 TIMPush Skill 使用问题，可访问 trtc.io/contact 联系我们。