텔레그램 MCP 서버
이 서버는 Telegram API와 AI 어시스턴트를 연결하는 다리 역할을 하며 Model Context Protocol을 기반으로 합니다.
[!중요] 이 서버를 사용하기 전에 Telegram API 서비스 약관을 읽고 이해했는지 확인하십시오. Telegram API를 오용할 경우 계정이 정지될 수 있습니다.
목차
Related MCP server: Twitch MCP Server
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/binPATH에서 원하는 디렉터리로 바꾸세요.
먼저, 아키텍처에 맞는 아카이브를 다운로드하세요.
그런 다음 바이너리를 설치하세요.
리눅스
참고: 아래 명령어는
/usr/local/bin에 설치됩니다. 다른 곳에 설치하려면/usr/local/binPATH에서 원하는 디렉터리로 바꾸세요.
먼저, 아키텍처에 맞는 아카이브를 다운로드하세요.
그런 다음 바이너리를 설치하세요.
윈도우
윈도우
아키텍처에 맞는 최신 릴리스를 다운로드하세요:
.zip파일을 추출합니다추출된 디렉토리를 PATH에 추가하거나
telegram-mcp.exePATH의 디렉토리로 이동합니다.
출처에서
요구 사항:
1.24 이상으로 가세요
PATH의 GOBIN
구성
권한 부여
서버를 사용하려면 먼저 Telegram API에 연결해야 합니다.
Telegram API 에서 API ID와 해시를 가져옵니다.
다음 명령을 실행하세요.
참고: 2FA가 활성화된 경우 --password <2fa_password>를 추가하세요.
참고: 기존 세션을 재정의하려면 --new를 추가하세요.
telegram-mcp auth --app-id <your-api-id> --api-hash <your-api-hash> --phone <your-phone-number>📩 Telegram에서 받은 코드를 입력하여 API에 연결하세요.
완료되었습니다! 이 프로젝트의 발전을 위해 ⭐️를 눌러주세요.
클라이언트 구성
Telegram MCP 서버를 인식하도록 Claude Desktop을 구성하는 예입니다.
Claude Desktop 구성 파일을 엽니다.
MacOS에서는 구성 파일이
~/Library/Application Support/Claude/claude_desktop_config.json에 있습니다.Windows에서 구성 파일은
%APPDATA%\Claude\claude_desktop_config.json에 있습니다.
참고: Claude Desktop 앱 설정 내부에서도 claude_desktop_config.json을 찾을 수 있습니다.
서버 구성 추가
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>" } } } }