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

AI에서 Telegram 스토리 사용하기

팔로우 중인 연락처와 채널이 게시한 스토리, 내가 게시한 스토리의 시청자 목록, 그리고 내 스토리를 게시·고정·편집·삭제하는 도구 — 모두 AI 도구로 사용할 수 있습니다.

1

피드에서 스토리 읽기

이렇게 말하세요: "내가 팔로우하는 사람들의 활성 스토리를 보여 줘." AI가 telegram-get-all-stories를 호출하고 현재 피드에 있는 각 스토리의 간결한 메타데이터(id, 날짜, 만료일, 캡션, 미디어 유형, 카운터)를 반환합니다. 페이지네이션 지원 — 더 많이 요청하면 오래된 항목을 불러올 수 있습니다.

2

내 스토리를 본 사람 확인하기

이렇게 말하세요: "최근 스토리의 시청자 목록을 보여 줘." AI가 telegram-get-story-views를 호출하고 시청자의 리액션 이모지(있는 경우)와 시청 날짜, 그리고 조회 수·전달 수·리액션 수의 합계를 반환합니다. 참고: Premium이 아닌 계정에서는 전체 시청자 목록을 받지 못할 수 있으며, 매우 오래된 스토리는 시청자 데이터를 잃었을 수 있습니다.

3

새 스토리 게시하기

먼저 이미지나 짧은 비디오를 업로드합니다(mcp-telegram.com/my/upload를 열고 파일을 드롭한 후 uploadId를 복사). 또는 클라우드가 가져올 수 있는 https:// URL을 전달합니다. 그런 다음 이렇게 말하세요: "이 uploadId에서 내 프로필에 새 스토리를 게시해 줘." AI가 telegram-send-story를 호출합니다. 개인정보 설정(모두 / 연락처 / 친한 친구)은 명시적으로 전달됩니다.

4

하이라이트 고정하기 또는 캡션 편집하기

이렇게 말하세요: "스토리 12345를 내 프로필에 고정해 줘." AI가 telegram-toggle-story-pinned를 호출합니다(최대 3개까지 고정 가능). 캡션을 편집하려면: "스토리 12345의 캡션을 'New caption'으로 변경해 줘" — AI가 telegram-edit-story를 호출합니다. 클라우드에서는 미디어 파일 교체가 지원되지 않습니다. 대신 새 스토리를 게시하십시오.

다음 프롬프트를 시도해 보세요

"연락처의 활성 스토리를 보여 주고 소리 내어 읽어 줘"

"내 마지막 스토리를 누가 봤어? 리액션 이모지로 시청자를 그룹화해 줘."

"고정된 스토리 목록을 보여 주고 고정 해제하고 싶은 게 있는지 물어봐 줘"

문제 해결

내 스토리의 시청자 목록이 비어 있음

흔한 원인 두 가지: (1) Telegram은 전체 시청자 목록을 제한된 시간 동안만 유지하므로 매우 오래된 스토리는 이를 잃었을 수 있습니다. (2) 일부 계정(Premium이 아닌 경우)에서는 전체 목록을 전혀 받지 못합니다. 합계(viewsCount, reactionsCount)는 여전히 반환됩니다.

기존 스토리의 미디어 파일을 변경할 수 없음

telegram-edit-story는 캡션과 개인정보 설정을 업데이트할 수 있지만, 클라우드는 미디어 파일 교체를 명시적으로 거부합니다(파일 시스템을 통해 바이트를 재업로드해야 하기 때문입니다). 오래된 스토리를 삭제하고 새 스토리를 게시하십시오.