MCP Telegram
クイックスタートに戻る

Telegram にファイル&音声を送信

ドキュメント、写真、ボイスメモ、ビデオメモ、アルバム、さらにはストーリーや新しいプロフィール写真まで — バイトが付随するものなら何でも。AI があなたに代わって送信します。一度アップロードしたファイルからでも、公開された https:// URL から直接でも可能です。

1

バイトの取り込み方を選ぶ

2 つの方法があります:(1) mcp-telegram.com/my/upload で一度ファイルをアップロードし、返ってきた uploadId をコピーしてプロンプトで参照する。(2) AI にファイルを指す https:// URL を渡す — クラウドが取得します(SSRF 保護付きで、ローカル・内部アドレスはブロックされます)。最大ファイルサイズは約 50 MB です。

2

ファイル 1 つやボイスメモを送信する

「この PDF を @friend に送って」と uploadId または URL を添えて言います。AI が telegram-send-file を呼び出します。ボイスメッセージ(OGG/Opus 推奨、M4A/MP3 も可)には telegram-send-voice を、丸型のビデオメッセージには telegram-send-video-note を使用します。

3

1〜10 枚の写真や動画でアルバムを送る

「この 5 枚の写真をアルバムとしてキャプション付きで家族チャットに送って」と言います。AI が telegram-send-album を呼び出します。各アイテムにはそれぞれ uploadId-または-URL と任意のキャプションを指定します。最初のアイテムのキャプションが Telegram でアルバムキャプションとして表示されます。

4

新しいプロフィール写真を設定する

「これを 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 を使用してください。