# AI 어시스턴트용 레시피

> 코드를 쓰는 어시스턴트에게 한 번 요청해 API, SaaS 요금제, 앱, 봇, MCP 도구를 암호화폐로 판매하세요.

어시스턴트에게 "USDC로 API 크레딧을 살 수 있게 해 줘"라고 하면 제대로 해야 합니다: 테스트 모드 먼저, 서명된 웹훅, 결제가 이행된 뒤에만 이용권. 이 레시피가 그걸 가르칩니다. 각각 한 소스에서 나온 Claude Code 스킬, Cursor 규칙, `AGENTS.md` 블록이며, 실행해 볼 수 있는 작은 앱이 딸려 있습니다. 비용은 없습니다: 내 키로 Perly Pay를 부르는, 내 프로젝트 안의 파일일 뿐입니다.

| 레시피 | 파는 것 | 스킬 | 예제 |
| --- | --- | --- | --- |
| [API 크레딧](https://pay.perly.io/docs/recipe-api-credits.md) | 선불 크레딧, 요청당 차감 | `sell-credits` | `api-credits` (Hono) |
| [SaaS 구독](https://pay.perly.io/docs/recipe-saas-subscription.md) | 월간 요금제, 청구서로 갱신 | `sell-subscription` | `saas-subscription` (Next.js) |
| [라이선스 키](https://pay.perly.io/docs/recipe-license-keys.md) | 키로 열리는 앱이나 플러그인 | `sell-license-keys` | `license-keys` (Node CLI) |
| [Telegram 봇](https://pay.perly.io/docs/recipe-telegram-bot.md) | 유료 명령, 역할, 그룹 | `sell-bot-access` | `telegram-bot` (Node) |
| [유료 MCP 서버](https://pay.perly.io/docs/recipe-paid-mcp-server.md) | MCP 도구, 호출당 크레딧 | `paid-mcp-tools` | `paid-mcp-server` (MCP SDK) |

스킬이 세 개 더 있습니다: 모든 1회 판매용 `add-crypto-checkout`, 프레임워크별로 올바른 웹훅 라우트를 위한 `verify-webhooks`, 결제 시뮬레이션과 실제 돈으로의 전환을 위한 `test-and-go-live`.

## Claude Code

```bash
claude plugin marketplace add volodymyrslipak/perly-pay-ai && claude plugin install perly-pay@perly
```

그다음 평소 말로 요청하거나 스킬을 부르세요: `/perly-pay:sell-credits`.

## Cursor

플러그인의 `cursor/rules/*.mdc`를 프로젝트의 `.cursor/rules/`로 복사하세요. `perly-pay.mdc`에 규칙이 있고, 레시피마다 대화 주제가 되면 붙는 파일이 따로 있습니다.

## AGENTS.md

플러그인의 `AGENTS-snippet.md`를 내 `AGENTS.md`에 붙여 넣으세요(Codex, Jules, Copilot, Zed, Cursor 등이 읽습니다). `BEGIN perly-pay`와 `END perly-pay` 사이에 있어서 업데이트하면 통째로 바뀝니다.

## 모든 어시스턴트

모든 어시스턴트용 스킬은 `/.well-known/skills/index.json`에 나열되어 있고, 모든 문서 페이지는 Markdown으로도 있습니다 — 주소에 `.md`를 붙이거나 `/llms-full.txt`에서 한 번에 읽으세요.

## 모든 레시피가 지키는 것

- 테스트 모드 먼저: `sk_test_…` 키와 `invoices.simulate`. 실제 돈은 움직이지 않습니다.
- 비밀 키는 내 서버의 `PERLY_PAY_SECRET_KEY`에. 배포하는 앱은 키 없이 라이선스를 검사합니다.
- 이용권은 `invoice.fulfilled`나 `entitlements.check`로만 — 결제에서 돌아왔다고, `invoice.paid`라고 열지 않습니다.
- 웹훅은 원본 본문으로 검증하고, 이벤트마다 한 번만 처리합니다.
- 크레딧 차감처럼 반복될 수 있는 모든 것에 멱등성 키.
- 금액은 센트, USD 또는 EUR. 부동소수점은 절대 쓰지 않습니다.
- 자동 청구 없음: 갱신과 충전은 구매자가 자기 지갑에서 결제하는 청구서입니다.