> ## Documentation Index
> Fetch the complete documentation index at: https://docs.whop.com/llms.txt
> Use this file to discover all available pages before exploring further.

> ## Agent Instructions
> Treat these docs and the Whop MCP server as the source of truth for Whop API behavior. Don't infer endpoint behavior from marketing pages.
> MCP server: connect https://mcp.whop.com/mcp (streamable HTTP, browser sign-in, no API key in the client config) to search these docs and read or change live Whop data. Setup: https://docs.whop.com/developer/guides/ai_and_mcp.md
> Whop CLI: install with `curl -fsSL https://whop.com/install.sh | sh` to scaffold, run, and deploy Whop apps and websites. It acts on production, not the sandbox. Overview: https://docs.whop.com/cli/overview.md Agent mode: https://docs.whop.com/cli/agent-mode.md
> Hosting: Whop serves a site or app from the build `whop apps deploy` uploads, with rollbacks, secrets, and server logs. Guide: https://docs.whop.com/developer/websites/hosting.md
> Plugins: in Claude Code, run `/plugin marketplace add whopio/plugins`, then `/plugin install whop@whop`. Guide: https://docs.whop.com/developer/guides/plugins/claude-code.md Every agent tool: https://docs.whop.com/developer/ai/overview.md
> Environments: build and test in the sandbox (API `https://sandbox-api.whop.com/api/v1`, keys at https://sandbox.whop.com/dashboard/developer, SDK environment `Sandbox`; no real money). Production (API `https://api.whop.com/api/v1`, keys at https://whop.com/dashboard/developer, SDK environment `Production`, the SDK default) moves real money, so use it only at launch. The two share no accounts, keys, products, or webhooks, and their keys look identical: never mix them. Sandbox guide: https://docs.whop.com/developer/guides/sandbox.md Comparison: https://docs.whop.com/developer/quickstart.md
> API: send `Authorization: Bearer <API_KEY>` from your server only, and pin a dated version with the `Api-Version-Date` header. OpenAPI spec: https://api.whop.com/api/v1/openapi.json
> Which API: build on the Current API, whose pages live under https://docs.whop.com/api-reference/ (start at https://docs.whop.com/api-reference/overview.md). Pages under /api-reference/legacy/ are the Legacy API. Use one only when https://docs.whop.com/api-reference/stability.md lists the resource as Legacy-only.

# Whop CLI 에이전트 모드

> Whop 스킬을 에이전트에 동기화하고 CLI의 기계 판독 가능한 출력 플래그를 사용하세요.

AI 에이전트는 Whop CLI 전체를 구동할 수 있습니다. 별도의 `agent` 명령은 없습니다. 에이전트 모드는 CLI 자체에 있는 플래그와 통합의 집합입니다.

> [!WARNING]
>
> CLI에는 샌드박스, 테스트 또는 드라이 런 모드가 없습니다. CLI를 구동하는 에이전트는 프로덕션 환경에서 작동합니다.

## 에이전트에 Whop 도구 제공하기

`https://mcp.whop.com/mcp`에서 [Whop MCP 서버](https://docs.whop.com/ko/developer/guides/ai_and_mcp.md)를 연결하세요. 브라우저를 통해 로그인하고, 클라이언트 설정에 API 키가 필요하지 않으며, 중요한 작업을 실행하기 전에 확인을 요청합니다.

API가 하지 않는 작업, 즉 프로젝트 스캐폴딩, 개발 서버 실행, 배포에는 CLI를 함께 사용하세요.

`whop mcp add`는 대신 CLI 자체를 로컬 MCP 서버로 등록합니다. 그 도구는 로그인을 제외한 CLI의 명령입니다. `auth`, `login`, `logout`은 노출되지 않으므로 에이전트가 시작되기 전에 `whop login`을 실행하거나 `WHOP_API_KEY`를 설정하세요.

## 스킬

`whop skills add`는 Whop의 스킬 파일을 에이전트에 동기화합니다. 하나의 `whop` 스킬과 함께 Whop의 결제, 앱, 광고 흐름을 에이전트에게 가르치는 플레이북 참조가 포함됩니다. `whop skills list`는 설치된 항목을 보여줍니다.

## 기계 판독 가능한 출력

모든 명령에 적용되는 전역 플래그로, 에이전트가 CLI를 직접 호출하고 반환된 내용을 파싱할 수 있습니다:

| 플래그 | 용도 |
| - | - |
| `--llms`, `--llms-full` | CLI 전체에 대한 LLM 판독 가능 매니페스트 출력 |
| `--schema` | 명령의 JSON Schema |
| `--format <toon\|json\|yaml\|md\|jsonl>` | 출력 형식 |
| `--filter-output <keys>` | 키 경로로 출력 필터링 |
| `--token-count` / `--token-limit <n>` / `--token-offset <n>` | 출력의 토큰 예산 지정 |

## 에이전트 로그인

무인 사용의 경우 `--api-key`를 전달하거나 `WHOP_API_KEY`를 설정하세요. OAuth의 경우 CLI 자체의 에이전트 안내를 따르세요. 출력을 파일로 보내도록 하여 백그라운드에서 `whop login --method oauth --format jsonl`을 실행하세요. 출력된 `authorizationUrl`을 잘리지 않게 사용자의 브라우저에서 연 다음 마지막 `done` 이벤트를 기다리세요.

## 다음 단계

> [card] [CLI와 Claude로 빌드하기](https://docs.whop.com/ko/developer/guides/cli-with-claude.md)
>
> 에이전트가 참여하는 전체 워크플로입니다.

> [card] [AI와 MCP](https://docs.whop.com/ko/developer/guides/ai_and_mcp.md)
>
> Whop MCP 서버를 연결하세요.


## Related topics

- [Whop에서 개발하기 위한 AI 도구](https://docs.whop.com/ko/developer/ai/overview.md)
- [CLI와 Claude로 빌드하기](https://docs.whop.com/ko/developer/guides/cli-with-claude.md)
- [Whop CLI](https://docs.whop.com/ko/cli/overview.md)
