AI 코딩 에이전트와 함께 구축하기

Dodo Agent Plugin을 설치하여 코딩 에이전트에 Dodo Payments 통합을 구축하기 위한 두 개의 MCP 서버와 17개의 스킬을 제공하세요. 설치한 후 구축하려는 내용을 설명하면 에이전트가 통합을 계획하고 작성합니다. 이 플러그인은 Claude Code, Codex CLI, Cursor, VS Code / GitHub Copilot, Kiro, OpenCode에서 작동합니다. Gemini CLI에서는 두 개의 MCP 서버만 사용할 수 있습니다. 이 플러그인은 Agent Plugins 1.0.0 사양을 따릅니다. 기본 지원 기능이 있는 클라이언트는 이를 직접 로드하고, 그 외 클라이언트는 생성된 호환성 매니페스트를 사용합니다. 제공되는 기능:

Dodo Payments API MCP server — 결제, 구독, 고객, 제품, 환불, 라이선스 및 사용량에 실시간으로 액세스합니다. 브라우저 OAuth를 통해 인증하므로 로컬 키가 필요하지 않습니다.
Dodo Knowledge MCP server — 모든 Dodo Payments 문서에서 시맨틱 검색을 수행합니다. 자격 증명이 필요하지 않습니다.
17개의 에이전트 스킬 — checkout, 구독, 웹훅, 사용량 기반 및 크레딧 기반 결제, 라이선스 키, 제품 카탈로그, 할인, 현지화된 가격, 모바일 checkout, 환불 및 분쟁, 고객 관리, framework adapter, BillingSDK, Better Auth, 테스트 및 go-live, 모범 사례에 대해 에이전트가 필요할 때 로드하는 치트 시트입니다.

플러그인 설치

아래에서 사용할 코딩 에이전트를 선택하세요. 모든 설치 과정에서 두 MCP 서버가 추가됩니다. Gemini CLI를 제외한 모든 에이전트에는 17개의 스킬도 추가됩니다. OpenCode는 스킬을 로드하기 위해 추가 설정이 필요하며, 해당 내용은 OpenCode 섹션에 설명되어 있습니다.

Claude Code

마켓플레이스에서 설치하세요:

claude plugins marketplace add dodopayments/dodo-agent-plugin
claude plugins install dodopayments@dodopayments

API MCP server는 기본적으로 브라우저 OAuth를 사용하므로 설치할 때 키가 필요하지 않습니다. 에이전트가 Dodo 도구를 처음 호출하면 로그인하라는 메시지가 표시됩니다.

Dodo Agent Plugin on GitHub

소스 코드, 구성 옵션 및 로컬 개발 지침

Codex CLI

마켓플레이스를 등록한 다음 Codex TUI에서 설치하세요.

codex plugin marketplace add dodopayments/dodo-agent-plugin

Install from the Codex TUI

Codex를 열고 /plugins을 실행하세요:

codex

/plugins을 입력하고 Dodo Payments marketplace로 전환한 다음 dodopayments plugin을 선택하고 Install plugin을 선택하세요.

두 MCP 서버와 17개의 스킬이 모두 자동으로 등록됩니다.플러그인이 /plugins 아래에 표시되지 않으면 새로 고침하세요:

codex plugin marketplace upgrade dodopayments

TUI 대신 shell에서 설치하려면 마켓플레이스를 등록한 후 codex plugin add dodopayments@dodopayments을 실행하세요. Codex CLI에는 codex plugin install 하위 명령이 없습니다. 공식 Codex plugins 문서를 참조하세요.

Cursor

저장소를 Cursor의 로컬 plugins 디렉터리에 clone하세요:

git clone https://github.com/dodopayments/dodo-agent-plugin.git ~/.cursor/plugins/local/dodo-agent-plugin

Cursor를 다시 시작하세요. 플러그인은 skills/에서 스킬을 로드하고 .mcp.json에서 MCP 서버를 로드합니다.최근 Cursor build는 Agent Plugins 1.0.0을 직접 인식하며 .claude-plugin/marketplace.json을 marketplace source로 허용합니다. 생성된 .cursor-plugin/plugin.json은 이전 build를 위해 유지됩니다.0.5.0 이전 버전을 설치했다면 디렉터리를 삭제하고 다시 clone하세요. 이제 스킬은 symlink가 아닌 실제 파일로 제공됩니다.

OpenCode

프로젝트에 plugin package를 설치한 다음 opencode.json에 해당 패키지와 스킬 경로를 추가하세요:

npm install --save-dev @dodopayments/opencode-plugin

{
  "$schema": "https://opencode.ai/config.json",
  "plugin": ["@dodopayments/opencode-plugin"],
  "skills": {
    "paths": ["node_modules/@dodopayments/opencode-plugin/skills"]
  }
}

OpenCode를 다시 시작하세요. 두 MCP 서버가 자동으로 등록됩니다. OpenCode는 설치된 package에서 스킬을 검색하지 않으므로 스킬에는 추가 skills.paths 항목이 필요합니다.상대 경로는 프로젝트 디렉터리를 기준으로 확인되므로 package가 해당 프로젝트의 node_modules에 있어야 합니다. 절대 경로를 사용하면 로컬 설치 요구 사항을 피할 수 있습니다.스킬이 로드되었는지 확인하세요:

opencode run "List every skill available to you by name."

17개가 모두 표시되어야 합니다. 존재하지 않는 스킬 경로는 자동으로 무시되므로 추측하지 말고 확인하세요.

VS Code / GitHub Copilot

저장소를 clone하고 등록하세요:

git clone https://github.com/dodopayments/dodo-agent-plugin.git ~/dodo-agent-plugin

Chat view를 열고 Plugins로 이동한 다음 clone한 폴더를 추가하세요. 또는 settings.json에 등록하세요:

{
  "chat.pluginLocations": { "~/dodo-agent-plugin": true }
}

키는 경로이고 값은 활성화 여부를 설정합니다. 절대 경로와 ~/ 모두 사용할 수 있으며, 상대 경로는 각 workspace folder를 기준으로 확인됩니다. 설정은 실시간으로 읽히므로 실행 중인 window에서도 다시 시작하지 않고 적용됩니다.chat.pluginLocations은 experimental로 표시된 제한된 설정이므로 workspace를 신뢰해야 합니다. Agent-plugin 지원은 chat.plugins.enabled에 의해 관리되는 preview 기능이며 기본적으로 활성화되어 있습니다.

Kiro

Kiro는 Agent Plugins manifest를 기본적으로 읽습니다.

Clone the repository

git clone https://github.com/dodopayments/dodo-agent-plugin.git

Open the Powers panel

Kiro에서 Powers panel(Ghosty 아이콘과 번개 모양)을 여세요.

Import the folder

Add Custom Power → Import power from a folder를 선택하고 clone한 디렉터리(plugin.json를 포함하는 디렉터리)를 선택한 다음 Install을 클릭하세요.

스킬은 skills/에서, MCP 서버는 mcp.json에서 로드됩니다. Kiro는 MCP 서버를 내부적으로 관리하므로 ~/.kiro/settings/mcp.json에 기록되지 않습니다. Kiro는 GitHub URL에서 직접 Power를 설치할 수도 있습니다. Kiro의 설치 문서를 참조하세요.

Gemini CLI (MCP only)

Gemini CLI에는 agent-skill primitive가 없으므로 두 MCP 서버만 사용할 수 있습니다. dodo-knowledge은 스킬이 제공하는 기능의 상당 부분을 포함하며 자동으로 최신 상태를 유지합니다.

git clone https://github.com/dodopayments/dodo-agent-plugin.git \
  ~/.gemini/extensions/dodopayments

Gemini CLI를 다시 시작하세요. 저장소 루트의 gemini-extension.json이 manifest입니다.

다른 에이전트를 사용하시나요? MCP Server 및 Agent Skills 가이드에서 Claude Desktop, Windsurf, Cline, Zed 및 MCP 호환 클라이언트를 다룹니다.

제공되는 기능

설치가 완료되면 에이전트가 두 MCP 서버와 17개의 스킬에 액세스할 수 있습니다.

MCP 서버

서버	용도	인증
`dodopayments-api`	실시간 API 액세스 — 결제, 구독, 고객, 제품, 환불, 라이선스, 사용량	OAuth(브라우저)
`dodo-knowledge`	모든 Dodo Payments 문서에서 시맨틱 검색	없음

두 서버 모두 Streamable HTTP를 사용합니다. 표준 mcp.json은 이를 기본적으로 선언하며, Codex CLI 및 Kiro와 같은 spec-native 클라이언트가 사용합니다. 생성된 호환성 매니페스트 .mcp.json은 Streamable HTTP에 직접 연결할 수 없는 클라이언트를 위해 mcp-remote을 통해 연결합니다.

에이전트 스킬

스킬	설명
`dodo-best-practices`	SDK 설정, 환경, API 키 및 표준 checkout-to-webhook architecture
`framework-adapters`	Next.js, Express, Hono, Astro, Remix, SvelteKit, Nuxt, Fastify, TanStack, Bun 및 Convex를 위한 공식 `@dodopayments/*` route handler
`testing-and-go-live`	Test mode, 테스트 결제 수단, 웹훅 테스트 및 production launch checklist
`checkout-integration`	Checkout Sessions, payment links 및 overlay 또는 inline checkout
`subscription-integration`	구독 lifecycle, trial, plan 변경, proration 및 on-demand charge
`mobile-checkout`	React Native, Flutter, iOS 및 Android용 인앱 checkout
`webhook-integration`	Standard Webhooks 사양을 사용한 웹훅 수신 및 검증
`credit-based-billing`	크레딧 entitlement, balance, ledger, rollover, overage 및 meter 기반 deduction
`usage-based-billing`	Meter, 이벤트 수집, aggregation 및 단위당 가격 책정
`license-keys`	라이선스 키 활성화, 검증 및 instance 관리
`product-catalog-management`	제품, 가격, add-on, collection, 이미지 및 디지털 제품 제공
`discounts-and-promotions`	Discount code, eligibility rule, stacking 및 구독 주기 제한
`localized-pricing`	현지화된 가격, adaptive currency 및 purchasing power parity
`customer-management`	고객, self-service portal, 저장된 결제 수단 및 wallet
`refunds-and-disputes`	환불 발행, 분쟁 및 chargeback 처리, 액세스 조정
`billing-sdk`	가격표 및 billing UI용 BillingSDK React component
`better-auth-integration`	고객 sync, checkout 및 portal 액세스를 위한 `@dodopayments/better-auth` plugin

스킬은 자동으로 로드되며, 관련 작업을 감지하면 에이전트가 적절한 스킬을 선택합니다. 전체 목록과 개별 설치 방법은 Agent Skills를 참조하세요.

먼저 시도할 프롬프트

플러그인이 활성화되면 다음을 시도하세요:

Set up Dodo Payments webhook handlers in my Next.js app for payment.succeeded and subscription.active events.

에이전트는 webhook-integration skill을 로드하고 dodo-knowledge MCP를 사용하여 최신 payload shape를 가져온 다음 Standard Webhooks 사양에 따라 signature verification이 포함된 handler를 작성합니다.

클라이언트 지원

플러그인 설치를 지원하는 에이전트

한 번 설치하면 두 MCP 서버가 연결되며, skill primitive가 있는 모든 클라이언트에 스킬도 추가됩니다.

에이전트	설치	스킬	MCP 서버
Claude Code	marketplace command	17	2
Codex CLI	marketplace command	17	2
Cursor	git clone	17	2
VS Code / GitHub Copilot	git clone	17	2
Kiro	git clone	17	2
OpenCode	npm	17	2
Gemini CLI	git clone	0	2

17개의 스킬이 로드되기 전에 OpenCode에는 추가 skills.paths 항목이 필요합니다. Gemini CLI에는 agent-skill primitive가 없으므로 설계상 스킬을 사용할 수 없습니다.

기타 MCP 호환 클라이언트

이 클라이언트에는 Agent Plugin 설치 기능이 없습니다. 두 MCP 서버를 수동으로 구성하고, 지원되는 경우 Skills CLI를 통해 스킬을 추가하세요.

에이전트	MCP 서버	스킬
Claude Desktop	MCP Server 가이드	지원되지 않음
Windsurf	MCP Server 가이드	Skills CLI
Cline / Zed / 기타	MCP Server 가이드	Skills CLI

에이전트를 위해 구축된 문서

모든 Dodo Payments 문서 페이지는 AI가 쉽게 사용할 수 있도록 최적화된 형식으로 제공됩니다:

전체 문서 색인: docs.dodopayments.com/llms.txt — 컨텍스트 수집을 위한 전체 문서 색인
일반 markdown: 모든 문서 URL에 .md을 추가하면 원시 markdown 버전을 가져옵니다(예: /api-reference/introduction.md)
소스 저장소: github.com/dodopayments/dodo-docs — 오프라인 색인을 위해 clone

에이전트가 수행할 수 있는 작업

플러그인을 설치하면 코딩 에이전트가 다음을 수행할 수 있습니다:

checkout session 및 payment link 생성 — 일회성 결제 및 구독
구독 및 사용량 기반 결제를 처음부터 끝까지 구축 — 구독, 사용량 기반 결제, 크레딧 기반 결제
signature verification을 포함한 Standard Webhooks 호환 handler 생성 — 웹훅
공식 adapter를 사용하여 framework에 route handler 연결 — Framework adaptor
가격표 및 구독 관리용 BillingSDK React component 연결 — BillingSDK
디지털 제품을 위한 라이선스 키 흐름 작성 — 라이선스 키
entitlement, balance, rollover 및 overage를 포함한 크레딧 기반 결제 구현 — 크레딧
add-on 및 collection을 포함한 제품 카탈로그 구축 및 관리 — 제품, Add-on, 제품 collection
할인 및 현지화된 가격 추가 — Discount code, 현지화된 가격, Adaptive currency
React Native, Flutter, iOS 및 Android용 모바일 인앱 checkout 제공 — 모바일 통합
환불, 분쟁 및 고객 self-service 처리 — 환불, 분쟁, Customer portal
통합을 테스트하고 안전하게 go-live — Test mode와 live mode 비교

보안 및 모범 사례

live API 키를 절대 commit하지 마세요. 개발 중에는 test mode를 사용하세요.

먼저 test mode를 사용하세요. go-live 전에 test mode API 키로 통합을 구축하고 테스트하세요. Test Mode와 Live Mode 비교를 참조하세요.
OAuth가 기본값입니다. Agent Plugin은 브라우저 OAuth를 통해 인증하므로 로컬 secret이 필요하지 않습니다. 필요한 경우에만 API-key mode를 사용하세요.
에이전트가 생성한 코드를 검토하세요. 웹훅 handler에 Standard Webhooks 사양에 따른 signature verification이 포함되어 있는지 항상 확인하세요.

API 키로 구성

기본적으로 Agent Plugin은 브라우저 OAuth를 사용하는 remote MCP server를 사용합니다. 예를 들어 CI 또는 headless server에서 대신 로컬 API 키를 사용하려면 stdio mode로 전환하세요.

Local API key mode — Claude Code

Claude Code에서 /plugins을 열고 Dodo Payments를 선택한 다음 Configure options를 선택하세요. 다음 값을 입력합니다:

dodo_api_key — test mode 또는 live mode API 키
dodo_webhook_key — webhook signing secret
dodo_environment — test_mode 또는 live_mode

그런 다음 .mcp.json을 편집하여 dodopayments-api이 로컬 stdio server를 가리키도록 하세요:

{
  "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을 실행하세요.

Local API key mode — OpenCode

dodopayments-api을 opencode.json에 직접 선언하세요. 해당 항목이 plugin의 기본 remote server보다 우선합니다:

{
  "$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": "YOUR_TEST_MODE_API_KEY",
        "DODO_PAYMENTS_WEBHOOK_KEY": "whsec_...",
        "DODO_PAYMENTS_ENVIRONMENT": "test_mode"
      },
      "enabled": true
    }
  }
}

적용하려면 OpenCode를 다시 시작하세요.

다음 단계

MCP Server

두 MCP 서버의 전체 레퍼런스 — 지원되는 모든 클라이언트, 구성 및 사용 가능한 도구

Agent Skills

개별 스킬 설치, 스킬 레퍼런스 및 에이전트별 설정 지침

API Reference

모든 Dodo Payments endpoint의 전체 OpenAPI 레퍼런스

Getting Started

Features

Integrate

Merchant of Record

Miscellaneous

AI 코딩 에이전트와 함께 구축하기

플러그인 설치

Dodo Agent Plugin on GitHub

제공되는 기능

MCP 서버

에이전트 스킬

먼저 시도할 프롬프트

클라이언트 지원

플러그인 설치를 지원하는 에이전트

기타 MCP 호환 클라이언트

에이전트를 위해 구축된 문서

에이전트가 수행할 수 있는 작업

보안 및 모범 사례

API 키로 구성

다음 단계

MCP Server

Agent Skills

API Reference

​플러그인 설치

Dodo Agent Plugin on GitHub

​제공되는 기능

​MCP 서버

​에이전트 스킬

​먼저 시도할 프롬프트

​클라이언트 지원

​플러그인 설치를 지원하는 에이전트

​기타 MCP 호환 클라이언트

​에이전트를 위해 구축된 문서

​에이전트가 수행할 수 있는 작업

​보안 및 모범 사례

​API 키로 구성

​다음 단계

MCP Server

Agent Skills

API Reference

플러그인 설치

제공되는 기능

MCP 서버

에이전트 스킬

먼저 시도할 프롬프트

클라이언트 지원

플러그인 설치를 지원하는 에이전트

기타 MCP 호환 클라이언트

에이전트를 위해 구축된 문서

에이전트가 수행할 수 있는 작업

보안 및 모범 사례

API 키로 구성

다음 단계