MCP Telegram
← 빠른 시작으로 돌아가기

Telegram에 파일과 음성 보내기

문서, 사진, 음성 메모, 영상 메모, 앨범, 심지어 스토리와 새 프로필 사진까지 — 바이트가 첨부된 모든 것. AI가 여러분을 대신해 보냅니다. 한 번 업로드한 파일에서, 또는 공개 https:// URL에서 직접 보낼 수 있습니다.

1

바이트를 가져올 방법 선택하기

두 가지 방법: (1) mcp-telegram.com/my/upload에서 파일을 한 번 업로드하고 반환된 uploadId를 복사하여 프롬프트에서 참조; 또는 (2) AI에게 파일을 가리키는 https:// URL을 제공 — 클라우드가 가져옵니다(SSRF 보호 포함, 로컬/내부 주소는 차단됩니다). 최대 파일 크기는 약 50 MB입니다.

2

단일 파일 또는 음성 메모 보내기

이렇게 말하세요: "이 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를 사용하십시오.