MCP Telegram向 Telegram 发送文件与语音
文档、照片、语音、圆形视频、相册，甚至动态和新的头像——任何带有字节内容的东西。AI 会替您发送，可以使用您事先上传过的文件，也可以直接从公开的 https:// URL 发送。
选择字节内容的来源
两种方式：(1) 在 mcp-telegram.com/my/upload 上传一次文件，复制返回的 uploadId，并在提示中引用它；或 (2) 给 AI 一个指向文件的 https:// URL——云端会代为抓取（带 SSRF 防护，本地/内网地址会被拦截）。最大文件大小约为 50 MB。
发送单个文件或语音消息
对 AI 说：“把这个 PDF 发给 @friend”，并附上 uploadId 或 URL。AI 会调用 telegram-send-file。语音消息（推荐 OGG/Opus，M4A/MP3 也可）请使用 telegram-send-voice；圆形视频消息请使用 telegram-send-video-note。
发送 1–10 张照片或视频组成的相册
对 AI 说：“把我上传的这 5 张照片做成相册，带上说明，发到家庭群里。” AI 会调用 telegram-send-album。每个条目各自带有 uploadId-或-URL 以及可选的说明文字。在 Telegram 中，第一个条目的说明会显示为相册说明。
设置新的头像
对 AI 说：“把这个设为我的 Telegram 头像”，并附上 uploadId 或 URL。AI 会调用 telegram-set-profile-photo。图片和短 MP4 均可。如果您希望在账号设为私密时仍展示该头像，请使用 fallback:true。
试试这些提示
"把 https://example.com/contract.pdf 的文件发给 @lawyer"
"用我上传的 4 张照片做成相册，配上说明 'Weekend trip'，发到家庭群"
"用 uploadId abc123 设置我的新头像"
故障排查
URL 抓取失败，提示 “address not allowed”
SSRF 防护会拦截解析到私有、链路本地、回环或元数据 IP 地址的 URL。请使用公开的 https:// URL，或先通过 /my/upload 上传文件并引用 uploadId。
文件太大
云端上传上限约为 50 MB。更大的文件请托管在公开服务器上，并传入 https:// URL——Telegram 本身支持最大 2 GB，云端限制仅适用于上传步骤。
uploadId 已过期或找不到
待处理的上传只会在 /my/upload 之后短时间内保留。如果使用得太晚，请重新上传并使用新的 uploadId。