# RIKBIEL — 고객 구독 AI 연결과 개인 동반 앱 설계

확인일: 2026-09-24 · 서비스: RIKBIEL / 릭비엘 · Next DATUM Commerce Solution

## 1. 결정

RIKBIEL의 기본 AI 분석은 고객이 이미 쓰는 공식 AI 앱에서 진행합니다. RIKBIEL은 데이터 연결·검증·집계·분석 근거·결과 보관을 담당합니다. 고객의 ChatGPT·Claude·Gemini가 설명과 전략을 생성합니다. 이 경로에서 RIKBIEL은 모델 추론 API를 호출하지 않습니다.

고객의 구독에는 제공자별 한도와 추가 사용 설정이 적용됩니다. 구독료, 추가 사용량 요금, RIKBIEL 이용료, 데이터 수집·DB·연산·호스팅 비용은 각각 남습니다. ‘AI 무제한’ 또는 ‘모든 운영비 0원’으로 판매하지 않습니다.

## 2. V7에서 구현한 동작

- `/ai`: AI 선택, 주제 선택, SKU 선택, 추가 질문, 실제 기록 기반 분석 자료 준비.
- 준비한 근거는 DB에 고정된 스냅샷으로 저장합니다. 이후 원장이 바뀌어도 기존 분석 근거는 유지됩니다.
- 자료에는 기준 시각, 기간, 완전성, null 비용, 모델 한계, 포함된 상세 개수와 원래 개수를 표시합니다.
- 분석 자료를 Markdown 파일로 내려받고 AI에 직접 첨부합니다. 파일 분석 질문과 MCP 분석 질문은 각각 복사할 수 있습니다.
- 읽기 전용 MCP 도구 `rikbiel_analysis_packet`에 `packet_id`를 전달해 같은 근거를 조회할 수 있습니다.
- 고객이 AI 답변 JSON을 가져오면 자료 ID, 근거 해시, 선택한 제공자를 대조합니다. 이는 답변 내용의 진실성·출처 인증이 아닙니다.
- 답변은 검토 대기로 저장되고 소유자·관리자가 참고 결정 채택 또는 보류를 기록합니다. 판매·광고·발주·배송은 실행하지 않습니다.
- 작업공간별 최근 30건 이력, 현재 사용자에게 부여된 MCP 승인 내역을 표시합니다. 승인 기록은 최근 호출 성공이나 AI 플랜 검증을 의미하지 않습니다.
- 분석 자료 준비 및 답변 보관은 외부 모델 API를 호출하지 않습니다. 별도 API 분석은 기존 연결·설정에서 고객이 선택해야 합니다.

현재 고객의 외부 AI 로그인·MCP 도구 실행까지 직접 완료한 상태는 아닙니다. 실제 고객 계정의 승인과 도구 호출 확인은 연결별로 필요합니다.

## 3. 회사별 공식 경로

| 제공자 | 기본 경로 | 고급 경로 | 제한 |
| --- | --- | --- | --- |
| ChatGPT | 사용자 지정 MCP 또는 파일 첨부 | ChatGPT 안의 MCP Apps UI, 개인 PC의 공식 Codex App Server | 개발자 모드·연결은 계정/조직 정책에 따라 달라짐 |
| Claude | remote MCP 또는 파일 첨부 | Claude Artifact + 사용자별 MCP, 공식 Claude Code | 구독의 개인 이용과 제3자 SaaS 인증 제공을 구분 |
| Gemini | 한국에서는 파일 첨부 | 공식 Antigravity 앱·CLI + MCP | Gemini 앱 custom MCP는 현재 미국·영어 등 제한 |

### ChatGPT

공식 문서는 Settings → Security and login → Developer mode, ChatGPT Plugins에서 새 MCP 추가를 안내합니다. 개발자 모드 이용 가능 여부는 계정과 작업공간 정책에 따라 달라집니다. [공식 연결 안내](https://developers.openai.com/plugins/deploy/connect-chatgpt)

RIKBIEL 연결 주소: `https://rikbiel.com/mcp`

고객의 AI가 RIKBIEL 데이터를 읽는 OAuth입니다. RIKBIEL에 ChatGPT 구독 토큰을 주는 인증이 아닙니다. 현재 원격 MCP 승인으로는 고객의 플랜 이름·남은 사용량을 조회하지 않습니다.

OpenAI의 공식 App Server는 자체 제품에 Codex를 통합하는 인터페이스를 제공합니다. 로컬 동반 앱에서 관리형 ChatGPT 로그인, 계정, 사용 한도, 대화와 스트리밍을 처리할 수 있습니다. WebSocket 전송은 실험적이므로 내부 stdio를 기본으로 설계합니다. [App Server](https://learn.chatgpt.com/docs/app-server), [인증](https://learn.chatgpt.com/docs/auth), [SDK](https://learn.chatgpt.com/docs/codex-sdk)

일반 CI 프로그램 작업에는 API 키, Enterprise의 신뢰할 수 있는 자동화에는 별도 Codex 접근 토큰 경로가 문서화되어 있습니다. 소비자 플랜을 공용 SaaS 추론 서버로 전용할 수 있다고 확대해 설명하지 않습니다.

ChatGPT 안에 커머스 카드·분석 화면을 넣는 후속 확장에는 MCP Apps 표준을 사용합니다. V7에는 해당 UI 리소스를 배포하지 않았습니다. [공식 UI 문서](https://developers.openai.com/plugins/build/chatgpt-ui)

### Claude

Claude의 custom remote MCP는 고객의 RIKBIEL 데이터에 접근하는 공식 방식입니다. 조직 계정은 관리자의 커넥터 추가가 선행될 수 있습니다. [공식 커넥터 안내](https://support.claude.com/en/articles/11175166-get-started-with-custom-connectors-using-remote-mcp)

RIKBIEL은 공식 설치 링크로 이름·서버 주소가 미리 채워진 Claude 커넥터 설정을 엽니다. 사용자가 검토하고 승인해야 합니다. [설치 링크 형식](https://claude.com/docs/connectors/building/directory-vs-custom#share-an-install-link)

Claude Artifact는 각 사용자의 계정과 플랜으로 AI를 사용하고, 지원 플랜의 웹·Desktop에서는 사용자가 연결한 custom connector를 활용할 수 있습니다. RIKBIEL 분석용 Artifact는 후속 확장안입니다. 외부 RIKBIEL 사이트에 새 Artifact를 그대로 임베드할 수 있다고 보장하지 않습니다. [Artifacts](https://support.claude.com/en/articles/9487310-what-are-artifacts-and-how-do-i-use-them)

개인의 Agent SDK·CLI 사용과 제3자 제품에 구독 로그인을 제공하는 권한은 다릅니다. 현재 SDK 구독 도움말은 예정 변경을 중단했다고 알리지만, SDK overview와 legal 문서는 승인받지 않은 제3자 제품의 로그인·중계를 제한합니다. 수정하지 않은 공식 Claude Code 바이너리 호스팅에 대한 조건부 예외도 있습니다. RIKBIEL의 일반 SaaS 추론 권한으로 확대하지 않습니다. [SDK 플랜 도움말](https://support.claude.com/en/articles/15036540-use-the-claude-agent-sdk-with-your-claude-plan), [SDK overview](https://code.claude.com/docs/en/agent-sdk/overview), [이용 조건](https://code.claude.com/docs/en/legal-and-compliance)

Pro·Max의 추가 usage credits와 현재 Enterprise 과금은 별도 비용이 생길 수 있습니다. [추가 사용](https://support.claude.com/en/articles/12429409-manage-usage-credits-for-paid-claude-plans), [Enterprise 청구](https://support.claude.com/en/articles/11526368-how-am-i-billed-for-my-enterprise-plan)

### Gemini와 Antigravity

Gemini는 파일 분석을 지원하므로 한국 고객의 기본 흐름으로 사용합니다. Drive·Gem의 지식 파일도 보조 경로이지만 RIKBIEL과 자동으로 동기화되지는 않습니다. [파일 분석](https://support.google.com/gemini/answer/14903178?hl=en), [Gems 지식 파일](https://support.google.com/gemini/answer/15235603?hl=en)

Gemini 앱 custom MCP는 현재 미국, 18세 이상, 개인 Google 계정, 영어, Keep Activity ON 조건입니다. V7는 이를 한국 일반 사용 경로로 표시하지 않으며 Gemini 앱 고유의 OAuth callback 연동을 완료했다고 주장하지 않습니다. [custom apps 조건](https://support.google.com/gemini/answer/17209137)

**기존 Gemini CLI의 소비자 구독 경로는 2026-06-18 종료되었습니다.** Google AI Pro·Ultra와 Individuals 대상입니다. Gemini CLI 전체 또는 조직용·API 경로 전체가 종료된 것은 아닙니다. [종료 공지](https://developers.google.com/gemini-code-assist/docs/deprecations/code-assist-individuals)

후속 개인 구독 경로는 공식 Antigravity 앱·CLI입니다. RIKBIEL은 문서에 나온 원격 MCP 구성과 정확한 callback `https://antigravity.google/oauth-callback`을 허용합니다. 사용자 계정의 실제 인증은 별도 완료해야 합니다. [Antigravity MCP](https://antigravity.google/docs/mcp/), [플랜](https://antigravity.google/docs/plans)

```json
{"mcpServers":{"rikbiel":{"serverUrl":"https://rikbiel.com/mcp"}}}
```

Antigravity OAuth를 다른 제품이 가져가 모델 서비스에 직접 접근하는 것은 공식 조건과 충돌합니다. 공식 앱이 RIKBIEL MCP를 호출하도록 합니다. [추가 약관](https://antigravity.google/terms), [FAQ](https://antigravity.google/docs/faq/)

Google 구독에 포함된 개발자 크레딧은 적용 가능한 Cloud Billing 계정에 연결해 API 비용 일부를 상쇄할 수 있습니다. 유한한 혜택이며 앱 구독 한도의 범용 API 전환은 아닙니다. 금액과 적용 조건은 설정 당시 공식 페이지에서 확인합니다. [Developer Program](https://developers.google.com/program/plans-and-pricing), [혜택 적용](https://developers.google.com/profile/help/benefits)

## 4. 데이터와 권한 계약

RIKBIEL 로그인은 회원 신원입니다. AI 플랜 이용 권한과 별개입니다.

| 객체/작업 | 권한 |
| --- | --- |
| 자료·결과 조회 | 해당 작업공간의 활성 구성원 |
| 분석 자료 준비·답변 등록 | 소유자·관리자·운영자 |
| 참고 결정 채택·보류 | 소유자·관리자 |
| MCP 외부 앱 승인 | 소유자·관리자, 본인의 작업공간 |
| 읽기 MCP | 승인한 조직, `rikbiel:read`, 최대 30일 grant, 회수 가능 |
| 외부 실행 | V7 구독 AI 경로에는 없음 |

최고 관리자의 기존 감사 기록에는 준비·등록·검토 이벤트가 남습니다. 답변 본문과 비밀정보는 감사 메시지에 넣지 않습니다. 접속 로그는 기존 정책을 따릅니다. 새로운 자료 보관 건수를 구독의 모델 토큰 사용량으로 계산하지 않습니다.

자료 최대 크기 180KB, 상품 상세 최대 40개, 로트 최대 상품당 10개, 일별 상세 최근 90개, 광고 상세 최대 80행, 관심 검색 최대 10개입니다. 요약은 원래 집계 범위를 유지하며 일부 상세의 합계와 다를 수 있습니다. 생성 제한은 작업공간당 시간당 20건, 보관 500건이며 최근 30건을 화면에 표시합니다. 원본 자료는 업무 기록으로 보관하며 사용자가 일반 화면에서 삭제하는 기능은 아직 없습니다.

자료에는 상품·로트와 사업 수치가 포함됩니다. 원시 주문·고객 연락처·리뷰 본문·커넥터 비밀정보는 넣지 않습니다. 상품명·검색어도 외부 입력이므로 지시문으로 취급하지 않습니다. 기존 전체 대시보드 MCP는 기존 승인 범위에 따른 별도 도구이며, 이 제한은 새 분석 자료에 적용됩니다.

자료 hash는 서버가 생성한 snapshot의 무결성 식별자입니다. 답변의 진실성, AI 제공자, 모델, 지출액을 인증하지 않습니다. 답변 출처는 사용자 제출로 표시합니다. revision으로 동시 편집을 제어하고 채택·보류 기록은 닫힌 상태가 됩니다.

## 5. 개인 PC 동반 앱 — 후속 구현 명세

목표: 사용자가 RIKBIEL 화면에서 질문하고, 개인 PC의 공식 런타임이 본인의 구독으로 분석하고, 결과만 돌아오는 경험. 아직 배포한 기능이 아닙니다.

### 5.1 우선 개발 순서

1. ChatGPT: 공식 Codex App Server + 관리형 ChatGPT 로그인. stdio로 동반 앱 내부에 연결.
2. Claude: Claude 안의 Artifact + MCP 화면. 별도 승인이 필요한 SaaS 로그인·중계와 분리.
3. Google: 공식 Antigravity 앱·CLI에서 RIKBIEL MCP 사용. Google OAuth를 자체 동반 앱 추론 프록시로 전용하지 않음.

### 5.2 ChatGPT 동반 앱의 구성

- 서명된 데스크톱 앱, 업데이트 검증, 사용자별 OS 자격증명 저장소.
- RIKBIEL 디바이스 페어링: 사용자·조직·기기·권한을 결합한 별도 승인. AI 제공자 토큰과 구분.
- 사용자가 실행할 때 공식 `codex app-server`를 자신의 OS 계정으로 시작. 임의 셸 문자열을 조합하지 않음.
- `initialize`, `account/login/start`의 관리형 `chatgpt` 또는 `chatgptDeviceCode`, `account/login/completed`.
- 계정 표시: `account/read`, `account/rateLimits/read`, `account/usage/read`가 실제로 반환한 범위만 사용.
- 자료 접근: 서버의 승인된 작업 ID·근거 hash·만료·동일 조직을 검사한 후 다운로드.
- 작업 실행: `thread/start`, `turn/start`, 스트리밍 결과와 취소 처리. 읽기 분석용 도구를 기본으로 허용.
- 결과 반환: 별도 `analysis:submit` 권한. 고객 동의로 부여하며 기존 `rikbiel:read`를 조용히 확장하지 않음.
- idempotency key와 revision으로 중복 제출·지연 답변을 차단. 기한 경과 시 새 자료 준비.
- 사용자 검토 후 플랫폼의 별도 정책 엔진으로 넘김. LLM 문장만으로 주문·광고 실행을 승인하지 않음.
- 로그아웃은 공식 런타임의 `account/logout` 처리. 고객 비밀번호·쿠키·auth.json 업로드를 요구하지 않음.

### 5.3 작업 상태와 운영

`prepared → claimed → running → result_ready → review_pending → accepted/rejected`

연결 끊김·한도 도달 시 `paused`, 사용자 취소 시 `cancelled`, 데이터 만료 시 `expired`. 기기가 꺼져 있으면 대기합니다. 한도 소진을 이유로 유료 API로 자동 전환하지 않습니다. 사용자가 별도 비용 경로를 선택할 때 예상 비용과 한도를 표시합니다.

서버는 기기별 lease, heartbeat, 작업 만료, 취소, 중복 결과 제거를 처리해야 합니다. 현재 V7의 수동 결과 가져오기는 이 device queue를 구현한 것이 아닙니다.

### 5.4 출시 판단 조건

- 공식 로그인/로그아웃, 한도 도달, 재인증, 취소를 실제 테스트 계정으로 확인.
- 고객별 조직 격리와 비밀정보 미전송, 악성 상품 텍스트의 도구 실행 차단 검증.
- 공식 런타임 배포·사용 조건 확인. 플랫폼 전체 고객의 공유 토큰 풀을 만들지 않음.
- PC 절전·앱 종료·네트워크 복귀에서 중복 실행 없이 결과 복원.
- 프로그램 서명, 업데이트 무결성, 설치·제거 UX와 고객 지원 문서 준비.

## 6. 운영 에이전트 비용 구조

판매/광고/재고 원장 집계, 기한 계산, 기준선 예측, 한도 점검, 권한 판단은 일반 코드로 처리합니다. 언어모델은 예외의 설명, 전략 대안, 질문·가설 생성에 사용합니다. 반복 조회는 동일 자료 hash를 재사용합니다.

구독 AI 한도와 앱 가용성에 영향을 받는 대화·심층 분석은 사용자가 공식 앱에서 시작합니다. 24시간 판매 모니터링·알림·고정 규칙은 서버에서 처리할 수 있지만, V7 운영 에이전트는 현재 ‘지금 실행’ 방식입니다. 수익·성과·폐기율 0%를 보장하는 구조로 판매하지 않습니다.

## 7. 이어서 개발할 사람이 확인할 파일

- `lib/platform/subscription-ai.ts`: 근거 생성·결과 검증·검토 서비스.
- `app/api/subscription-ai/[...path]/route.ts`: 회원 인증·출처 검사·작업공간 API.
- `app/mcp/route.ts`: 읽기 전용 MCP 도구 네 개.
- `lib/auth/mcp-oauth.ts`: OAuth PKCE·허용 callback·권한 회수.
- `content/ai.html`, `public/ai-connections.js`, `public/subscription-ai.css`: 반응형 화면.
- `db/schema.ts`, `drizzle/0006_shocking_charles_xavier.sql`: 분석 자료의 영속 보관.
- `tests/subscription-ai.test.mjs`: 실제 SQLite에서 권한·동시성·무과금 경로 검증.