📱 "AI가 나한테 먼저 말을 건다고요?" — Claude + 텔레그램 연동 이야기
여러분, 이런 상상 해본 적 있으세요?
"내가 시키지도 않았는데... AI가 먼저 카톡처럼 메시지를 보내온다면?"
보통 우리가 AI를 쓸 때는 내가 먼저 말을 걸어야 했잖아요. ChatGPT든, Claude든 내가 질문하면 대답하는 구조였죠. 그런데 오늘 우리가 만들 건 그것과 반대예요. AI가 먼저 나한테 메시지를 보내는 것!
예를 들면 이런 거예요:
- 📊 "오늘 작업 완료했어요! 파일 3개 정리됐습니다."
- ⚠️ "에러가 발생했어요. 확인해주세요!"
- ✅ "요청하신 보고서 작성 완료!"
이게 바로 Claude Code + Telegram 연동이에요. Claude가 일하다가 중요한 순간마다 내 텔레그램으로 보고를 하고, 나는 텔레그램에서 명령을 내릴 수도 있어요. 마치 AI 비서를 한 명 고용한 것처럼요! 😄
코딩 몰라도 괜찮아요. 이 포스트에서 처음부터 끝까지 같이 해볼 거니까요. 자, 시작해봐요!
[이미지1: Claude와 Telegram이 연결되는 개념 도식 - 스마트폰으로 메시지 오는 장면]🧩 전체 구조 먼저 이해하기
설정 들어가기 전에, "이게 어떻게 돌아가는 건지" 큰 그림을 잡아봐요. 어렵지 않아요!
- Claude Code가 내 컴퓨터에서 작업을 해요
- 작업 중에 보고할 게 생기면 Telegram으로 메시지를 보내요
- 나는 스마트폰 텔레그램으로 결과를 확인해요
- 필요하면 텔레그램에서 다음 명령을 내릴 수도 있어요
이 모든 연결고리 역할을 하는 게 바로 MCP(Model Context Protocol)예요. MCP는 Claude가 외부 서비스(여기서는 텔레그램)와 대화할 수 있게 해주는 "통역사" 같은 존재예요. 이전 스텝에서 MCP 개념을 배웠다면 더 친숙하게 느껴지실 거예요! 😊
[이미지2: Claude → MCP → Telegram Bot → 사용자 스마트폰으로 이어지는 흐름도]📋 준비물 체크리스트
시작 전에 이것들이 준비되어 있는지 확인해요:
- ✅ Claude Code 설치 완료 (이전 스텝 참고)
- ✅ 텔레그램 앱 설치 (스마트폰 또는 PC)
- ✅ 텔레그램 계정 (없으면 무료로 만들 수 있어요)
- ✅ Node.js 설치 (터미널에서
node --version치면 버전 나오면 OK)
💡 알아두면 좋아요!
텔레그램은 카카오톡처럼 무료 메신저예요. 특히 Bot(봇) 기능이 매우 강력해서 개발자들이 자동화할 때 많이 써요. 오늘 우리도 Claude 전용 봇을 하나 만들 거예요!
🤖 Step 1: 텔레그램 봇 만들기
텔레그램에는 BotFather라는 특별한 봇이 있어요. 이 봇한테 말을 걸면 새로운 봇을 만들어줘요. 신기하죠? 봇이 봇을 만드는 거예요! 😄
① BotFather 찾기
- 텔레그램 앱을 열어요
- 검색창에 @BotFather 를 검색해요
- 파란 체크마크(✔️)가 있는 공식 BotFather를 선택해요
- /start 를 입력해서 대화를 시작해요
② 새 봇 만들기
- /newbot 을 입력해요
- 봇의 이름을 입력해요 (예:
My Claude Assistant) - 봇의 username을 입력해요 — 반드시 bot으로 끝나야 해요!
예:my_claude_helper_bot - 성공하면 이런 메시지가 와요:
Done! Congratulations on your new bot.
...
Use this token to access the HTTP API:
1234567890:ABCdefGHIjklMNOpqrsTUVwxyz
Keep your token secure and store it safely!이 Token(토큰) 이 엄청 중요해요! 어딘가 메모장에 복사해두세요. 이게 있어야 봇을 제어할 수 있어요.
⚠️ 주의사항!
토큰은 절대 다른 사람한테 알려주면 안 돼요. 마치 인터넷 뱅킹 비밀번호처럼 소중하게 다뤄야 해요! 깃허브 같은 곳에 올리지 않도록 주의하세요.
③ 내 Chat ID 알아내기
봇이 누구한테 메시지를 보낼지 알아야겠죠? 그게 바로 Chat ID예요.
- 텔레그램에서 @userinfobot 을 검색해요
- /start 입력하면 내 Chat ID를 알려줘요
- 숫자로 된 ID를 메모해두세요 (예:
987654321)
⚙️ Step 2: Claude Code에 MCP Telegram 설정하기
이제 Claude Code가 텔레그램 봇을 사용할 수 있도록 설정해줄 거예요. 여기서 재미있는 부분이 나와요. 이 설정 파일 자체도 Claude한테 만들어달라고 했어요! Claude가 자기 자신의 설정을 만드는 거죠 😄
① MCP 설정 파일 열기
Claude Code의 MCP 설정 파일은 보통 이 위치에 있어요:
# Mac/Linux
~/.claude/claude_desktop_config.json
# Windows
C:\Users\사용자이름\AppData\Roaming\Claude\claude_desktop_config.json이 파일을 메모장이나 VS Code로 열어요.
② Telegram MCP 설정 추가하기
파일 안에 아래 내용을 추가해요. (기존에 다른 MCP가 있다면 쉼표로 구분해서 추가해요)
{
"mcpServers": {
"telegram": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-telegram"
],
"env": {
"TELEGRAM_BOT_TOKEN": "여기에_봇_토큰_입력",
"TELEGRAM_CHAT_ID": "여기에_Chat_ID_입력"
}
}
}
}여기에_봇_토큰_입력 부분에 아까 BotFather한테 받은 토큰을, 여기에_Chat_ID_입력에 내 Chat ID를 넣으면 돼요!
③ Claude Code 재시작
설정 파일을 저장한 다음, Claude Code를 완전히 종료했다가 다시 시작해요. 그래야 새 설정이 적용돼요.
💡 잠깐, 이거 Claude한테 시켰어요!
솔직히 말하면, 이 설정 파일 구조도 Claude한테 "텔레그램 MCP 설정 파일 만들어줘"라고 했더니 뚝딱 만들어줬어요. 코드 하나하나 외울 필요 없이, Claude한테 부탁하면 돼요. AI가 AI를 설정하는 시대가 된 거죠! 🎉
💬 Step 3: Claude가 텔레그램으로 보고하는 구조 만들기
이제 실제로 Claude가 작업하면서 텔레그램으로 메시지를 보내게 해볼 거예요!
Claude에게 이렇게 말해봐요:
지금부터 작업할 때마다 텔레그램으로 진행상황을 보고해줘.
작업 시작할 때, 완료할 때, 에러 났을 때 각각 메시지 보내줘.그러면 Claude가 자동으로 텔레그램 MCP 도구를 사용해서 메시지를 보내요. 실제로 이런 방식으로 동작해요:
# Claude가 내부적으로 이런 식으로 메시지를 보내요:
telegram.send_message(
chat_id="987654321",
text="🚀 작업 시작합니다! 파일 분석 중..."
)
# ... 작업 수행 ...
telegram.send_message(
chat_id="987654321",
text="✅ 완료! 총 5개 파일 처리했어요."
)물론 이 코드를 직접 입력할 필요는 없어요. Claude가 알아서 처리해줘요!
[이미지4: 텔레그램으로 Claude의 작업 보고 메시지가 오는 스마트폰 화면]📲 Step 4: 텔레그램에서 명령 내리기
이건 한 단계 더 나아간 기능이에요. 텔레그램에서 내가 명령을 보내면 Claude가 받아서 실행하는 거예요!
간단한 명령어 봇 만들기
Claude한테 이렇게 부탁해봐요:
텔레그램에서 명령을 받아서 실행하는 간단한 스크립트 만들어줘.
/status 라고 보내면 현재 상태를 알려주고,
/help 라고 보내면 사용 가능한 명령어 목록을 보여주는 거야.그러면 Claude가 이런 스크립트를 만들어줘요:
// telegram_bot.js - Claude가 만들어준 스크립트!
const TelegramBot = require('node-telegram-bot-api');
const token = process.env.TELEGRAM_BOT_TOKEN;
const bot = new TelegramBot(token, { polling: true });
// /help 명령어
bot.onText(/\/help/, (msg) => {
const chatId = msg.chat.id;
bot.sendMessage(chatId,
"📋 사용 가능한 명령어:\n" +
"/status - 현재 상태 확인\n" +
"/help - 도움말\n" +
"/report - 오늘 작업 보고서"
);
});
// /status 명령어
bot.onText(/\/status/, (msg) => {
const chatId = msg.chat.id;
bot.sendMessage(chatId, "✅ 시스템 정상 작동 중입니다!");
});
console.log("봇 시작됨! 텔레그램에서 명령을 보내보세요.");
이 파일을 실행하려면 터미널에서:
# 먼저 필요한 패키지 설치
npm install node-telegram-bot-api
# 봇 실행
node telegram_bot.js💡 이것도 Claude한테 만들어달라고 했어요!
위 코드 한 줄도 제가 직접 안 짰어요. Claude한테 "텔레그램 봇 명령어 처리 스크립트 만들어줘"라고 했더니 완성된 코드를 바로 줬거든요. 그냥 복사해서 실행하면 끝이에요. 이게 AI 자동화의 핵심이에요! 🙌
🧪 Step 5: 실제 동작 테스트
설정이 다 됐으면 실제로 테스트해봐요! 두근두근하죠? 😄
테스트 1: Claude가 텔레그램으로 메시지 보내기
Claude Code에서 이렇게 말해봐요:
텔레그램으로 "테스트 메시지입니다. 연결 성공!" 이라고 보내줘.그러면 몇 초 안에 내 텔레그램에 메시지가 와야 해요! 메시지가 오면 연동 성공이에요 🎉
테스트 2: 작업 + 보고 같이 하기
현재 폴더의 파일 목록을 확인하고,
결과를 텔레그램으로 보고해줘.이렇게 하면 Claude가 파일을 확인하고, 결과를 텔레그램으로 쏴줘요.
테스트 3: 텔레그램에서 명령 보내기
봇 스크립트가 실행 중인 상태에서, 텔레그램 앱에서 내 봇한테 메시지를 보내봐요:
/help봇이 명령어 목록을 보내준다면 완벽하게 동작하는 거예요!
[이미지5: 테스트 결과 - 텔레그램 채팅창에 Claude의 응답이 오는 화면]⚠️ 잘 안 될 때 체크해보세요!
- 토큰이 맞게 입력됐는지 확인해요
- Chat ID가 정확한지 확인해요
- Claude Code를 재시작했는지 확인해요
- 인터넷 연결 상태를 확인해요
- 봇한테 먼저 /start 를 보냈는지 확인해요 (봇은 먼저 대화를 시작해야 메시지를 받을 수 있어요)
🌟 실제 활용 아이디어
이제 Claude + Telegram 연동이 됐으니까, 어떻게 쓸 수 있을지 아이디어를 나눠볼게요!
- 📁 파일 작업 완료 알림 — 대용량 파일 처리가 끝나면 알려줘요
- 📊 일일 업무 보고서 — 매일 오전 9시에 오늘 할 일 목록 전송
- 🛒 쇼핑몰 재고 알림 — 특정 상품 재고가 떨어지면 알림
- 🌐 웹사이트 모니터링 — 사이트가 다운되면 즉시 알림
- 💰 가격 추적 — 원하는 가격이 되면 알림
이 모든 걸 Claude한테 "이렇게 이렇게 해줘"라고 말하면 설정해줘요. 진짜 AI 비서가 생긴 거예요! 🤖
🎓 오늘 배운 것 정리
- 📱 텔레그램 BotFather로 봇을 만들고 토큰을 받았어요
- ⚙️ Claude Code MCP 설정에 Telegram을 연결했어요
- 📤 Claude가 먼저 텔레그램으로 보고하는 구조를 만들었어요
- 📥 텔레그램에서 Claude에게 명령을 내리는 방법도 알아봤어요
- ✅ 실제 동작 테스트까지 완료했어요
어때요? 생각보다 어렵지 않죠? 그리고 솔직히 말하면, 이 블로그 포스트에 나온 코드들과 설정 파일들... 전부 Claude한테 "이렇게 만들어줘"라고 부탁해서 나온 것들이에요. 제가 직접 코드를 짠 게 아니라, Claude가 다 해준 걸 제가 정리한 거예요. 이게 바로 AI 자동화의 힘이죠! 💪
👉 다음 스텝 예고
다음 편에서는 더 흥미로운 걸 해볼 거예요!
[Step 07] Claude Code + 스케줄러 연동 — AI가 혼자 알아서 일한다
매일 정해진 시간에 Claude가 혼자 일어나서, 할 일을 하고, 텔레그램으로 보고까지 하는 완전 자동화 시스템을 만들어볼 거예요. 퇴근하고 자는 동안에도 AI가 일하고 있다면 어떨까요? 😏
이 포스트가 도움이 됐다면 댓글로 "성공했어요!" 라고 남겨주세요! 안 됐다면 어디서 막혔는지 알려주시면 같이 해결해봐요. 우리 같이 AI 자동화 고수가 되어봐요! 🚀