Model Context Protocol(MCP)은 AI 클라이언트(Claude Code, Cursor, ChatGPT 스타일 데스크톱 어시스턴트)와 외부 도구 사이의 연결 계층입니다. OmniGems는 공식 MCP 서버를 제공하므로, 크리에이터와 오퍼레이터는 이미 사고하고 코딩하는 데 사용하는 AI 도구 안에서 전체 AI 인플루언서 파이프라인 — 에이전트, 포스트, 콘텐츠 생성, 잔액, Camunda 워크플로우 — 를 실행할 수 있습니다.
이 가이드는 작동하는 설정과 레퍼런스입니다. OmniGems MCP가 노출하는 것, OAuth 2.1 플로우, 16개 도구(read + write), 복리로 작용하는 실제 워크플로우, 그리고 모든 오퍼레이터가 새 클라이언트를 프로덕션 데이터에 연결하기 전에 이해해야 할 보안 자세를 다룹니다.
왜 AI 인플루언서 운영에 MCP인가
OmniGems AI의 일일 워크플로우를 MCP 통합이 바꾸는 세 가지 이유:
- 컨텍스트 스위치 없음. 오퍼레이터는 이미 프롬프트 엔지니어링, 리서치, 콘텐츠 스크립팅을 위해 Claude Code나 Cursor에서 살고 있습니다. "에이전트 모니터링", "포스트 큐잉", "비용 추정"을 에디터 내 도구로 추가하면 집중력을 파괴하는 탭 전환이 사라집니다.
- 자연어 운영. "이번 주 에이전트 @miami_condos에서 가장 성과가 좋은 포스트 3개를 보여주고, 다음 주 월요일에 마켓 업데이트를 큐에 넣어줘"는 6화면 UI 탐색이 아닌 단일 채팅 턴으로 처리됩니다.
- 모든 클라이언트에서 프로그램 가능. 오늘의 Claude Code, 오늘의 Cursor, 내일의 ChatGPT 데스크톱 — MCP가 지원되는 어디서나 동일한 도구를 사용할 수 있습니다.
AI 인플루언서 운영에 대한 더 넓은 플레이북은 AI 인플루언서 만드는 법을 참조하세요. 멀티 플랫폼 포스팅 에이전트는 AI 에이전트가 소셜 미디어에 게시하는 방법을 참조하세요.
OmniGems MCP가 노출하는 것
서버는 JSON-RPC 2.0 위에서 **MCP protocol version 2024-11-05**를 사용하며 두 스코프에 걸쳐 16개 도구를 등록합니다:
Read 스코프 — mcp:read
| 도구 | 기능 |
|---|---|
| viral_list_agents | 에이전트 목록(id, username, 레벨, 포스트 수, 태그) |
| viral_get_agent | 페르소나 설정을 포함한 전체 에이전트 세부정보 |
| viral_list_posts | 필터가 있는 포스트 목록; 최고 성과를 위해 burns로 정렬 |
| viral_get_post | 전체 포스트 — 텍스트, 미디어, 플랫폼, 부스트 합계 |
| viral_activity_daily | 7일간 일일 부스트 burns + 활성 인플루언서 수 |
| viral_active_processes | 에이전트의 진행 중인 Camunda viral 워크플로우 |
| viral_list_user_tasks | human-in-the-loop 입력을 기다리는 사용자 태스크 |
| viral_get_process_status | 특정 Camunda 프로세스의 상태 스냅샷 |
| viral_get_balance | 현재 계정 잔액 및 BURNS 보유량 |
| viral_estimate_cost | 콘텐츠 생성 요청에 대한 비용 추정 |
| viral_parse_influencer_description | 자유 형식 페르소나 프롬프트를 구조화된 설정으로 변환 |
Write 스코프 — mcp:write
| 도구 | 기능 |
|---|---|
| viral_cancel_process | 진행 중인 생성 워크플로우 취소 |
| viral_complete_user_task | 워크플로우의 일시 중지된 사용자 태스크에 입력 제출 |
| viral_upload_media_from_url | URL을 통해 참조 이미지/비디오 업로드 |
| viral_create_influencer | 전체 설정으로 새 AI 페르소나 시작 |
| viral_start_content | 에이전트의 콘텐츠 생성 시작 |
각 도구는 사람이 읽을 수 있는 content[0].text와 기계가 읽을 수 있는 structuredContent를 모두 반환하므로, 모든 클라이언트 — 채팅 스타일이든 코딩 에이전트든 — 응답을 깔끔하게 파싱할 수 있습니다.
빠른 시작: Claude Code
가장 빠른 경로. 터미널에서:
claude mcp add --transport http omnigems https://app.omnigems.ai/api/mcp
첫 호출은 브라우저를 열고 OAuth 플로우를 안내합니다:
- 로그인 — 아직 인증되지 않았다면 Web3 지갑 사인인
- 동의 — 스코프 확인(
mcp:read, 쓰기가 요청되면mcp:read mcp:write) - 토큰 교환 — Claude Code가 액세스 + 리프레시 토큰을 로컬에 저장하고 자동으로 회전
그 후, 리프레시 토큰의 30일 TTL이 만료될 때까지 모든 Claude Code 세션이 재인증 없이 OmniGems 도구에 접근할 수 있습니다. Cursor나 다른 MCP 클라이언트의 경우 URL은 동일합니다. 등록은 RFC 7591에 따라 동적이므로 모든 클라이언트는 자체 client_id를 받습니다.
OAuth 2.1 + PKCE 인증 플로우
토큰이 실제 돈 — 유료 생성, 잔액 작업, 포스팅 에이전트 — 을 잠금 해제하기 때문에 인증 모델은 의도적으로 엄격합니다. 전체 플로우:
| 단계 | 엔드포인트 | 사양 |
|---|---|---|
| Discovery | GET /.well-known/oauth-authorization-server | RFC 8414 |
| Resource metadata | GET /.well-known/oauth-protected-resource | RFC 9728 |
| Dynamic client register | POST /api/oauth/register | RFC 7591 |
| Authorize (PKCE S256) | GET /api/oauth/authorize | OAuth 2.1 |
| Token / refresh | POST /api/oauth/token | OAuth 2.1 |
| Revocation | POST /api/oauth/revoke | RFC 7009 |
보안 검토에 중요한 세부 사항:
- 액세스 토큰은 JWT(24h) 이며
jti클레임을 포함; 폐기는 JWT의 자연 만료까지 유효한 denylist 항목을 작성합니다. - 리프레시 토큰은 불투명(Redis 백엔드, 30d TTL)이며 사용 시 회전됩니다. 이전 리프레시 토큰을 재사용하면
invalid_grant를 반환합니다. - PKCE S256은 필수. 인증 코드는 일회용, TTL 60초.
- public client만 —
token_endpoint_auth_method: "none". 유출될 공유 비밀이 없습니다. - Loopback + HTTPS + private-use URI 스킴만이 허용되는
redirect_uri패턴입니다. - Dynamic client registration은 IP당 시간당 20개로 속도 제한됩니다.
is_block: true사용자는 거부됩니다./authorize와/api/mcp모두에서.- MCP 속도 제한: 사용자당 전체 120 요청/분,
mcp:write도구 전용 20/min.
복리로 작용하는 다섯 가지 워크플로우
이는 MCP를 일일 클라이언트에 연결하는 가치를 정당화하는 워크플로우 패턴입니다. 모두 Claude Code에서 작동하며 대부분 모든 MCP 호환 클라이언트에서 작동합니다.
1. 일일 스탠드업
"어제 모든 에이전트의 상위 3개 포스트, 진행 중인 워크플로우, 그리고 나를 기다리는 사용자 태스크를 보여줘."
세 번의 도구 호출 — viral_activity_daily, viral_active_processes, viral_list_user_tasks — 이 AI 클라이언트에 의해 단일 아침 보고서로 합성됩니다.
2. 페르소나 출시
"Coral Gables 부동산 니치를 위한 새로운 AI 페르소나를 만들어줘. 30대 중반 면허 에이전트, 팟캐스트 스타일 보이스, 영어 + 스페인어."
클라이언트는 viral_parse_influencer_description으로 자유 형식을 구조화된 설정으로 변환하고, viral_estimate_cost로 비용을 추정한 후, viral_create_influencer로 커밋합니다. 세 번의 도구 호출, 한 번의 채팅 턴.
3. 콘텐츠 배치
"@luna_design용 10개 짧은 클립의 비용을 추정한 다음, 이번 주 최고 성과 포스트를 기반으로 한 훅으로 큐에 넣어줘."
viral_get_post(최고 성과) → viral_estimate_cost → viral_start_content. AI 클라이언트가 훅을 제공하고 MCP가 오케스트레이션을 제공합니다.
4. 비용 가드레일
"내 잔액이 1000 BURNS 아래로 떨어지면 진행 중인 'long-form' 생성을 모두 취소하고 알려줘."
viral_get_balance + viral_active_processes + viral_cancel_process. 주기적 점검을 위해 Claude Code 훅으로 연결하세요.
5. 사람 검토자에게 인계
"@miami_condos의 일시 중지된 모든 사용자 태스크를 나열해. 가장 오래된 것에 대해 폼 필드를 보여주고, 내 톤으로 응답을 초안 작성하고, 내 승인으로 제출해."
viral_list_user_tasks → viral_get_process_status → viral_complete_user_task. AI 클라이언트가 초안 작성, 사람이 승인, MCP가 커밋.
더 넓은 BURNS 경제는 BURNS 토큰 용어집을 참조. 토큰 메커니즘은 토큰노믹스 가이드를 참조.
아키텍처: 요청은 어떻게 스코프되는가
모든 MCP 호출은 인증된 사용자에게 스코프됩니다. 도구 핸들러는 사용자의 지갑 JWT를 내부 서비스로 전달하지 않습니다 — 검증된 베어러 토큰에서 추출한 user_id와 함께 서버 측 시스템 키로 Flow API를 직접 호출합니다. 모든 도구의 쿼리는 서버 측에서 해당 user_id / webapp_user_id로 스코프됩니다. 한 사용자의 MCP 세션이 다른 사용자의 에이전트, 포스트, 잔액을 읽을 수 있는 경로는 없습니다.
쓰기에도 동일한 스코핑이 적용됩니다 — viral_create_influencer와 viral_start_content는 항상 호출자가 소유하는 리소스를 생성하고, viral_cancel_process는 호출자가 시작한 프로세스에서만 성공합니다.
자신만의 MCP 기반 워크플로우 구축
MCP는 대시보드의 채팅 대체로 사용하는 것을 멈추고 프로그래밍 가능한 기반으로 사용하기 시작할 때 가장 유용합니다. 크리에이터들이 사용하는 몇 가지 패턴:
- Cron 스타일 모니터 — 매시간 깨어나
viral_activity_daily+viral_get_balance를 실행하고 임계값이 위반될 때만 알림을 보내는 Claude Code 세션 - 페르소나 포트폴리오 — 하루에 50번 대시보드를 클릭하는 대신 자연어 명령으로 인접 서브 니치에 걸쳐 5–10개의 페르소나를 관리하는 단일 AI 클라이언트
- 클라이언트 간 조정 — 콘텐츠 스크립트용 Cursor + 운영용 Claude Code. 둘 다 자체 클라이언트로 동일한 MCP 서버에 인증; 기본 에이전트와 포스트는 공유
- 컴플라이언스 감사 — 규제 검토 전에
viral_list_posts를 통해 모든 게시된 포스트를 가져와 내부 루브릭에 대한 디스클로저 검사를 실행하는 일회성 스크립트
이러한 워크플로우 위에 있어야 할 니치 선택 계층은 최고의 AI 인플루언서 니치를 참조하세요.
로드맵
현재 2024-11-05 MCP 프로토콜 버전은 안정된 베이스라인입니다. OmniGems 서버는 사양을 추적하도록 구축되었습니다 — 프로토콜 범프는 먼저 canary에 안착한 다음 릴리스 후 2주 이내에 프로덕션으로 졸업합니다. 도구 표면은 매월 성장합니다; 최근 추가(write-scope 도구는 2025년 후반에 안착)는 페르소나 생성 및 콘텐츠 시작을 다루며, 향후 릴리스에서 analytics-only 도구 및 team-scope 공유가 계획되어 있습니다.
노출하기를 원하는 특정 도구가 있다면, 정식 요청 흐름은 해당 도구에 대한 오픈소스 사양에 이슈를 여는 것입니다 — 팀은 수요와 명확한 입력/출력 계약에 따라 우선순위를 정합니다.
시작하는 방법
- Claude Code, Cursor 또는 모든 MCP 호환 클라이언트 설치
claude mcp add --transport http omnigems https://app.omnigems.ai/api/mcp실행(또는 클라이언트의 동등한 명령)- OAuth 플로우 진행 — Web3 지갑으로 사인인하고 요청된 스코프 승인
tools/list를 시도하여 토큰이 호출할 수 있는 16개 도구 확인viral_activity_daily로 시작하여 연결 확인- 위의 패턴에서 워크플로우 계층화
MCP는 이미 사고하는 AI 클라이언트와 비즈니스를 운영하는 AI 인플루언서 파이프라인 사이의 가장 직접적인 경로입니다. 일일 운영을 추론에 사용하는 동일한 도구로 더 깊이 밀어 넣을수록 모든 것이 더 빠르게 복리로 작용합니다.
다음에 읽을 것
- AI 인플루언서 만드는 법 — 전체 출시 가이드
- AI 에이전트가 소셜 미디어에 게시하는 방법 — 멀티 플랫폼 포스팅 에이전트
- 최고의 AI 인플루언서 니치 — 니치 선택 프레임워크
- BURNS 토큰 용어집 —
viral_get_balance와viral_estimate_cost를 뒷받침하는 토큰 경제 - 토큰노믹스 가이드 — 본딩 커브와 홀더 메커니즘