GramClaw는 동일한 텔레그램 엔진을 두 가지 방식으로 노출합니다. 맞춤 자동화를 위한 REST API와 AI 에이전트를 위한 원격 MCP(Model Context Protocol) 서버입니다. 둘 다 설정에서 만드는 API 키로 인증하고, 둘 다 텔레그램 계정을 건강하게 유지하는 동일한 계정별 속도 조절을 준수하며, 둘 다 활성 구독이나 체험이 필요합니다.
실제로는 이렇습니다. REST API는 코드를 위한 것입니다. 제품에서 연락처를 동기화하고, 사용자가 가입할 때 캠페인을 트리거하고, 대화를 데이터 웨어하우스로 보내세요. MCP 서버는 에이전트를 위한 것입니다. Claude Desktop, Claude Code, Cursor, 또는 본인의 에이전트가 채팅 목록 조회, 메시지 읽기, 답장 발송, 브로드캐스트 실행, 파이프라인 관리 도구를 코드 없이 얻습니다.
API 키 만들기
- 1
설정 → API 키를 여세요
키를 생성하고 범위를 선택하세요. 데이터 조회 및 읽기에는 read, 쓰기나 메시지 발송에는 send입니다. 키는 필요한 최소한으로 범위를 지정하세요.
- 2
한 번만 복사하세요
전체 키(gc_live_…)는 생성 시에만 표시됩니다. 시크릿 매니저에 저장하세요. 유출되면 설정에서 삭제하며, 그 즉시 작동을 멈춥니다.
- 3
인증하세요
REST: Authorization: Bearer 헤더로 전송하세요. MCP: 서버 URL의 key 파라미터에 넣으세요.
1분 만에 보는 REST API
API는 플랫폼 표면을 다룹니다. 계정, 채팅, 메시지, 연락처, 캠페인, 브로드캐스트, 파이프라인 열, 분석이 여기에 포함됩니다. 요청은 HTTPS 상의 순수 JSON입니다. 모든 경로, 그 범위, 요청/응답 예시를 포함한 전체 엔드포인트 문서는 API 문서 페이지에 있으며, 코드 생성이나 LLM에 전달하기 위한 기계 판독 가능한 OpenAPI 사양은 /openapi.json 에서 제공됩니다.
MCP 서버 연결하기
- 1
서버 URL을 복사하세요
https://gramclaw.com/api/mcp?key=gc_live_… — 이 키는 당신을 식별하고 권한을 부여하며, 작업할 수 있는 계정으로 범위가 지정됩니다.
- 2
MCP 클라이언트에 추가하세요
Claude Desktop, Claude Code, Cursor, 또는 MCP 호환 클라이언트라면 원격 서버 URL을 받아들입니다. 로컬 설치도, 프록시도 없습니다.
- 3
실제 작업을 요청하세요
연결되고 나면 에이전트가 채팅을 검색하고, 답장 초안을 작성하고 발송하고, 캠페인을 실행하고, 캠페인 상태를 확인하고, 파이프라인을 통해 거래를 이동시킬 수 있습니다. 모든 발송은 GramClaw의 나머지와 동일한 계정 속도 조절을 따릅니다.
모범 사례
- 연동마다 키 하나씩, 그에 맞게 이름 붙여, 하나를 취소해도 다른 것이 절대 망가지지 않게 하세요.
- 대시보드와 분석 작업에는 읽기 전용 범위를 선호하세요.
- 팀원이 떠날 때 키를 교체하고 더 이상 사용하지 않는 키는 삭제하세요. 취소는 즉시 적용됩니다.
- API와 MCP 발송은 실제 계정에서 나가는 실제 텔레그램 메시지임을 기억하세요. 앱에서와 동일한 동의와 발송량에 대한 판단이 적용됩니다.