> ## Documentation Index
> Fetch the complete documentation index at: https://docs.dodopayments.com/llms.txt
> Use this file to discover all available pages before exploring further.
# AI 코딩 에이전트와 함께 구축하기
> Dodo Agent Plugin을 사용하여 Claude Code, Codex CLI, Cursor, OpenCode와 통합하세요 — MCP 서버 및 기술을 한 번의 설치로.
Dodo Agent Plugin은 두 개의 MCP 서버와 여덟 개의 통합 기술을 단일 설치로 AI 코딩 에이전트에 연결합니다. **Claude Code**, **Codex CLI**, **Cursor**, **OpenCode**와 함께 작동합니다 — MCP 서버 및 기술 CLI는 MCP 호환 클라이언트와 함께 작동합니다.
**세 가지 기본 요소, 하나의 플러그인.** 에이전트 플러그인은 다음을 포함합니다:
* **API MCP 서버** — 결제, 구독, 고객, 제품, 환불, 라이선스, 사용에 대한 실시간 액세스. 브라우저 OAuth를 통해 인증(로컬 키 불필요).
* **Knowledge MCP 서버** — 모든 Dodo Payments 문서에 대한 의미론적 검색. 자격 증명이 필요하지 않음.
* **여덟 개의 에이전트 기술** — 체크아웃, 구독, 웹훅, 사용량 기반 청구, 크레딧 기반 청구, 라이선스 키, BillingSDK, 모범 사례를 위한 에이전트 로드.
## 플러그인 설치
아래에서 코딩 에이전트를 선택하세요. 설치는 두 MCP 서버와 여덟 기술을 자동으로 추가합니다.
마켓플레이스에서 설치:
```bash theme={null}
claude plugins marketplace add dodopayments/dodo-agent-plugin
claude plugins install dodopayments@dodopayments
```
API MCP 서버는 기본적으로 브라우저 OAuth를 사용합니다 — 설치 시 키가 필요하지 않습니다. 에이전트가 처음으로 Dodo 도구를 호출할 때 로그인을 요청받게 됩니다.
소스 코드, 구성 옵션 및 로컬 개발 지침
Codex는 두 단계로 플러그인을 설치합니다: 셸에서 마켓플레이스를 등록한 다음, Codex TUI 내부에서 플러그인을 설치합니다.
```bash theme={null}
codex plugin marketplace add dodopayments/dodo-agent-plugin
```
Codex를 열고 `/plugins` 슬래시 명령을 실행합니다:
```bash theme={null}
codex
```
그런 다음 `/plugins`을 입력하고 **Dodo Payments** 마켓플레이스로 전환하며, **dodopayments** 플러그인을 선택하고 **Install plugin**을 선택합니다.
플러그인이 설치되면 MCP 서버와 모든 8개의 스킬은 자동으로 등록됩니다.
Codex CLI에는 `codex plugin install` 서브 명령이 없습니다 — 플러그인 설치는 항상 in-TUI `/plugins` 흐름을 통해 이루어집니다. [공식 Codex 플러그인 문서](https://developers.openai.com/codex/plugins)를 참조하세요.
이전에 마켓플레이스를 추가했고 플러그인이 `/plugins` 아래에 나타나지 않으면 새로 고칩니다:
```bash theme={null}
codex plugin marketplace upgrade dodopayments
```
수동 설치 — Cursor의 로컬 플러그인 디렉토리에 리포를 클론합니다:
```bash theme={null}
git clone https://github.com/dodopayments/dodo-agent-plugin.git ~/.cursor/plugins/local/dodo-agent-plugin
```
Cursor를 재시작합니다. 플러그인은 `.claude/skills/` (Cursor의 Claude Code 호환 레이어 통해)에서 스킬을 로드하고, MCP 서버는 `.mcp.json`에서 로드합니다.
Cursor 마켓플레이스 지원이 곧 제공됩니다. 지금은 위의 수동 설치를 사용하세요.
OpenCode는 npm을 통해 배포합니다. 플러그인을 `opencode.json`에 추가하세요:
```json theme={null}
{
"$schema": "https://opencode.ai/config.json",
"plugin": ["@dodopayments/opencode-plugin"]
}
```
OpenCode를 재시작합니다. MCP 서버 (`dodopayments-api`, `dodo-knowledge`)는 플러그인의 구성 훅을 통해 자동으로 등록되며, 8개의 스킬은 설치된 패키지에서 자동으로 발견됩니다. 수동 `mcp` 블록이 필요하지 않습니다.
다른 에이전트를 사용 중이신가요? [MCP Server](/developer-resources/mcp-server) 및 [Agent Skills](/developer-resources/agent-skills) 가이드에는 Cursor, Claude Desktop, VS Code, Windsurf, Cline, Zed 및 MCP 호환 클라이언트가 다뤄집니다.
## 얻을 수 있는 것
플러그인이 설치되면, 에이전트는 두 개의 MCP 서버와 8개의 스킬에 접근할 수 있습니다.
### MCP 서버
| 서버 | 목적 | 인증 |
| ------------------ | ------------------------------------------ | ------------ |
| `dodopayments-api` | 라이브 API 접근 — 결제, 구독, 고객, 제품, 환불, 라이선스, 사용량 | OAuth (브라우저) |
| `dodo-knowledge` | 모든 Dodo Payments 문서의 시멘틱 검색 | 없음 |
두 서버는 `mcp-remote`를 통해 연결되어 MCP 호환 클라이언트에서 실행됩니다.
### 에이전트 스킬
| 스킬 | 설명 |
| -------------------------- | -------------------------------------- |
| `best-practices` | Dodo Payments를 통합하는 모범 사례에 대한 포괄적인 가이드 |
| `checkout-integration` | 결제 세션 및 결제 흐름 생성 |
| `subscription-integration` | 구독 청구 흐름 구현 |
| `webhook-integration` | 결제 이벤트에 대한 웹훅 설정 및 처리 |
| `usage-based-billing` | 이벤트 및 미터를 이용한 계량 청구 구현 |
| `credit-based-billing` | 크레딧 할당, 잔액 및 계량 크레딧 차감 |
| `license-keys` | 디지털 제품의 라이선스 키 관리 |
| `billing-sdk` | BillingSDK React 컴포넌트 사용 |
스킬은 자동으로 로드됩니다 — 에이전트는 관련 작업을 감지할 때 적합한 스킬을 선택합니다. 전체 목록 및 개별 설치에 대한 [Agent Skills 문서](/developer-resources/agent-skills)를 참조하세요.
### 이 프롬프트를 먼저 시도하세요
플러그인이 활성화되면 다음을 시도하세요:
```
Set up Dodo Payments webhook handlers in my Next.js app for payment.succeeded and subscription.active events.
```
에이전트는 `webhook-integration` 스킬을 로드하고, 최신 페이로드 형태를 가져오기 위해 `dodo-knowledge` MCP를 사용하고, 표준 웹훅 사양을 따라 서명 검증을 포함한 핸들러를 작성합니다.
## 지원되는 다른 에이전트
에이전트 플러그인은 Claude Code, Codex CLI, Cursor 및 OpenCode를 다룹니다. 다른 에이전트를 사용하는 경우, MCP 서버 및 스킬 CLI를 통해 Dodo Payments에 연결하세요:
| 에이전트 | 가장 빠른 경로 | 추가 지원 |
| ------------------------ | --------------------------------------------------- | ----------------------------------------------- |
| **Claude Code** | 에이전트 플러그인 (한 번의 명령) | MCP 서버, 개별 스킬 |
| **Codex CLI** | 에이전트 플러그인 (한 번의 명령) | MCP 서버 |
| **Cursor** | 에이전트 플러그인 (git clone) | MCP 서버 구성, 스킬 CLI |
| **OpenCode** | 에이전트 플러그인 (npm) | MCP 서버 구성, 스킬 CLI |
| GitHub Copilot (VS Code) | [MCP Server guide](/developer-resources/mcp-server) | [Skills CLI](/developer-resources/agent-skills) |
| Claude Desktop | [MCP Server guide](/developer-resources/mcp-server) | — |
| Windsurf | [MCP Server guide](/developer-resources/mcp-server) | [Skills CLI](/developer-resources/agent-skills) |
| Cline / Zed / 기타 | [MCP Server guide](/developer-resources/mcp-server) | [Skills CLI](/developer-resources/agent-skills) |
## 에이전트를 위한 문서
모든 Dodo Payments 문서 페이지는 AI 소비에 최적화된 형식으로 제공됩니다:
* **전체 문서 색인**: [`docs.dodopayments.com/llms.txt`](https://docs.dodopayments.com/llms.txt) — 컨텍스트 수용을 위한 전체 문서 색인을 제공합니다.
* **순수 마크다운**: 문서 URL에 `.md`을 추가하여 원시 마크다운 버전을 가져옵니다 (예: `/api-reference/introduction.md`).
* **소스 리포지토리**: [`github.com/dodopayments/dodo-docs`](https://github.com/dodopayments/dodo-docs) — 오프라인 인덱싱을 위해 클론하세요.
## 에이전트가 할 수 있는 일
플러그인이 설치되면, 코딩 에이전트는 다음을 수행할 수 있습니다:
* **결제 세션 및 결제 링크 생성** — [일회성 결제](/features/one-time-payment-products) 및 [구독](/features/subscription)
* **구독 및 사용량 기반 청구 완전 구성** — [구독](/features/subscription), [사용량 기반 청구](/features/usage-based-billing/introduction), [크레딧 기반 청구](/features/credit-based-billing)
* **표준 Webhooks 규격 핸들러 생성** 서명 검증 포함 — [Webhooks](/developer-resources/webhooks)
* **BillingSDK React 컴포넌트 연결** 가격표 및 구독 관리 — [BillingSDK](/developer-resources/billingsdk)
* **디지털 제품의 라이선스 키 흐름 작성** — [라이선스 키](/features/license-keys)
* **크레딧 기반 청구 구현** 권한, 잔액, 이월 및 초과 사용 포함 — [크레딧](/features/credit-based-billing)
## 보안 및 모범 사례
**운영 API 키를 커밋하지 마세요.** 개발 중에는 [테스트 모드](/miscellaneous/test-mode-vs-live-mode)를 사용하세요. 에이전트 플러그인은 기본적으로 브라우저 OAuth를 사용합니다 — 워크플로우가 필요할 경우에만 로컬 API 키로 전환하세요.
* **먼저 테스트 모드를 사용하세요.** `dodo_test_...` 키로 통합을 샌드박스에서 테스트한 후 라이브로 전환하세요. [Test Mode vs Live Mode](/miscellaneous/test-mode-vs-live-mode)를 참조하세요.
* **OAuth가 기본입니다.** 에이전트 플러그인은 브라우저 OAuth로 인증합니다 (로컬 비밀 없음). 필요하지 않은 경우 API 키 모드를 사용하지 마세요 — 아래 구성 섹션을 참조하세요.
* **에이전트가 생성한 코드를 검토하세요.** 항상 웹훅 핸들러에 표준 웹훅 사양을 따르는 서명 검증이 포함되어 있는지 확인하세요.
## API 키로 구성하기
기본적으로, 에이전트 플러그인은 브라우저 OAuth가 있는 원격 MCP 서버를 사용합니다 — 로컬 자격 증명이 필요 없습니다. 로컬 API 키가 필요한 경우 (예: CI 환경, 헤드리스 서버), stdio 모드로 전환할 수 있습니다.
`/plugins`를 Claude Code에서 열고, **Dodo Payments**를 선택하고, **구성 옵션**을 선택하세요. 다음을 입력하세요:
* `dodo_api_key` — 당신의 `dodo_test_...` 또는 `dodo_live_...` 키
* `dodo_webhook_key` — 당신의 웹훅 서명 비밀
* `dodo_environment` — `test_mode` 또는 `live_mode`
그런 다음 `.mcp.json`를 편집하여 `dodopayments-api`가 로컬 stdio 서버를 가리키도록 합니다:
```json theme={null}
{
"mcpServers": {
"dodopayments-api": {
"type": "stdio",
"command": "npx",
"args": ["-y", "dodopayments-mcp@latest"],
"env": {
"DODO_PAYMENTS_API_KEY": "${user_config.dodo_api_key}",
"DODO_PAYMENTS_WEBHOOK_KEY": "${user_config.dodo_webhook_key}",
"DODO_PAYMENTS_ENVIRONMENT": "${user_config.dodo_environment}"
}
}
}
}
```
`/reload-plugins`를 실행하여 현재 세션에 변경 사항을 적용합니다.
`dodopayments-api`를 `opencode.json`에서 직접 선언하세요 — 당신의 항목이 플러그인의 기본 원격 서버에 우선합니다:
```json theme={null}
{
"$schema": "https://opencode.ai/config.json",
"plugin": ["@dodopayments/opencode-plugin"],
"mcp": {
"dodopayments-api": {
"type": "local",
"command": ["npx", "-y", "dodopayments-mcp@latest"],
"environment": {
"DODO_PAYMENTS_API_KEY": "dodo_test_...",
"DODO_PAYMENTS_WEBHOOK_KEY": "whsec_...",
"DODO_PAYMENTS_ENVIRONMENT": "test_mode"
},
"enabled": true
}
}
}
```
OpenCode를 재시작하여 적용하십시오.
## 다음 단계
두 MCP 서버에 대한 전체 참조 — 지원되는 모든 클라이언트, 구성 및 사용 가능한 도구
개별 스킬 설치, 스킬 참조 및 에이전트별 설정 지침
VS Code, Cursor 및 Windsurf용 AI 기반 청구 도우미 — 편집기 내에서 질문, 빌드 및 계획
모든 Dodo Payments 엔드포인트의 완전한 OpenAPI 참조