AI Coding Agentsで構築する

Dodo Agent Pluginをインストールすると、2つのMCPサーバーと17個のスキルがコーディングエージェントに追加され、Dodo Payments統合を構築できます。インストール後、構築したいものを説明すると、エージェントが統合を計画して実装します。このプラグインは、Claude Code、Codex CLI、Cursor、VS Code / GitHub Copilot、Kiro、OpenCodeで動作します。Gemini CLIでは2つのMCPサーバーのみ利用できます。このプラグインはAgent Plugins 1.0.0仕様に準拠しています。ネイティブサポートを備えたクライアントは直接読み込み、それ以外のクライアントでは互換性マニフェストを生成して使用します。 利用できるもの:

Dodo Payments API MCP server — 決済、サブスクリプション、顧客、商品、返金、ライセンス、使用量にライブアクセスできます。ブラウザOAuthで認証するため、ローカルキーは不要です。
Dodo Knowledge MCP server — Dodo Paymentsの全ドキュメントを対象にセマンティック検索を実行できます。認証情報は不要です。
17個のエージェントスキル — checkout、サブスクリプション、webhook、使用量ベースおよびクレジットベースの課金、ライセンスキー、商品カタログ、割引、ローカライズ価格、モバイルcheckout、返金と異議申し立て、顧客管理、framework adapter、BillingSDK、Better Auth、テストと本番リリース、ベストプラクティスに関するチートシートを、エージェントが必要に応じて読み込みます。

Pluginをインストールする

以下から使用するコーディングエージェントを選択してください。どのインストールでも両方のMCPサーバーが追加されます。Gemini CLI以外のすべてのエージェントでは、17個のスキルも追加されます。OpenCodeではスキルを読み込むために追加設定が1つ必要です。詳しくは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個すべてのスキルが自動的に登録されます。pluginが/pluginsに表示されない場合は、更新します:

codex plugin marketplace upgrade dodopayments

TUIではなくshellからインストールするには、marketplaceの登録後にcodex plugin add dodopayments@dodopaymentsを実行します。Codex CLIにはcodex plugin install subcommandはありません。公式のCodex pluginsドキュメントを参照してください。

Cursor

repoをCursorのローカルplugins directoryにcloneします:

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

Cursorを再起動します。pluginは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より前のversionをインストールしている場合は、directoryを削除して再度cloneしてください。現在、スキルはsymlinkではなく実ファイルとして提供されています。

OpenCode

プロジェクトにplugin packageをインストールし、opencode.jsonにpluginとそのskills pathを追加します:

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 entryが必要です。相対パスはプロジェクトdirectoryを基準に解決されるため、そのプロジェクトのnode_modulesにpackageが存在している必要があります。絶対パスも使用でき、ローカルインストールの要件を回避できます。スキルが読み込まれたことを確認します:

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

17個すべてが表示されるはずです。存在しないskills pathは警告なしで無視されるため、推測せず確認してください。

VS Code / GitHub Copilot

repoをcloneして登録します:

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

Chat viewを開き、Pluginsに移動して、cloneしたfolderを追加します。またはsettings.jsonに登録します:

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

keyはpathで、valueは有効化を示します。絶対パスと~/のどちらも使用できます。相対パスは各workspace folderを基準に解決されます。設定はライブで読み込まれるため、実行中のwindowでも再起動なしに反映されます。chat.pluginLocationsはexperimentalとしてマークされたrestricted settingであるため、workspaceを信頼する必要があります。agent-plugin supportはchat.plugins.enabledによって管理されるpreview featureで、デフォルトで有効です。

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 icon）を開きます。

Import the folder

Add Custom Power → Import power from a folderを選択し、cloneしたdirectory（plugin.jsonを含むdirectory）を選択して、Installをクリックします。

スキルはskills/から、MCPサーバーはmcp.jsonから読み込まれます。KiroはMCPサーバーを内部で管理するため、~/.kiro/settings/mcp.jsonには書き込まれません。KiroではGitHub URLから直接Powerをインストールすることもできます。Kiroのinstallドキュメントを参照してください。

Gemini CLI (MCP only)

Gemini CLIにはagent-skill primitiveがないため、利用できるのは2つのMCPサーバーのみです。dodo-knowledgeは、スキルが提供する機能の多くをカバーし、常に自動更新されます。

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

Gemini CLIを再起動します。repo rootのgemini-extension.jsonがmanifestです。

別のagentを使用していますか？MCP ServerとAgent Skillsのガイドでは、Claude Desktop、Windsurf、Cline、Zed、その他のMCP-compatible clientについて説明しています。

利用できるもの

インストールすると、agentは2つのMCPサーバーと17個のスキルにアクセスできるようになります。

MCP Servers

Server	Purpose	Auth
`dodopayments-api`	ライブAPIアクセス — 決済、サブスクリプション、顧客、商品、返金、ライセンス、使用量	OAuth（browser）
`dodo-knowledge`	Dodo Paymentsの全ドキュメントを対象としたセマンティック検索	なし

両方のサーバーはStreamable HTTPを使用します。canonical mcp.jsonはこれらをネイティブに宣言し、Codex CLIやKiroなどのspec-native clientが使用します。生成された互換性manifest .mcp.jsonは、Streamable HTTPに直接接続できないclient向けに、mcp-remote経由で接続します。

Agent Skills

Skill	Description
`dodo-best-practices`	SDK設定、環境、API keys、canonicalなcheckout-to-webhook architecture
`framework-adapters`	Next.js、Express、Hono、Astro、Remix、SvelteKit、Nuxt、Fastify、TanStack、Bun、Convex向けの公式`@dodopayments/*` route handlers
`testing-and-go-live`	Test mode、テスト用payment methods、webhook testing、本番リリースチェックリスト
`checkout-integration`	Checkout Sessions、payment links、overlayまたはinline checkout
`subscription-integration`	サブスクリプションのライフサイクル、trial、plan変更、proration、オンデマンドcharge
`mobile-checkout`	React Native、Flutter、iOS、Android向けのアプリ内checkout
`webhook-integration`	Standard Webhooks specificationを使用したwebhookの受信と検証
`credit-based-billing`	クレジットentitlement、残高、ledger、rollover、overage、meterベースの控除
`usage-based-billing`	meter、event ingestion、aggregation、単位ごとのpricing
`license-keys`	license keyのactivation、validation、instance management
`product-catalog-management`	商品、pricing、add-on、collection、画像、デジタル商品のdelivery
`discounts-and-promotions`	discount code、eligibility rule、stacking、subscription cycleの制限
`localized-pricing`	ローカライズ価格、adaptive currency、購買力平価
`customer-management`	顧客、self-service portal、保存済みpayment methods、wallet
`refunds-and-disputes`	返金の発行、disputeとchargebackの処理、accessの照合
`billing-sdk`	pricing tableとbilling UI向けのBillingSDK React components
`better-auth-integration`	顧客同期、checkout、portal access向けの`@dodopayments/better-auth` plugin

スキルは自動的に読み込まれます。agentは関連するtaskを検出すると、適切なスキルを選択します。全リストと個別のインストール方法についてはAgent Skillsを参照してください。

最初にこのPromptを試す

pluginを有効にしたら、次を試してください:

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

agentはwebhook-integration skillを読み込み、dodo-knowledge MCPを使用して最新のpayload shapeを取得し、Standard Webhooks specに従ったsignature verification付きのhandlerを作成します。

Client Support

Plugin Installに対応するAgents

1回のインストールで、両方のMCPサーバーと、skill primitiveを備えたすべてのclient向けのスキルが接続されます。

Agent	Install	Skills	MCP Servers
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 entryが必要です。Gemini CLIにはagent-skill primitiveがないため、仕様上スキルは利用できません。

その他のMCP-Compatible Clients

これらにはAgent Plugin install機能がありません。2つのMCPサーバーを手動で設定し、対応している場合はSkills CLIでスキルを追加してください。

Agent	MCP Servers	Skills
Claude Desktop	MCP Server guide	未対応
Windsurf	MCP Server guide	Skills CLI
Cline / Zed / others	MCP Server guide	Skills CLI

Agents向けに構築されたDocs

Dodo Paymentsのすべてのドキュメントページは、AIが利用しやすい形式で提供されています:

完全なdocs index: docs.dodopayments.com/llms.txt — context ingestion用の完全なドキュメントindex
Plain markdown: 任意のドキュメントURLに.mdを追加すると、raw markdown versionを取得できます（例: /api-reference/introduction.md）
Source repository: github.com/dodopayments/dodo-docs — offline indexing用にcloneできます

Agentにできること

pluginをインストールすると、コーディングエージェントは次のことができます:

checkout sessionとpayment linkを作成 — One-time paymentsとsubscriptions
サブスクリプションと使用量ベースの課金をend-to-endで構築 — Subscriptions、Usage-based billing、Credit-based billing
signature verification付きのStandard Webhooks準拠handlerを生成 — Webhooks
公式adapterを使用してframeworkにroute handlerをmount — Framework adaptors
pricing tableとsubscription management向けにBillingSDK React componentsを接続 — BillingSDK
デジタル商品向けのlicense-key flowを作成 — License keys
entitlement、残高、rollover、overageを備えたcredit-based billingを実装 — Credits
add-onとcollectionを備えたproduct catalogを構築・管理 — Products、Add-ons、Product collections
割引とローカライズ価格を追加 — Discount codes、Localized pricing、Adaptive currency
React Native、Flutter、iOS、Android向けのモバイルアプリ内checkoutを提供 — Mobile integration
返金、dispute、顧客のself-serviceを処理 — Refunds、Disputes、Customer portal
統合をテストし、安全に本番稼働 — Test mode vs live mode

Security and Best Practices

live API keysは絶対にcommitしないでください。開発中はtest modeを使用してください。

最初にtest modeを使用します。 本番稼働前に、test mode API keyを使って統合を構築・テストしてください。Test Mode vs Live Modeを参照してください。
OAuthがデフォルトです。 Agent PluginはブラウザOAuthで認証するため、ローカルsecretは不要です。必要な場合に限りAPI-key modeを使用してください。
agentが生成したcodeを確認します。 webhook handlerにStandard Webhooks specに従ったsignature verificationが含まれていることを必ず確認してください。

API Keyで設定する

デフォルトでは、Agent PluginはブラウザOAuthを使用するremote MCP serverを使います。代わりにlocal API keyを使用するには、たとえばCIやheadless serverで使用する場合は、stdio modeに切り替えます。

Local API key mode — Claude Code

Claude Codeで/pluginsを開き、Dodo Paymentsを選択して、Configure optionsを選びます。次の項目を入力します:

dodo_api_key — test modeまたはlive modeのAPI key
dodo_webhook_key — webhook signing secret
dodo_environment — test_modeまたはlive_mode

次に.mcp.jsonを編集し、dodopayments-apiがlocal 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で自分で宣言します。独自のentryが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サーバーに関する完全なreference — 対応client、設定、利用可能なtool

Agent Skills

個別のスキルインストール、スキルreference、agentごとの設定手順

API Reference

すべてのDodo Payments endpointに関する完全なOpenAPI reference

Getting Started

Features

Integrate

Merchant of Record

Miscellaneous

Pluginをインストールする

Dodo Agent Plugin on GitHub

利用できるもの

MCP Servers

Agent Skills

最初にこのPromptを試す

Client Support

Plugin Installに対応するAgents

その他のMCP-Compatible Clients

Agents向けに構築されたDocs

Agentにできること

Security and Best Practices

API Keyで設定する

次のステップ

MCP Server

Agent Skills

API Reference

​Pluginをインストールする

Dodo Agent Plugin on GitHub

​利用できるもの

​MCP Servers

​Agent Skills

​最初にこのPromptを試す

​Client Support

​Plugin Installに対応するAgents

​その他のMCP-Compatible Clients

​Agents向けに構築されたDocs

​Agentにできること

​Security and Best Practices

​API Keyで設定する

​次のステップ

MCP Server

Agent Skills

API Reference

Pluginをインストールする

利用できるもの

MCP Servers

Agent Skills

最初にこのPromptを試す

Client Support

Plugin Installに対応するAgents

その他のMCP-Compatible Clients

Agents向けに構築されたDocs

Agentにできること

Security and Best Practices

API Keyで設定する

次のステップ