MCP Telegram
← 返回快速开始

在 AI 中使用 Telegram 动态

您关注的联系人和频道发布的动态、您发布动态的观看者列表，以及发布、置顶、编辑和删除自己动态的工具——全部以 AI 工具的形式提供。

1

阅读信息流中的动态

对 AI 说：“显示我关注的人的活动动态。” AI 会调用 telegram-get-all-stories，并返回当前信息流中每条动态的紧凑元数据（id、日期、过期日期、说明、媒体类型、计数器）。支持分页——继续请求即可加载更早的条目。

2

查看谁看过您的动态

对 AI 说：“列出我最近一条动态的观看者。” AI 会调用 telegram-get-story-views，返回观看者及其反应表情（如果有）和观看日期，以及观看数、转发数、反应数的合计。注意：非 Premium 账号可能无法获取完整的观看者列表，非常旧的动态可能已丢失观看者数据。

3

发布一条新动态

先上传一张图片或一段短视频（打开 mcp-telegram.com/my/upload，拖入文件，复制 uploadId），或者传入一个云端能抓取的 https:// URL。然后对 AI 说：“用这个 uploadId 在我的个人页发布一条新动态。” AI 会调用 telegram-send-story。隐私规则（所有人 / 联系人 / 亲密好友）会显式传入。

4

置顶精选或编辑说明文字

对 AI 说：“把动态 12345 置顶到我的个人页。” AI 会调用 telegram-toggle-story-pinned（最多可置顶 3 条动态）。要编辑说明文字：“把动态 12345 的说明改为 'New caption'”——AI 会调用 telegram-edit-story。云端不支持替换媒体文件；请改为发布一条新动态。

试试这些提示

"显示联系人的活动动态，然后朗读出来"

"谁看过我最近一条动态？按反应表情对观看者分组。"

"列出我置顶的动态，并问我是否想取消某一条的置顶"

故障排查

我的动态观看者列表为空

常见的两个原因：(1) Telegram 只在有限的时间内保留完整的观看者列表，非常旧的动态可能已丢失；(2) 一些账号（非 Premium）根本拿不到完整列表。合计数据（viewsCount、reactionsCount）仍会返回。

无法在已有动态中更换媒体文件

telegram-edit-story 可以更新说明文字和隐私规则，但云端会明确拒绝替换媒体文件（那需要通过文件系统重新上传字节）。请删除旧动态，改为发布一条新动态。