API & MCP 액세스

API & MCP 액세스

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

API & MCP 액세스는 Elite 플랜에서 사용할 수 있습니다. 계정에 포함되어 있지 않으면 API & MCP 섹션이 잠겨 보이거나 업그레이드 안내가 표시될 수 있습니다.

위치

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

토큰 작동 방식

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

인증 및 제한

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

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

권장 사항

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