即时通信 IM 快速入门

在 AI 编辑器里，直接用自然语言问 Chat UIKit 组件、无 UI SDK、服务端 API 等问题，答案来自官方文档；也可以一键生成集成代码。以下提供 MCP 和 Skill 两种接入方式。
说明：
MCP 1.6.0 起覆盖了 Chat 组件、SDK、服务端 API、服务端回调、产品计费与配置相关的查询能力。
MCP
MCP 提供了 IM 知识咨询和含 UI 集成的 AI 解决方案。如果您先想查文档/API/错误码，可优先用 MCP。以上能力覆盖 Web/Android/iOS/Flutter/uni-app（打包 App）等平台。
能力清单
能力场景
能力说明
示例
知识咨询
查询 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 离线推送证书怎么配置？”
代码集成
MCP 根据上下文识别 Vue3/React 框架并生成 UIKit 代码。
“@tencentcloud-sdk-mcp 帮我在 Vue3 项目中集成 Chat UIKit 完整功能。”
﻿
MCP 根据上下文识别 Android/iOS/Flutter 平台并生成 UIKit 代码。
“@tencentcloud-sdk-mcp 帮我在 Flutter 项目接入完整的 Chat UIKit 功能。”
错误排查
结合报错信息诊断集成 UIKit 或 SDK 过程中遇到的各种问题。
“@tencentcloud-sdk-mcp 安卓 App 加入项目成功后，IM 报错：Fail to create more groups. This sdkappid has reached group amount max limit.”
准备账号与凭证
您需要先在腾讯云控制台创建应用，并获取以下凭证（如果您还没有创建应用，支持不配置 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 提供了 Web Vue3 无 UI （State API）集成方案，您如果需要标准的 Vue3 State 集成流程，可选用 Skill。安装后可以从零集成 vue3 无 UI 聊天功能。
核心能力
核心能力
说明
聊天链路完整闭环
登录鉴权 + UI 渲染 + 状态管理。
业务定制
在对话中直接提出“我要订单卡片”、“我要优惠券卡片”，Skill 会自动识别并将其集成到您的聊天中（支持自定义卡片注入）。
风格对齐
对于已有项目，Skill 能够读取您的当前代码上下文，按既有编码风格进行增量集成。
安装 Skill
在您项目的根目录执行下面的命令进行安装：
CodeBuddy
Cursor
Codex CLI
Claude Code CLI
npx @tencent-rtc/trtc-agent-skills@latest add --ide codebuddy
npx @tencent-rtc/trtc-agent-skills@latest add --ide cursor
npx @tencent-rtc/trtc-agent-skills@latest add --ide codex
npx @tencent-rtc/trtc-agent-skills@latest add --ide claude
快速开始
安装后直接在 IDE 对话框输入需求即可，例如：
1. 集成完成聊天功能
我想用 chat 实现一个类似企业微信的沟通工具，用户可以发文本消息/图片消息/视频消息。
2. 只集成聊天窗口
我想用 chat 实现一个在线商城的客服功能，需要能发文本消息/图片消息，用户点击页面右下角客服按钮后弹出聊天窗口。
Skill 详细使用指南请参考 Skills 。
参考
﻿MCP NPM 包﻿
﻿Skill NPM 包﻿

能力场景	能力说明	示例
知识咨询	查询 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 离线推送证书怎么配置？”
代码集成	MCP 根据上下文识别 Vue3/React 框架并生成 UIKit 代码。	“@tencentcloud-sdk-mcp 帮我在 Vue3 项目中集成 Chat UIKit 完整功能。”
代码集成		MCP 根据上下文识别 Android/iOS/Flutter 平台并生成 UIKit 代码。	“@tencentcloud-sdk-mcp 帮我在 Flutter 项目接入完整的 Chat UIKit 功能。”
错误排查	结合报错信息诊断集成 UIKit 或 SDK 过程中遇到的各种问题。	“@tencentcloud-sdk-mcp 安卓 App 加入项目成功后，IM 报错：Fail to create more groups. This sdkappid has reached group amount max limit.”

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

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

快速入门

本页目录：

MCP

能力清单

准备账号与凭证

配置 MCP

Skill

核心能力

安装 Skill

快速开始

参考