API & MCP 액세스

Metricgram은 자체 도구, 대시보드, 자동화 또는 AI 클라이언트를 계정에서 사용할 수 있는 데이터와 작업에 연결할 수 있도록 공개 API와 MCP 서버를 제공합니다.

MCP 서버는 모든 유료 플랜과 14일 무료 체험 기간에 사용할 수 있습니다. AI 클라이언트는 OAuth(서버 URL을 붙여 넣고 액세스 승인) 또는 API 토큰으로 연결할 수 있습니다. REST API에는 Elite 액세스가 필요합니다. 계정에 포함되어 있지 않으면 API 섹션이 잠겨 보이거나 업그레이드 안내가 표시될 수 있습니다.

위치

관리 패널에서 통합 > MCP 또는 통합 > API를 엽니다. 액세스 권한이 있는 계정은 여기에서 API 토큰을 만들고, 활성 토큰을 확인하고, 토큰을 취소하고, 플랜에서 사용할 수 있는 기술 레퍼런스를 볼 수 있습니다.

토큰 작동 방식

토큰은 특정 그룹이 아니라 Metricgram 사용자 계정에 속합니다.
토큰은 계정이 관리할 수 있는 그룹과 리소스에 접근할 수 있습니다.
토큰에는 그룹, 멤버, 메시지, 자동화, 구독자, 분석, 지원 티켓, 추천, MCP 등의 권한이 포함됩니다.
일부 endpoint는 데이터 읽기만 수행하지만, 권한에 따라 생성, 수정, 관리 또는 작업 실행도 가능합니다.
토큰 값은 생성 시 한 번만 표시됩니다. 안전하게 보관하세요.

MCP를 통한 Telegram Bot API

MCP 서버는 그룹 단위로 제한된 Telegram Bot API도 제공하므로, AI 에이전트가 Metricgram 봇이나 커스텀 봇을 통해 내 그룹에서 작업할 수 있습니다.

telegram_api_methods로 토큰이 호출할 수 있는 메서드 목록을 확인하고, telegram_bot_api로 공식 Bot API 파라미터를 사용해 원하는 메서드를 호출하세요.
일상 업무는 타입이 지정된 도구로 처리할 수 있습니다: send_telegram_message, send_telegram_media, send_telegram_poll, pin_telegram_message, manage_forum_topic, create_telegram_invite_link 등.
대상 채팅은 항상 내 그룹 중 하나입니다. chat_id를 전달할 필요가 없으며, Metricgram이 group_id에서 도출합니다.
Telegram 작업에는 별도의 권한 범위가 있습니다: telegram:read, telegram:write, telegram:moderate, telegram:admin. 이 권한 범위가 도입되기 전에 만든 토큰으로 사용하려면 토큰을 다시 만들어야 합니다.
미디어는 공개 HTTPS URL 또는 Telegram file_id여야 하며, 인라인 버튼은 URL을 열거나 텍스트를 복사하는 기능만 사용할 수 있습니다.
쓰기 도구는 선택적인 idempotency_key를 지원하므로 재시도한 호출이 두 번 실행되지 않습니다.

인증 및 제한

API 요청은 Authorization: Bearer mg_... 헤더를 사용합니다. 기본 제한은 토큰당 분당 600개 요청이며, 토큰 양식에서 앱이 허용하는 최소값과 최대값 사이의 값을 선택할 수 있습니다.

토큰이 취소되거나, 계정이 API 액세스를 잃거나, 플랜에 API & MCP가 더 이상 포함되지 않으면 해당 토큰을 사용하는 요청은 거부됩니다.

권장 사항

외부 도구마다 별도의 토큰을 만드세요.
각 토큰이 어디에서 사용되는지 알 수 있도록 명확한 이름을 사용하세요.
더 이상 필요 없는 토큰은 취소하세요.
채팅, 스크린샷, 티켓 또는 공개 저장소에 토큰을 공유하지 마세요.

API & MCP 액세스

이 문서에서