AI 에이전트를 위한 Telegram MCP 서버

Metricgram은 Telegram Bot API를 호스팅형 MCP 서버로 제공합니다. 권한이 지정된 키로 AI 에이전트가 Telegram 그룹을 읽고, 게시하고, 관리하고, 운영할 수 있으며 유지보수할 봇 코드는 없습니다.

  • 70개 이상의 Telegram Bot API 메서드를 MCP 도구로 제공
  • Claude, ChatGPT, Cursor, Codex와 호환
  • 모든 호출은 내 그룹으로만 제한
  • 분석, 멤버, 구독자 데이터까지 한 서버에서
무료 체험 시작
신용카드 불필요 2분 만에 설정 완료

작동 방식

1

봇을 추가하고 그룹 연결하기

Metricgram 봇(또는 직접 만든 커스텀 봇)을 Telegram 그룹에 관리자로 추가하세요. 서버, 웹훅, 폴링을 운영할 필요가 없습니다.

2

권한이 지정된 API 키 만들기

Elite API 키를 생성하고 에이전트가 할 수 있는 작업을 정확히 선택하세요. Telegram 읽기 전용 액세스부터 게시, 관리, 채팅 설정까지 지정할 수 있습니다.

3

AI 클라이언트에 연결하기

Claude, Cursor, Codex 또는 모든 MCP 클라이언트에 설정 블록 하나만 붙여 넣으세요. 이제 에이전트는 허용된 모든 Telegram 작업을 도구로 인식합니다.

프롬프트 하나로 실제 Telegram 작업을

에이전트가 알맞은 Bot API 호출을 선택하면 Metricgram이 올바른 그룹에서 실행하고 구조화된 결과를 돌려줍니다.

metricgram · mcp

요청

Crypto Talk에 이번 주 AMA 공지를 올리고, 알림 없이 고정한 다음, 'AMA 질문' 토픽을 열고 금요일에 만료되는 초대 링크를 만들어 줘.

에이전트 호출

  • send_telegram_message(group_id: 42, text: "…", buttons: [{ url: "…" }])
  • pin_telegram_message(group_id: 42, action: "pin", disable_notification: true)
  • manage_forum_topic(group_id: 42, action: "create", name: "…")
  • create_telegram_invite_link(group_id: 42, expire_date: "2026-10-23T23:59:00Z")

모든 MCP 클라이언트 연결

API 키와 함께 호스팅 엔드포인트를 사용하세요. Claude Desktop 사용자는 mcp-remote로 연결할 수 있습니다.

{
  "mcpServers": {
    "metricgram": {
      "url": "https://metricgram.com/api/v1/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

에이전트가 사용하는 도구

메시지와 미디어

send_telegram_message send_telegram_media send_telegram_poll edit_telegram_message delete_telegram_messages forward_telegram_message react_to_telegram_message

고정 메시지와 포럼 토픽

pin_telegram_message manage_forum_topic createForumTopic closeGeneralForumTopic unpinAllForumTopicMessages

관리와 가입 요청

ban_member restrict_member promote_member handle_telegram_join_request banChatSenderChat setChatAdministratorCustomTitle

채팅 설정과 초대 링크

update_telegram_chat_settings create_telegram_invite_link revokeChatInviteLink setChatPermissions setChatStickerSet

분석과 커뮤니티 데이터

analytics_overview active_users list_members list_messages gamification_rankings get_subscriber_health

지원되는 모든 Bot API 메서드

telegram_api_methods telegram_bot_api get_telegram_chat get_telegram_chat_member

AI 에이전트를 위해 래핑된 Telegram Bot API

에이전트용 Telegram 연동을 만들려면 보통 봇 호스팅, 웹훅 처리, 토큰 보관, 엔드포인트마다 도구 작성이 필요합니다. Metricgram 봇은 이미 여러분의 그룹 안에서 실행 중이므로, 에이전트는 하나의 호스팅 엔드포인트에서 바로 쓸 수 있는 MCP 도구로 Bot API를 사용합니다.
01

타입이 지정된 도구와 전체 Bot API 게이트웨이

메시지, 미디어, 투표, 고정, 토픽, 초대 링크처럼 자주 쓰는 작업에는 설명이 잘 갖춰진 전용 도구가 있습니다. 그 밖의 작업은 공식 Bot API 메서드 이름과 파라미터를 그대로 받는 telegram_bot_api로 처리하므로, 지원 카탈로그의 모든 기능을 사용할 수 있습니다.
02

내 그룹으로만 제한

에이전트는 chat_id를 직접 고르지 않습니다. Metricgram이 여러분이 소유한 그룹에서 chat_id를 도출하고, 전달되거나 인용된 메시지가 여러분의 다른 그룹에서 온 것인지 확인하며, 다른 채팅에 닿을 수 있는 작업은 모두 거부합니다.
03

신뢰 수준별 권한 범위

리서치 에이전트에는 telegram:read, 게시와 토픽에는 telegram:write, 차단과 가입 요청에는 telegram:moderate, 직함, 권한, 초대 링크에는 telegram:admin을 부여하세요. 키는 언제든지 취소할 수 있습니다.
04

안전한 재시도와 명확한 오류

쓰기 도구는 멱등성 키를 지원하므로 재시도해도 중복 게시되지 않습니다. Telegram 오류와 속도 제한은 retry_after가 포함된 구조화된 결과로 반환되어 에이전트가 스스로 처리할 수 있습니다.
05

일반 봇에는 없는 컨텍스트

같은 서버에서 Metricgram 분석, 멤버 기록, 수집된 메시지, 게이미피케이션, AI 요약, Stripe 구독자 상태까지 제공하므로 에이전트가 행동하기 전에 무엇을 할지 판단할 수 있습니다.

Metricgram vs. 수동 관리

Metricgram 수동
호스팅 MCP 엔드포인트, 봇 서버 운영 불필요
70개 이상의 Telegram Bot API 메서드를 도구로 제공
chat_id를 내 그룹으로 고정
권한 범위별로 취소 가능한 API 키
쓰기 도구의 멱등 재시도
컨텍스트를 위한 분석과 멤버 기록
실시간 채팅 데이터, 관리자, 권한
직접 만든 커스텀 봇과 호환

자주 묻는 질문

Telegram MCP 서버란 무엇인가요?
Telegram 작업을 AI 에이전트가 호출할 수 있는 도구로 제공하는 Model Context Protocol 서버입니다. Metricgram은 이미 여러분의 그룹을 관리하는 봇을 기반으로 이 서버를 호스팅합니다.
어떤 AI 클라이언트와 함께 쓸 수 있나요?
HTTP로 MCP를 지원하는 모든 클라이언트에서 사용할 수 있습니다. Claude Code, Claude Desktop(mcp-remote 사용), Cursor, Codex, 그리고 OpenAI 또는 Anthropic SDK로 만든 커스텀 에이전트가 포함됩니다.
Telegram Bot API 전체를 지원하나요?
메시지, 미디어, 투표, 수정, 반응, 고정, 포럼 토픽, 관리, 가입 요청, 채팅 설정, 초대 링크 등 그룹 관련 메서드 70개 이상을 지원합니다. 웹훅, 결제, 그룹 나가기처럼 다른 채팅이나 봇 자체에 영향을 주는 메서드는 의도적으로 제외했습니다.
에이전트가 내가 소유하지 않은 그룹에 게시할 수 있나요?
아니요. 모든 호출은 연결된 내 그룹 중 하나에 묶여 있습니다. chat_id는 Metricgram이 설정하며, 전달이나 답장도 내 그룹만 참조할 수 있습니다.
이것은 Telegram 사용자 API(MTProto)인가요?
아니요. 그룹 봇을 통해 공식 Bot API를 사용하므로 에이전트는 봇으로 동작하며, 절대 개인 Telegram 계정으로 동작하지 않습니다.
MCP 서버는 어떤 플랜에 포함되나요?
MCP와 API 액세스는 Elite 플랜에 포함됩니다. 14일 무료 체험에는 Elite 수준의 액세스가 포함되어 있어 결제 전에 에이전트를 연결해 볼 수 있습니다.
에이전트가 할 수 있는 작업을 제한할 수 있나요?
네. API 키마다 고유한 권한 범위가 있으며, 읽기 전용 리서치, 게시, 관리, 운영용으로 키를 따로 만들 수 있습니다.

계속 탐색하기

실용적인 가이드를 찾거나, 활발한 커뮤니티를 둘러보거나, Metricgram 활용법을 더 알아보세요.

가이드

블로그

성장, 수익화, 운영 관리, Telegram 커뮤니티 운영에 관한 실용적인 플레이북을 읽어보세요.

탐색하기

커뮤니티 디렉토리

텔레그램 커뮤니티 디렉토리

카테고리, 언어, 포지셔닝별로 활발한 Telegram 커뮤니티를 탐색하세요.

탐색하기

섹션 허브

솔루션

이 섹션의 모든 페이지를 한곳에서 확인하세요.

탐색하기

솔루션의 더 많은 콘텐츠

Telegram 그룹 관리 도구 Telegram 그룹 분석 및 지표 그룹 관리를 위한 Telegram 봇 Telegram 그룹 자동화 유료 커뮤니티를 위한 Telegram 멤버십 봇 그룹 및 채널용 Telegram 결제 봇

더 알아보기

Telegram 그룹 관리 도구 Telegram 그룹 분석 및 지표 그룹 관리를 위한 Telegram 봇 Telegram 그룹 자동화 유료 커뮤니티를 위한 Telegram 멤버십 봇 그룹 및 채널용 Telegram 결제 봇 반복 수익을 위한 Telegram 구독 봇 Telegram 채널 수익화, 간편하게 시작하세요 Telegram VIP 그룹 생성 및 관리 Telegram 지원을 계정 인텔리전스로 전환 MCP API AI 챗봇 어시스턴트
14일 무료 체험 시작

몇 분 만에 시작하세요

몇 분 만에 텔레그램 그룹을 연결하고 모든 기능을 14일 동안 무료로 사용해 보세요.

요금제 보기