텔레그램 MCP 서버

이 서버는 Telegram API와 AI 어시스턴트를 연결하는 다리 역할을 하며 Model Context Protocol을 기반으로 합니다.

[!중요] 이 서버를 사용하기 전에 Telegram API 서비스 약관을 읽고 이해했는지 확인하십시오. Telegram API를 오용할 경우 계정이 정지될 수 있습니다.

목차

• MCP란 무엇인가요?
• 이 서버는 무슨 역할을 하나요?
  • 역량
  • 프롬프트 예제
    • 메시지 관리
    • 조직
    • 의사소통
• 설치
  • 홈브루
  • 엔피엑스
  • 릴리스에서
    • 맥OS
    • 리눅스
    • 윈도우
  • 출처에서
• 구성
  • 권한 부여
  • 클라이언트 구성
• 스타 역사

MCP란 무엇인가요?

모델 컨텍스트 프로토콜(MCP)은 Claude Desktop이나 Cursor와 같은 AI 앱이 외부 도구 및 데이터 소스에 연결할 수 있도록 하는 시스템입니다. AI 어시스턴트가 사용자의 제어권을 유지하면서 로컬 서비스 및 API를 사용할 수 있는 명확하고 안전한 방법을 제공합니다.

이 서버는 무슨 역할을 하나요?

역량

• [x] 현재 계좌 정보 가져오기 ( tool: tg_me )
• [x] 선택적인 읽지 않은 필터가 있는 대화 상자 나열( tool: tg_dialogs )
• [x] 대화 상자를 읽음으로 표시( tool: tg_read )
• [x] 특정 대화에서 메시지 검색( tool: tg_dialog )
• [x] 모든 대화 상자에 임시 메시지 보내기( tool: tg_send )

프롬프트 예제

AI 도우미와 함께 사용할 수 있는 몇 가지 프롬프트 예시는 다음과 같습니다.

메시지 관리

• "내 텔레그램에서 읽지 않은 중요한 메시지가 있는지 확인하세요"
• "읽지 않은 모든 텔레그램 메시지를 요약해 주세요"
• "읽지 않은 메시지를 읽고 분석하고, 필요한 경우 초안 답변을 준비합니다."
• "중요하지 않은 읽지 않은 메시지를 확인하고 간략하게 설명해 주세요"

조직

• "내 Telegram 대화를 분석하고 폴더 구조를 제안해 주세요"
• "텔레그램 채팅을 중요도에 따라 분류하는 데 도움을 주세요"
• "모든 업무 관련 대화를 찾아 정리 방법을 제안해 주세요"

의사소통

• "[주제]에 대한 업데이트를 위해 특정 채팅을 모니터링하세요."
• "[채팅]의 마지막 메시지에 대한 정중한 답변을 작성하세요"
• "내 채팅에 답변되지 않은 질문이 있는지 확인하세요"

설치

홈브루

brew를 사용하여 macOS/Linux에 바이너리 릴리스를 설치할 수 있습니다.

지엑스피1

엔피엑스

npx를 사용하여 최신 버전을 직접 실행할 수 있습니다(macOS, Linux, Windows 지원):

NPX를 사용할 때 표준 명령과 구성을 다음과 같이 수정하세요.

• 인증 명령은 다음과 같습니다.

• Claude MCP 서버 구성은 다음과 같습니다.

전체 설정 지침은 권한 부여 및 클라이언트 구성을 참조하세요.

릴리스에서

맥OS

참고: 아래 명령어는 /usr/local/bin 에 설치됩니다. 다른 곳에 설치하려면 /usr/local/bin PATH에서 원하는 디렉터리로 바꾸세요.

먼저, 아키텍처에 맞는 아카이브를 다운로드하세요.

그런 다음 바이너리를 설치하세요.

리눅스

참고: 아래 명령어는 /usr/local/bin 에 설치됩니다. 다른 곳에 설치하려면 /usr/local/bin PATH에서 원하는 디렉터리로 바꾸세요.

먼저, 아키텍처에 맞는 아카이브를 다운로드하세요.

그런 다음 바이너리를 설치하세요.

윈도우

윈도우

1. 아키텍처에 맞는 최신 릴리스를 다운로드하세요:
   • 윈도우 x64
   • 윈도우 ARM64
2. .zip 파일을 추출합니다
3. 추출된 디렉토리를 PATH에 추가하거나 telegram-mcp.exe PATH의 디렉토리로 이동합니다.

출처에서

요구 사항:

• 1.24 이상으로 가세요
• PATH의 GOBIN

구성

권한 부여

서버를 사용하려면 먼저 Telegram API에 연결해야 합니다.

1. Telegram API 에서 API ID와 해시를 가져옵니다.
2. 다음 명령을 실행하세요.

   참고: 2FA가 활성화된 경우 --password <2fa_password>를 추가하세요.

   참고: 기존 세션을 재정의하려면 --new를 추가하세요.

   telegram-mcp auth --app-id <your-api-id> --api-hash <your-api-hash> --phone <your-phone-number>
   📩 Telegram에서 받은 코드를 입력하여 API에 연결하세요.
3. 완료되었습니다! 이 프로젝트의 발전을 위해 ⭐️를 눌러주세요.

클라이언트 구성

Telegram MCP 서버를 인식하도록 Claude Desktop을 구성하는 예입니다.

1. Claude Desktop 구성 파일을 엽니다.
   • MacOS에서는 구성 파일이 ~/Library/Application Support/Claude/claude_desktop_config.json 에 있습니다.
   • Windows에서 구성 파일은 %APPDATA%\Claude\claude_desktop_config.json 에 있습니다.

   참고: Claude Desktop 앱 설정 내부에서도 claude_desktop_config.json을 찾을 수 있습니다.

2. 서버 구성 추가Claude 데스크톱의 경우:
   { "mcpServers": { "telegram": { "command": "telegram-mcp", "env": { "TG_APP_ID": "<your-app-id>", "TG_API_HASH": "<your-api-hash>", "PATH": "<path_to_telegram-mcp_binary_dir>", "HOME": "<path_to_your_home_directory" } } } }
   커서의 경우:
   { "mcpServers": { "telegram-mcp": { "command": "telegram-mcp", "env": { "TG_APP_ID": "<your-app-id>", "TG_API_HASH": "<your-api-hash>" } } } }

스타 역사