Telegram MCP로 Claude Code에 명령하기 — 클로드 봇 만든 방법

이게 뭔가

@my_claude_bot에 텔레그램으로 메시지를 보내면:

1. Claude Code가 메시지를 받아서
2. 실제 코드 파일을 수정하고
3. Git 커밋 후 GitHub push
4. Cloudflare Pages 자동 배포

텔레그램에서 글 내용 지시 → 실제 블로그 포스트 게재까지 자동으로 됩니다.

이 포스트도 텔레그램으로 지시해서 만들어진 겁니다.

---

MCP가 뭔가

MCP(Model Context Protocol)는 Claude Code에 외부 도구를 연결하는 규격입니다. 파일 시스템, 브라우저, Slack, Telegram 같은 것들을 Claude Code가 직접 다룰 수 있게 해줍니다.

공식 Claude Code에서 지원하는 MCP 서버들이 있고, 커뮤니티 제작 플러그인도 있습니다.

Telegram MCP 플러그인을 쓰면:

• Claude Code가 Telegram 메시지를 수신
• Claude Code가 Telegram으로 응답 발송
• Claude Code의 모든 기능(파일 수정, 터미널 명령, Git 등)을 Telegram에서 제어

---

설정 방법

1. Telegram Bot 생성

1. Telegram에서 @BotFather 검색
2. /newbot 명령
3. 봇 이름과 username 입력
4. Bot Token 발급받기 (이 토큰은 절대 공개하면 안 됨)

2. Claude Code MCP 플러그인 설치

Claude Code 설정 파일(claude_desktop_config.json 또는 .claude/settings.json)에 MCP 서버 추가:

{
  "mcpServers": {
    "telegram": {
      "command": "node",
      "args": ["/path/to/telegram-mcp/index.js"],
      "env": {
        "TELEGRAM_BOT_TOKEN": "your-bot-token-here",
        "ALLOWED_CHAT_IDS": "-123456789,987654321"
      }
    }
  }
}

ALLOWED_CHAT_IDS: 허용할 채팅방 ID만 지정합니다. 보안상 필수.

3. 채팅방 ID 확인

1. 봇을 원하는 그룹에 초대
2. 그룹에 아무 메시지나 보내기
3. https://api.telegram.org/bot{TOKEN}/getUpdates 에서 chat.id 확인

그룹 채팅방 ID는 음수입니다 (예: -5100xxxxxx).

---

실제 사용 방법

텔레그램에서 @my_claude_bot을 멘션하면 Claude Code가 받습니다.

@my_claude_bot 오늘 배운 거 포스트로 써줘

Claude Code가 응답합니다. 파일을 만들거나 수정하고, 커밋하고, 배포합니다.

---

겪었던 문제들

문제 1: 세션 재시작 시 연결 끊김

Claude Code를 재시작하면 Telegram MCP 플러그인도 재시작됩니다. Long-polling 방식이라 재시작 후 연결 복원까지 수 초 걸립니다.

해결: Claude Code 앱 재시작 → 플러그인 자동 재연결. 대기 후 다시 메시지 보내면 됩니다.

문제 2: 대화 맥락 유실

Claude Code 세션이 끊기면 이전 대화 내용을 모릅니다. 맥락을 파일에 저장해두고 새 세션 시작 시 읽게 했습니다 (JARVIS_STATE.md).

새 세션 시작 후:

@my_claude_bot JARVIS_STATE.md 읽어서 상태 파악해

이렇게 하면 이전에 뭘 했는지 바로 복기됩니다.

문제 3: 여러 봇과 멘션 혼동

같은 그룹에 봇이 7개 있습니다. @my_claude_bot을 명시적으로 멘션하지 않으면 다른 봇들도 응답합니다.

해결: 멘션 필터. 특정 봇은 자기 username이 멘션된 메시지만 처리하도록 코드에서 걸러냅니다.

---

보안 주의사항

• Bot Token은 절대 코드에 하드코딩 금지 (환경변수로)
• ALLOWED_CHAT_IDS로 허용 채팅방 제한 필수
• 봇이 할 수 있는 파일 경로 제한 (민감한 시스템 폴더 접근 차단)
• Git push 같은 돌이키기 어려운 작업은 확인 절차 추가

---

결과

텔레그램 하나로 PC 앞에 없어도 Claude Code를 제어합니다. 외출 중에도 “이 포스트 써줘”라고 보내면 알아서 씁니다.

이 포스트 자체가 그 예시입니다.