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

Dodo Agent Plugin을 설치하여 코딩 에이전트에 Dodo Payments 통합을 구축하기 위한 두 개의 MCP 서버와 17개의 스킬을 제공하세요. 설치한 후 구축하려는 내용을 설명하면 에이전트가 통합을 계획하고 작성합니다. 이 플러그인은 Claude Code, Codex CLI, Cursor, VS Code / GitHub Copilot, Kiro, OpenCode에서 작동합니다. Gemini CLI에서는 두 개의 MCP 서버만 사용할 수 있습니다.

플러그인 설치

아래에서 사용할 코딩 에이전트를 선택하세요. 설치할 때마다 두 MCP 서버가 모두 추가됩니다. Gemini CLI를 제외한 모든 에이전트에는 17개의 스킬도 추가됩니다. OpenCode에서 스킬을 로드하려면 추가 설정이 하나 필요하며, 해당 에이전트 섹션에서 설명합니다.

Claude Code

마켓플레이스에서 설치:

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

API MCP 서버는 기본적으로 브라우저 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 마켓플레이스로 전환한 다음 dodopayments 플러그인을 선택하고 Install plugin을 선택하세요.

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

codex plugin marketplace upgrade dodopayments

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

Cursor

Cursor의 로컬 플러그인 디렉터리에 리포지토리를 클론하세요:

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

Cursor를 다시 시작하세요. 플러그인은 skills/에서 스킬을 로드하고 .mcp.json에서 MCP 서버를 로드합니다.최신 Cursor 빌드는 Agent Plugins 1.0.0을 직접 인식하고 .claude-plugin/marketplace.json을 마켓플레이스 소스로 허용합니다. 생성된 .cursor-plugin/plugin.json은 이전 빌드를 위해 유지됩니다.0.5.0 이전 버전을 설치했다면 디렉터리를 삭제하고 다시 클론하세요. 이제 스킬은 심볼릭 링크가 아닌 실제 파일로 제공됩니다.

OpenCode

프로젝트에 플러그인 패키지를 설치한 다음 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는 설치된 패키지에서 스킬을 검색하지 않으므로 스킬을 로드하려면 추가 skills.paths 항목이 필요합니다.상대 경로는 프로젝트 디렉터리를 기준으로 확인되므로 패키지가 해당 프로젝트의 node_modules에 있어야 합니다. 절대 경로를 사용하면 로컬 설치 요구 사항도 피할 수 있습니다.스킬이 로드되었는지 확인하세요:

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

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

VS Code / GitHub Copilot

리포지토리를 클론하고 등록하세요:

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

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

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

키는 경로이고 값은 해당 경로를 활성화합니다. 절대 경로와 ~/ 모두 사용할 수 있으며, 상대 경로는 각 workspace 폴더를 기준으로 확인됩니다. 설정은 실시간으로 읽히므로 실행 중인 창에서도 다시 시작하지 않고 적용됩니다.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 패널(번개가 표시된 Ghosty 아이콘)을 여세요.

Import the folder

Add Custom Power → Import power from a folder를 선택하고, 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 같은 사양을 기본 지원하는 클라이언트가 이를 사용합니다. 생성된 호환성 manifest .mcp.json은 Streamable HTTP에 직접 연결할 수 없는 클라이언트를 위해 mcp-remote을 통해 연결합니다.

Agent Skills

스킬	설명
`dodo-best-practices`	SDK 설정, 환경, API 키 및 표준 checkout-to-webhook 아키텍처
`framework-adapters`	Next.js, Express, Hono, Astro, Remix, SvelteKit, Nuxt, Fastify, TanStack, Bun 및 Convex용 공식 `@dodopayments/*` route handler
`testing-and-go-live`	Test mode, 테스트 결제 수단, webhook 테스트 및 production launch 체크리스트
`checkout-integration`	Checkout Sessions, payment links 및 overlay 또는 inline checkout
`subscription-integration`	구독 수명 주기, trial, 플랜 변경, proration 및 주문형 청구
`mobile-checkout`	React Native, Flutter, iOS 및 Android용 인앱 checkout
`webhook-integration`	Standard Webhooks 사양을 사용한 webhook 수신 및 검증
`credit-based-billing`	크레딧 entitlement, 잔액, ledger, rollover, overage 및 meter 기반 차감
`usage-based-billing`	meter, 이벤트 수집, 집계 및 단위별 가격 책정
`license-keys`	라이선스 키 활성화, 검증 및 인스턴스 관리
`product-catalog-management`	제품, 가격, 애드온, 컬렉션, 이미지 및 디지털 제품 제공
`discounts-and-promotions`	할인 코드, 자격 규칙, 중복 적용 및 구독 주기 제한
`localized-pricing`	현지화된 가격, adaptive currency 및 구매력 평가
`customer-management`	고객, 셀프 서비스 포털, 저장된 결제 수단 및 wallet
`refunds-and-disputes`	환불 처리, 분쟁 및 chargeback 처리, 액세스 조정
`billing-sdk`	가격표 및 billing UI용 BillingSDK React 컴포넌트
`better-auth-integration`	고객 동기화, checkout 및 포털 액세스를 위한 `@dodopayments/better-auth` 플러그인

스킬은 자동으로 로드되며, 에이전트는 관련 작업을 감지하면 적절한 스킬을 선택합니다. 전체 목록과 개별 설치 방법은 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를 사용해 최신 payload 형태를 가져온 다음, Standard Webhooks 사양에 따라 signature verification을 포함한 handler를 작성합니다.

클라이언트 지원

플러그인은 Agent Plugins 1.0.0 사양을 따릅니다. 기본 지원 기능이 있는 클라이언트는 직접 로드하고, 그 외 클라이언트는 생성된 호환성 manifest를 사용합니다.

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

한 번 설치하면 두 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

OpenCode에서는 17개의 스킬이 로드되기 전에 추가 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 — 오프라인 색인을 위해 클론

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

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

checkout session 및 payment link 생성 — 일회성 결제 및 구독
구독 및 사용량 기반 billing을 처음부터 끝까지 구축 — 구독, 사용량 기반 billing, 크레딧 기반 billing
signature verification을 포함한 Standard Webhooks 호환 handler 생성 — Webhooks
공식 adapter를 사용해 프레임워크에 route handler 연결 — Framework adaptor
가격표 및 구독 관리용 BillingSDK React 컴포넌트 연결 — BillingSDK
디지털 제품용 라이선스 키 흐름 작성 — 라이선스 키
entitlement, 잔액, rollover 및 overage를 포함한 크레딧 기반 billing 구현 — 크레딧
애드온 및 컬렉션을 포함한 제품 카탈로그 구축 및 관리 — 제품, 애드온, 제품 컬렉션
할인 및 현지화된 가격 추가 — 할인 코드, 현지화된 가격, Adaptive Currency
React Native, Flutter, iOS 및 Android용 모바일 인앱 checkout 제공 — 모바일 통합
환불, 분쟁 및 고객 셀프 서비스 처리 — 환불, 분쟁, Customer Portal
통합을 테스트하고 안전하게 라이브 환경으로 전환 — Test mode와 live mode 비교

보안 및 모범 사례

라이브 API 키를 커밋하지 마세요. 개발 중에는 test mode를 사용하세요.

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

API 키로 구성

기본적으로 Agent Plugin은 브라우저 OAuth를 사용하는 원격 MCP 서버를 사용합니다. 예를 들어 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 서버를 가리키도록 하세요:

{
  "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

opencode.json에서 dodopayments-api을 직접 선언하세요. 사용자가 추가한 항목이 플러그인의 기본 원격 서버보다 우선합니다:

{
  "$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 서버에 대한 전체 reference — 지원되는 모든 클라이언트, 구성 및 사용 가능한 도구

Agent Skills

개별 스킬 설치, 스킬 reference 및 에이전트별 설정 지침

API Reference

모든 Dodo Payments endpoint에 대한 전체 OpenAPI reference

Getting Started

Features

Integrate

Merchant of Record

Miscellaneous

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

플러그인 설치

Dodo Agent Plugin on GitHub

제공되는 기능

MCP 서버

Agent Skills

먼저 사용해 볼 프롬프트

클라이언트 지원

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

기타 MCP 호환 클라이언트

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

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

보안 및 모범 사례

API 키로 구성

다음 단계

MCP Server

Agent Skills

API Reference

​플러그인 설치

Dodo Agent Plugin on GitHub

​제공되는 기능

​MCP 서버

​Agent Skills

​먼저 사용해 볼 프롬프트

​클라이언트 지원

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

​기타 MCP 호환 클라이언트

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

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

​보안 및 모범 사례

​API 키로 구성

​다음 단계

MCP Server

Agent Skills

API Reference

플러그인 설치

제공되는 기능

MCP 서버

Agent Skills

먼저 사용해 볼 프롬프트

클라이언트 지원

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

기타 MCP 호환 클라이언트

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

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

보안 및 모범 사례

API 키로 구성

다음 단계