telegram-slack-mcp

Claude에 실제 채팅을 연결하세요.

Claude의 개인 Telegram 및 Slack 계정에 연결하는 두 개의 MCP 서버 — 봇 받은 편지함이 아니라 여러분의 실제 DM, 그룹, 채널을 다룹니다.

claude mcp add telegram -- npx -y telegram-slack-mcp telegram
claude mcp add slack    -- npx -y telegram-slack-mcp slack

그런 다음 그냥 말하세요:

"실제 사람들이 보낸 텔레그램에서 안 읽은 메시지가 뭐야?" "Priya와 나눈 지난 30개 메시지를 읽고 답장 초안을 작성해 줘" "배포 포스트모템을 찾으려고 내 모든 Slack 워크스페이스를 검색해 줘"

존재 이유

대부분의 Telegram 통합은 Bot API를 사용합니다. Bot API는 여러분이 만든 봇에게 보낸 메시지만 볼 수 있습니다. 기존의 대화를 읽을 수는 없습니다. telegram-slack-mcp는 공식 앱에서 사용하는 것과 동일한 프로토콜인 MTProto를 사용해 여러분의 신원으로 인증합니다. 그래서 Claude는 실제로 여러분이 가진 채팅을 볼 수 있는 겁니다.

Slack은 일반적인 커넥터가 하나의 워크스페이스로만 제한됩니다. telegram-slack-mcp는 워크스페이스마다 사용자 토큰을 하나씩 받아 하나의 표면으로 취급하므로 "모든 곳에서 검색"은 정말 모든 곳을 의미합니다.

Related MCP server: google-chat-mcp

설치

이미 가지고 있는 런타임을 선택하세요. 둘 다 동일한 도구를 제공합니다.

Node

claude mcp add telegram -- npx -y telegram-slack-mcp telegram
claude mcp add slack    -- npx -y telegram-slack-mcp slack

Python

claude mcp add telegram -- uvx telegram-slack-mcp telegram
claude mcp add slack    -- uvx telegram-slack-mcp slack

Claude Code 플러그인

/plugin marketplace add nileshpatil6/telegram-slack-mcp
/plugin install telegram@telegram-slack-mcp
/plugin install slack@telegram-slack-mcp

{
  "mcpServers": {
    "telegram": {
      "command": "npx",
      "args": ["-y", "telegram-slack-mcp", "telegram"],
      "env": { "TELEGRAM_API_ID": "1234567", "TELEGRAM_API_HASH": "your_hash" }
    },
    "slack": {
      "command": "npx",
      "args": ["-y", "telegram-slack-mcp", "slack"],
      "env": { "SLACK_USER_TOKENS": "xoxp-one,xoxp-two" }
    }
  }
}

설정

Telegram — 2분

1. https://my.telegram.org에 접속 → API 개발 도구 → 앱 생성.

2. api_id와 api_hash를 복사해서 설정하세요:

   claude mcp add telegram \
     -e TELEGRAM_API_ID=1234567 \
     -e TELEGRAM_API_HASH=your_hash \
     -- npx -y telegram-slack-mcp telegram

3. Claude에게 물어보세요: "텔레그램에 로그인해 줘, 내 전화번호는 +91…" Claude가 login_start를 호출하면, 텔레그램에서 인증 코드를 보냅니다. 이 코드를 붙여넣으면 login_complete를 호출합니다. 이 과정은 처음 한 번뿐입니다. 세션은 ~/.chat-mcp에 저장되어 영구 유지됩니다.

2FA를 사용 중인가요? 코드와 함께 클라우드 비밀번호를 Claude에게 알려주세요.

Slack — 5분

1. https://api.slack.com/apps에 접속 → 새 앱 만들기 → 매니페스트에서.

2. slack-app-manifest.yaml을 붙여넣으세요. 모든 권한 범위가 자동으로 채워집니다.

3. 워크스페이스에 설치를 누른 다음, User OAuth Token(xoxp-…, xoxb- 아님)을 복사하세요.

4. 원하는 각 워크스페이스에 대해 3단계를 반복. 같은 앱으로 워크스페이스마다 토큰 하나.

5. 쉼표로 구분해서 한 번에 모두 설정하세요:

   claude mcp add slack -e SLACK_USER_TOKENS=xoxp-aaa,xoxp-bbb -- npx -y telegram-slack-mcp slack

도구

Telegram

Slack

모든 Slack 도구는 선택적으로 workspace(이름의 일부 문자열)를 받습니다. 비워 두면 모든 워크스페이스에 걸쳐 동작합니다. 채널 이름이 둘 이상의 워크스페이스에 있을 때만 필요하며, 오류가 그중 어느 것인지 알려줍니다.

구성

발신 기능은 두 서버 모두 기본적으로 꺼져 있습니다. 읽기가 기본값이고 안전하며, 쓰기는 의도적으로 옵트인합니다.

개인정보

이 프로젝트가 소유한 어떤 서버에도 아무것도 전송되지 않습니다. 그런 서버는 존재하지 않습니다.

telegram-ai-mcp가 전적으로 여러분의 컴퓨터에서 실행됩니다. 이 서버가 만드는 유일한 네트워크 트래픽은 여러분의 자체 자격 증명을 사용하는 Telegram 및 Slack의 공식 API에 도달시키는 것입니다. 텔레메트리, 분석, 크래시 보안, 라이선스 확인, "전화 집"이 없습니다. 소스를 grep 해 보면 찾을 수 엔드포인트를 볼 수 없을 겁니다.

데이터 경로는 정확히 다음과 같습니다:

your machine  <-->  Telegram / Slack APIs      (your credentials, your account)
your machine  <-->  Claude                     (only what you ask Claude to read)

여러분의 자격 증명은 절대 Claude에 도달하지 않습니다. 세션 파일과 xoxp- 토큰은 ~/.chat-mcp와 환경 안에 남아 있으며, 서버는 이들을 로컬에서 사용해 API를 호출하고 메시지 자체만 건네줍니다.

Claude에게 실질적으로 전달되는 것은 여러분이 질문한 채팅 내용뿐입니다. 그것이 이 도구의 목적이기 때문입니다. Claude에게 대화를 읽어달라고 요청하면 그 대화는 Claude 대화로 들어가서, 여러분이 직접 붙여 넣은 텍스트와 똑같은 방식으로 Anthropic의 개인정보처리방침에 따라 다꾸어집니다. 다른 것은 읽지 않으며, 백그라운드에서도 아무것도 읽지 않습니다. 서버는 Claude가 도구를 호출할 때만 작동합니다.

이 프로젝트의 저자도 그 어떤 것도 볼 수 없습니다.

보안

이 부분은 꼭 읽으세요.

• 이들은 봇이 아니라 여러분으로서 행동합니다. 전송된 것은 모두 여러분 계정에서 온 것으로 표시되며, 그 채팅 상대는 그 차이를 알 수 없습니다.

• 저장된 세션은 전체 자격 증명입니다. ~/.chat-mcp/telegram.session과 여러분의 xoxp- 토큰은 당신으로 로그인한 것과 동일합니다. 복사한 사람은 여러분 계정을 갖게 됩니다. 이들은 기계 외부로 나가지 않으며, 여기에서는 아무함 인터넷 호출이 없습니다.

• Claude가 읽는 모든 것은 모델의 컨텍스트로 들어갑니다. 모델에 보내고 싶지 않은 데이터가 있는 계정에는 이 도구를 사용하지 마세요.

• Telegram은 이런 연결을 userbot이라고 부릅니다. 개인 계정을 자동화하는 것은 Telegram 서비스 이용약관에 제한됩니다. 가벼운 개인 해운 서신/답장 용도는 일반적이고 위험 낮으며, 대량 자동화하면 계정이 정지될 수 있습니다. 선택은 당신의 것, 계정도 당신의 것.

• 언제든지 공개할 수 있습니다: Telegram → 설정 → 기기, 또는 Slack의 앱 설정에서 토큰을 삭제하세요. ~/.chat-mcp를 삭제하면 로컬 세션이 사라집니다.

문제 해결

"Telegram not logged in yet" — 로그인 절차를 실행하세요. Claude에게 전화번호로 로그인을 요청하세요. 그 이후는 유지됩니다. 계속 나타나면 CHAT_MCP_DATA_DIR이 쓰기 가능한지 확인하세요.

"Missing Telegram credentials" — TELEGRAM_API_ID / TELEGRAM_API_HASH가 서버에 전달되지 않았습니다. claude mcp add, -e 플래그에 함께 전달하세요.

Slack이 전혀 반환하지 않음 — 거의 확실히 빈 워크스페이스 또는 잘못적 워크스페이스에 대해 권한이 활성화된 것입니다. whoami를 실행하여 실제 연결된 워크스페이스가 무엇인지 확인하세요.

"#general" exists in several workspaces — workspace를 전달해 구분하세요. 오류에서 동선이 안내합니다.

Slack 검색에서 not_allowed_token_type 반환 — 봇 토큰(xoxb-)을 사용하고 있습니다. User OAuth 토큰(xoxp-)이 필요합니다.

개발

git clone https://github.com/nileshpatil6/telegram-slack-mcp
cd telegram-slack-mcp
npm install && npm run build
node dist/cli.js telegram        # run the server on stdio

cd python && python -m build     # build the Python distribution

라이선스

MIT