AI 에이전트로 Telegram 그룹 관리하는 방법 (Claude, ChatGPT, Cursor)
MCP를 통해 AI 에이전트가 Telegram 그룹에서 게시, 관리, 토픽 관리, 리포트를 맡도록 하는 실전 가이드입니다. 바로 복사해 쓸 수 있는 프롬프트와 꼭 지켜야 할 안전장치도 함께 소개합니다.
실시간 디렉토리
Metricgram의 엄선된 Telegram 디렉토리에서 카테고리와 언어별로 활발한 커뮤니티를 찾아보고, 주요 그룹들이 목록을 어떻게 구성하는지 확인하세요.
디렉토리 열기챗봇에서 커뮤니티 운영자로
오늘날 Telegram의 "AI"는 대부분 그룹 안에서 질문에 답하는 챗봇입니다. 유용하긴 하지만 일의 절반에 불과합니다. 커뮤니티 매니저는 대부분의 시간을 운영 업무에 씁니다. 공지, 고정, 토픽, 관리, 초대 링크, 리포트 같은 일들입니다.
MCP로 연결된 AI 에이전트 는 이런 운영 업무를 대신 처리할 수 있습니다. 원하는 결과를 평소 말투로 설명하면 에이전트가 알맞은 Telegram 작업을 고르고, Metricgram이 올바른 그룹에서 실행합니다.
준비물
- Metricgram에 연결되어 있고 봇이 관리자로 설정된 Telegram 그룹.
- Metricgram 플랜(종류 무관) 또는 진행 중인 무료 체험.
- Claude Code, Claude Desktop, Cursor, Codex처럼 MCP를 지원하는 AI 클라이언트.
Telegram 그룹을 개선할 준비가 되셨나요? Metricgram 14일 체험을 시작하세요.
무료 체험 시작1단계: 에이전트 연결 방식 정하기
가장 쉬운 방법은 OAuth입니다. Claude 또는 OAuth를 지원하는 MCP 클라이언트에서 https://metricgram.com/api/v1/mcp를 커스텀 커넥터로 추가하고, Metricgram에 로그인한 뒤 액세스를 승인하세요. 클라이언트가 OAuth를 지원하지 않는다면 에이전트에 필요한 권한 범위만 담은 API 키를 만드세요.
관리자 대시보드에서 API 키 를 열고 에이전트용 키를 만드세요. 처음에는 좁게 시작하고 나중에 넓히는 것이 좋습니다.
| 에이전트 업무 | 권한 범위 |
|---|---|
| 리서치와 리포트 |
telegram:read, analytics:read, members:read, messages:read
|
| 공지와 토픽 |
telegram:write 추가 |
| 관리 |
telegram:moderate 추가 |
| 채팅 설정과 초대 링크 |
telegram:admin 추가 |
에이전트마다 키를 하나씩 만들 수 있고, 어떤 키든 즉시 취소할 수 있습니다.
2단계: AI 클라이언트 연결하기
관리자 대시보드의 MCP 페이지를 열고 사용하는 클라이언트용 스니펫을 복사하세요. HTTP를 지원하는 클라이언트라면 https://metricgram.com/api/v1/mcp를 가리키고 Authorization 헤더에 키를 넣은 블록 하나면 충분합니다. 클라이언트를 다시 시작하고 도구 목록을 보여 달라고 해 보세요. send_telegram_message, manage_forum_topic, telegram_bot_api 같은 도구가 보여야 합니다.
3단계: 읽기 전용 질문부터 시작하기
에이전트에게 행동을 맡기기 전에 먼저 둘러보게 하세요.
- "내 Telegram 그룹과 각 그룹의 멤버 수를 알려 줘."
- "지난 30일 동안 Crypto Talk에서 가장 활발한 멤버는 누구야?"
- "이번 주에 사람들이 물어본 주요 질문을 요약해 줘."
- "현재 채팅 권한과 관리자를 보여 줘."
이렇게 하면 에이전트가 내 그룹을 제대로 이해하고 있다는 확신을 가질 수 있습니다.
4단계: 반복 작업 맡기기
익숙해지면 실제 업무를 맡겨 보세요. 효과가 좋은 프롬프트 예시입니다.
공지
Crypto Talk의 Announcements 토픽에 이 공지를 올리고, 이벤트 페이지를 여는 "등록하기" 버튼을 추가한 뒤 알림 없이 고정해 줘.
토픽 관리
"Signals", "Education", "Off-topic"이라는 토픽을 만들고 예전 "Random" 토픽은 닫아 줘.
투표
Education 토픽에서 이번 주 수업에 대한 4지선다 퀴즈를 진행하고 10분 뒤에 마감해 줘.
관리
지난 1시간 동안의 스팸 메시지를 삭제하고 보낸 사람이 24시간 동안 링크를 올리지 못하도록 제한해 줘.
초대 링크
멤버 50명으로 제한되고 이번 달 말에 만료되는 "Partner March"라는 이름의 초대 링크를 만들어 줘.
가입 요청
이메일이 활성 구독자와 일치하는 사용자의 대기 중인 가입 요청은 승인하고 나머지는 거절해 줘.
요청이 타입 지정 도구에 맞지 않을 때는 에이전트가 telegram_bot_api로 지원되는 Bot API 메서드를 사용할 수 있습니다. 먼저 telegram_api_methods를 호출해 키에서 허용된 작업을 확인할 수도 있습니다.
꼭 지켜야 할 안전장치
AI 에이전트는 강력하므로 몇 가지 습관을 지키세요.
-
위험도별로 키를 분리하세요. 리포트용 에이전트가
telegram:admin을 가져서는 안 됩니다. - 먼저 계획을 요청하세요. 대량 관리 작업에서는 삭제하기 전에 무엇을 삭제할지 목록으로 보여 달라고 하세요.
- 멱등성 키를 사용하세요. 자동화 파이프라인에서 재시도로 인한 중복 게시를 막아 줍니다.
- 각 키의 마지막 사용 시점을 확인하고 더 이상 필요 없는 키는 취소하세요.
- 민감한 결정은 사람이 내리세요. 오래된 멤버 차단이나 권한 변경 같은 일이 그렇습니다.
Metricgram도 자체 안전장치를 갖추고 있습니다. 에이전트는 내 그룹에만 접근할 수 있고, 전달과 인용은 내 채팅과 대조해 검사하며, 콜백 버튼과 유료 브로드캐스트는 차단되고, 차단 해제 시 현재 멤버가 제거되는 일도 없습니다.
커스텀 봇과 무엇이 다른가요
직접 봇을 만들어 에이전트 프레임워크에 연결할 수도 있습니다. 그러려면 호스팅, 웹훅 처리, 토큰 저장, 엔드포인트별 도구, 테넌트 검사, 속도 제한 처리, 로깅이 필요합니다. Metricgram에서는 이 모든 것이 이미 돌아가고 있고, 에이전트는 같은 서버에서 분석, 멤버 기록, AI 요약, 구독자 상태까지 얻을 수 있습니다.
다음 단계
Telegram MCP 서버 페이지에서 서버로 할 수 있는 모든 것을 확인하거나 MCP 기능 개요를 읽어 보세요. 기술적인 배경이 궁금하다면 보안 모델을 자세히 설명한 Telegram MCP 서버 글을 참고하세요.
주간 Telegram 커뮤니티 팁 받기
최고의 팁, 가이드, 제품 업데이트를 받는 커뮤니티 매니저들과 함께하세요.
다음 글도 확인해보세요
교육자를 위한 텔레그램: LMS를 대체하지 않고 코호트, 학생 커뮤니티, 오피스 아워 운영하기
텔레그램은 강의나 교육 비즈니스 주변의 라이브 레이어로 활용될 때 교육자에게 매우 적합합니다. 이 가이드는 코호트, 학생 커뮤니티, 오피스 아워, 지원을 LMS 대체 없이 운영하는 방법을 설명합니다.
Telegram MCP 서버: AI 에이전트에게 Telegram Bot API 전체를 안전하게 제공하는 방법
Telegram MCP 서버란 무엇인지, AI 에이전트를 위해 Telegram Bot API를 래핑하는 일이 왜 생각보다 어려운지, 그리고 Metricgram이 70개 이상의 Bot API 메서드를 안전하고 그룹 단위로 제한된 MCP 도구로 제공하는 방법을 알아봅니다.