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

Dodo Agent Plugin은 두 개의 MCP 서버와 여덟 개의 통합 기술을 단일 설치로 AI 코딩 에이전트에 연결합니다. Claude Code, Codex CLI, Cursor, OpenCode와 함께 작동합니다 — MCP 서버 및 기술 CLI는 MCP 호환 클라이언트와 함께 작동합니다.

세 가지 기본 요소, 하나의 플러그인. 에이전트 플러그인은 다음을 포함합니다:

API MCP 서버 — 결제, 구독, 고객, 제품, 환불, 라이선스, 사용에 대한 실시간 액세스. 브라우저 OAuth를 통해 인증(로컬 키 불필요).
Knowledge MCP 서버 — 모든 Dodo Payments 문서에 대한 의미론적 검색. 자격 증명이 필요하지 않음.
여덟 개의 에이전트 기술 — 체크아웃, 구독, 웹훅, 사용량 기반 청구, 크레딧 기반 청구, 라이선스 키, BillingSDK, 모범 사례를 위한 에이전트 로드.

플러그인 설치

아래에서 코딩 에이전트를 선택하세요. 설치는 두 MCP 서버와 여덟 기술을 자동으로 추가합니다.

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는 두 단계로 플러그인을 설치합니다: 셸에서 마켓플레이스를 등록한 다음, 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 서버와 모든 8개의 스킬은 자동으로 등록됩니다.

Codex CLI에는 codex plugin install 서브 명령이 없습니다 — 플러그인 설치는 항상 in-TUI /plugins 흐름을 통해 이루어집니다. 공식 Codex 플러그인 문서를 참조하세요.

이전에 마켓플레이스를 추가했고 플러그인이 /plugins 아래에 나타나지 않으면 새로 고칩니다:

codex plugin marketplace upgrade dodopayments

Cursor

수동 설치 — Cursor의 로컬 플러그인 디렉토리에 리포를 클론합니다:

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

OpenCode는 npm을 통해 배포합니다. 플러그인을 opencode.json에 추가하세요:

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

OpenCode를 재시작합니다. MCP 서버 (dodopayments-api, dodo-knowledge)는 플러그인의 구성 훅을 통해 자동으로 등록되며, 8개의 스킬은 설치된 패키지에서 자동으로 발견됩니다. 수동 mcp 블록이 필요하지 않습니다.

다른 에이전트를 사용 중이신가요? MCP Server 및 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 문서를 참조하세요.

이 프롬프트를 먼저 시도하세요

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

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	Skills CLI
Claude Desktop	MCP Server guide	—
Windsurf	MCP Server guide	Skills CLI
Cline / Zed / 기타	MCP Server guide	Skills CLI

에이전트를 위한 문서

모든 Dodo Payments 문서 페이지는 AI 소비에 최적화된 형식으로 제공됩니다:

전체 문서 색인: docs.dodopayments.com/llms.txt — 컨텍스트 수용을 위한 전체 문서 색인을 제공합니다.
순수 마크다운: 문서 URL에 .md을 추가하여 원시 마크다운 버전을 가져옵니다 (예: /api-reference/introduction.md).
소스 리포지토리: github.com/dodopayments/dodo-docs — 오프라인 인덱싱을 위해 클론하세요.

에이전트가 할 수 있는 일

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

결제 세션 및 결제 링크 생성 — 일회성 결제 및 구독
구독 및 사용량 기반 청구 완전 구성 — 구독, 사용량 기반 청구, 크레딧 기반 청구
표준 Webhooks 규격 핸들러 생성 서명 검증 포함 — Webhooks
BillingSDK React 컴포넌트 연결 가격표 및 구독 관리 — BillingSDK
디지털 제품의 라이선스 키 흐름 작성 — 라이선스 키
크레딧 기반 청구 구현 권한, 잔액, 이월 및 초과 사용 포함 — 크레딧

보안 및 모범 사례

운영 API 키를 커밋하지 마세요. 개발 중에는 테스트 모드를 사용하세요. 에이전트 플러그인은 기본적으로 브라우저 OAuth를 사용합니다 — 워크플로우가 필요할 경우에만 로컬 API 키로 전환하세요.

먼저 테스트 모드를 사용하세요. dodo_test_... 키로 통합을 샌드박스에서 테스트한 후 라이브로 전환하세요. Test Mode vs Live Mode를 참조하세요.
OAuth가 기본입니다. 에이전트 플러그인은 브라우저 OAuth로 인증합니다 (로컬 비밀 없음). 필요하지 않은 경우 API 키 모드를 사용하지 마세요 — 아래 구성 섹션을 참조하세요.
에이전트가 생성한 코드를 검토하세요. 항상 웹훅 핸들러에 표준 웹훅 사양을 따르는 서명 검증이 포함되어 있는지 확인하세요.

API 키로 구성하기

기본적으로, 에이전트 플러그인은 브라우저 OAuth가 있는 원격 MCP 서버를 사용합니다 — 로컬 자격 증명이 필요 없습니다. 로컬 API 키가 필요한 경우 (예: CI 환경, 헤드리스 서버), stdio 모드로 전환할 수 있습니다.

Local API key mode — Claude Code

/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 서버를 가리키도록 합니다:

{
  "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에서 직접 선언하세요 — 당신의 항목이 플러그인의 기본 원격 서버에 우선합니다:

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

두 MCP 서버에 대한 전체 참조 — 지원되는 모든 클라이언트, 구성 및 사용 가능한 도구

Agent Skills

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

Sentra IDE Assistant

VS Code, Cursor 및 Windsurf용 AI 기반 청구 도우미 — 편집기 내에서 질문, 빌드 및 계획

API Reference

모든 Dodo Payments 엔드포인트의 완전한 OpenAPI 참조

Documentation Index

​플러그인 설치

Dodo Agent Plugin on GitHub

​얻을 수 있는 것

​MCP 서버

​에이전트 스킬

​이 프롬프트를 먼저 시도하세요

​지원되는 다른 에이전트

​에이전트를 위한 문서

​에이전트가 할 수 있는 일

​보안 및 모범 사례

​API 키로 구성하기

​다음 단계

MCP Server

Agent Skills

Sentra IDE Assistant

API Reference

플러그인 설치

얻을 수 있는 것

MCP 서버

에이전트 스킬

이 프롬프트를 먼저 시도하세요

지원되는 다른 에이전트

에이전트를 위한 문서

에이전트가 할 수 있는 일

보안 및 모범 사례

API 키로 구성하기

다음 단계