freemcplab / 디렉터리 / 플레이그라운드 / Telegram MCP

● 커뮤니티 chigwell 🔑 본인 키 필요

Telegram MCP

Name: Telegram MCP MCP Server
Author: chigwell

개인 계정 Telegram MCP — Claude가 공식 MTProto API를 통해 채팅을 읽고, 그룹을 관리하고, 메시지를 보냅니다.

Telegram의 MTProto API(Bot API 아님)를 사용하므로 개인 계정으로 동작합니다. 개인 생산성 흐름에 유용합니다: 채팅 분류, 그룹 요약, 메시지 예약. 채팅은 민감 정보이므로 프라이버시를 존중하세요.

▶ 데모 보기 📦 설치 💡 사용 사례

왜 쓰나요

핵심 기능

MTProto (개인 계정)
DM 및 그룹 읽기
메시지 및 미디어 전송
기록 검색
그룹 멤버 관리
메시지 예약

라이브 데모

실제 사용 모습

준비됨

설치

클라이언트 선택

~/Library/Application Support/Claude/claude_desktop_config.json · Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "telegram-mcp-chigwell": {
      "command": "uvx",
      "args": [
        "telegram-mcp"
      ],
      "env": {
        "TG_API_ID": "${TG_API_ID}",
        "TG_API_HASH": "${TG_API_HASH}"
      }
    }
  }
}

Claude Desktop → Settings → Developer → Edit Config 열기. 저장 후 앱 재시작.

~/.cursor/mcp.json · .cursor/mcp.json

{
  "mcpServers": {
    "telegram-mcp-chigwell": {
      "command": "uvx",
      "args": [
        "telegram-mcp"
      ],
      "env": {
        "TG_API_ID": "${TG_API_ID}",
        "TG_API_HASH": "${TG_API_HASH}"
      }
    }
  }
}

Cursor는 Claude Desktop과 동일한 mcpServers 스키마 사용. 프로젝트 설정이 전역보다 우선.

VS Code → Cline → MCP Servers → Edit

{
  "mcpServers": {
    "telegram-mcp-chigwell": {
      "command": "uvx",
      "args": [
        "telegram-mcp"
      ],
      "env": {
        "TG_API_ID": "${TG_API_ID}",
        "TG_API_HASH": "${TG_API_HASH}"
      }
    }
  }
}

Cline 사이드바의 MCP Servers 아이콘 클릭 후 "Edit Configuration" 선택.

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "telegram-mcp-chigwell": {
      "command": "uvx",
      "args": [
        "telegram-mcp"
      ],
      "env": {
        "TG_API_ID": "${TG_API_ID}",
        "TG_API_HASH": "${TG_API_HASH}"
      }
    }
  }
}

Claude Desktop과 같은 형식. Windsurf 재시작 후 적용.

~/.continue/config.json

{
  "mcpServers": [
    {
      "name": "telegram-mcp-chigwell",
      "command": "uvx",
      "args": [
        "telegram-mcp"
      ]
    }
  ]
}

Continue는 맵이 아닌 서버 오브젝트 배열 사용.

~/.config/zed/settings.json

{
  "context_servers": {
    "telegram-mcp-chigwell": {
      "command": {
        "path": "uvx",
        "args": [
          "telegram-mcp"
        ]
      }
    }
  }
}

context_servers에 추가. 저장 시 Zed가 핫 리로드.

claude mcp add telegram-mcp-chigwell -- uvx telegram-mcp

한 줄 명령. claude mcp list로 확인, claude mcp remove로 제거.

사용 사례

실전 활용법: Telegram MCP

Telegram 채팅 분류

👤 개발자 ⏱ ~15 min intermediate

언제 쓸까: 채팅이 넘쳐날 때 채팅별 요약과 후속 조치 제안이 필요할 때.

흐름

인증

첫 실행 시 SMS 코드 입력; 세션 파일이 저장됩니다.✓ 복사됨

→ 세션 파일 생성
가져오기

list_chats; 각 채팅에서 미읽음 메시지 가져오기.✓ 복사됨

→ 채팅별 미읽음
요약

Claude가 요약하고 답변을 제안합니다.✓ 복사됨

→ 답장 큐

결과: 제안된 답변과 함께 Telegram 받은편지함 제로.

조합

다른 MCP와 조합해 10배 효율

telegram-mcp-chigwell + filesystem

전송 전 초안을 파일로 저장

telegram-mcp-chigwell와 filesystem 조합: 전송 전 초안을 파일로 저장✓ 복사됨

도구

이 MCP가 노출하는 것

도구	입력	언제 호출	비용
list_chats	(문서 참조)	미읽음 카운트와 함께 채팅 목록 조회	호출 1회
fetch_messages	(문서 참조)	채팅에서 메시지 가져오기	호출 1회
send_message	(문서 참조)	메시지 전송	호출 1회
search	(문서 참조)	채팅 전체 검색	호출 1회

비용 및 제한

운영 비용

API 쿼터: Telegram 속도 제한
호출당 토큰: 기록이 클 수 있음
금액: 무료
팁: 전송 전 항상 미리보기; 에이전트는 채팅 작업에 과도하게 적극적입니다

보안

권한, 시크릿, 파급범위

최소 스코프: user-account

자격 증명 저장: 세션 파일은 디스크에

데이터 외부 송신: telegram.org으로 전송

절대 부여 금지: expose session file; it's as good as your password

문제 해결

자주 발생하는 오류와 해결

AUTH_KEY_DUPLICATED

세션 충돌; 세션을 삭제하고 재인증

대안

Telegram MCP 다른 것과 비교

대안	언제 쓰나	단점/장점
Bot API 통합	개인 계정이 아닌 봇이 필요할 때	개인 DM 접근 불가