即时通信 IM 快速入门

一、MCP

MCP 提供了 IM 知识咨询和含 UI 集成的 AI 解决方案。如果你先想查文档/API/错误码，可优先用 MCP。

二、三大优势

·答案可溯源：答案来自产品文档并附来源链接，不依赖模型训练数据；文档中没有的内容会明确说明，不编造 API 和参数。

·自动确认平台：平台信息不明确时主动向你确认，避免跨平台混答。

·一个入口覆盖全栈：UI 组件、客户端 API、服务端 API 与回调、计费配置在同一入口查询，无需在多个文档站之间切换。

三、能力清单

能力场景	能力说明	示例
知识咨询	查询 UI 组件（ConversationList、MessageList 等）的用法。	“@tencentcloud-sdk-mcp Vue3 MessageList 组件如何渲染自定义消息卡片？”
	查询无 UI SDK API 用法。	“@tencentcloud-sdk-mcp H5 集成 Web IM SDK 怎么发送语音消息？”
	查询 SDK 和服务端错误码含义与处理建议。	“@tencentcloud-sdk-mcp Web IM SDK 登录时什么情况会 2025 错误码？”
	查询服务端 REST API（导入账号、服务端发消息等）用法。	“@tencentcloud-sdk-mcp REST API 怎么在群组中发送自定义消息？”
	查询 Webhook 配置、第三方回调对接方式。	“@tencentcloud-sdk-mcp IM 回调 State.StateChange 状态变更回调的请求体字段格式是什么？”
	查询套餐价格、能力限制、多端登录配置、内网代理配置。	“@tencentcloud-sdk-mcp Web IM SDK 怎么实现内网代理？”
	查询离线推送 Push 接入方式、厂商配置和常见注意事项。	“@tencentcloud-sdk-mcp iOS 离线推送证书怎么配置？”
错误排查	结合报错信息诊断集成 UIKit 或 SDK 过程中遇到的各种问题。	“@tencentcloud-sdk-mcp 安卓 App 加入项目成功后，IM 报错：Fail to create more groups. This sdkappid has reached group amount max limit.”
测试凭证	根据 SDKAppID + SecretKey 生成调试用 UserSig。	“@tencentcloud-sdk-mcp 帮我生成 userID 为 test01 的 userSig”
代码集成	MCP 根据上下文识别 Vue3/React 框架并生成 UIKit 代码。	“@tencentcloud-sdk-mcp 帮我在 Vue3 项目中集成 Chat UIKit 完整功能。”
	MCP 根据上下文识别 Android/iOS/Flutter 平台并生成 UIKit 代码。	“@tencentcloud-sdk-mcp 帮我在 Flutter 项目接入完整的 Chat UIKit 功能。”

平台覆盖：Web、React、Vue、小程序、uni-app（打包 App）、Android、iOS、HarmonyOS、Flutter、React Native、Unity、Unreal Engine。

四、准备账号与凭证

你需要先在腾讯云控制台创建应用，并获取以下凭证（如果你还没有创建应用，支持不配置 SDKAppID 试用。）：

凭证	用途	获取位置
SDKAppID	MCP 环境变量，基础查询时配置。	IM 控制台 > 应用管理
SecretKey	MCP 环境变量，需要 MCP 生成测试 userSig 时配置。

五、配置 MCP

{ "mcpServers": { "tencentcloud-sdk-mcp": { "command": "npx", "args": ["-y", "@tencentcloud/sdk-mcp@latest"], "env": { "SDKAPPID": "YOUR_SDKAPPID", "SECRETKEY": "YOUR_SECRET_KEY" } } }}

MCP 详细使用指南请参考 MCP。

六、Skill

Skill 提供了 Android Chat 含 UI、 Web Vue3 无 UI （State API）集成方案。

七、核心能力

核心能力	说明
聊天链路完整闭环	登录鉴权 + UI 渲染 + 状态管理。
业务定制	在对话中直接提出“我要订单卡片”、“我要优惠券卡片”，Skill 会自动识别并将其集成到你的聊天中（支持自定义卡片注入）。
风格对齐	对于已有项目，Skill 能够读取你的当前代码上下文，按既有编码风格进行增量集成。

八、安装 Skill

在你项目的根目录执行下面的命令进行安装：

CodeBuddyCursorCodex CLIClaude Code CLInpx @tencent-rtc/trtc-agent-skills@latest add –ide codebuddynpx @tencent-rtc/trtc-agent-skills@latest add –ide cursornpx @tencent-rtc/trtc-agent-skills@latest add –ide codexnpx @tencent-rtc/trtc-agent-skills@latest add –ide claude

九、快速开始

安装后直接在 IDE 对话框输入需求即可，例如：

1. 集成完成聊天功能

我想用 chat 实现一个类似企业微信的沟通工具，用户可以发文本消息/图片消息/视频消息。

2. 只集成聊天窗口

我想用 chat 实现一个在线商城的客服功能，需要能发文本消息/图片消息，用户点击页面右下角客服按钮后弹出聊天窗口。

Skill 详细使用指南请参考 Skills 。

十、参考

·MCP NPM 包

·Skill NPM 包