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サーバーのみ利用できます。

プラグインをインストールする

以下から使用するコーディングエージェントを選択してください。どのインストール方法でも、両方の MCP サーバーが追加されます。Gemini CLI 以外のすべてのエージェントでは、17 個のスキルも追加されます。OpenCode では、スキルを読み込むために追加の設定が 1 つ必要です。これは 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 }
}

キーはパスで、値が有効化を示します。絶対パスと ~/ のどちらも使用できます。相対パスは各ワークスペースフォルダーを基準に解決されます。この設定はリアルタイムで読み取られるため、実行中のウィンドウでも再起動せずに反映されます。chat.pluginLocations は experimental としてマークされ、制限付き設定です。そのため、ワークスペースは信頼済みである必要があります。Agent-plugin のサポートは chat.plugins.enabled によって管理されるプレビュー機能で、デフォルトで有効になっています。

Kiro

Kiro は Agent Plugins マニフェストをネイティブに読み取ります。

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 プリミティブがないため、使用できるのは 2 つの MCP サーバーだけです。dodo-knowledge は、スキルが提供する機能の多くをカバーし、常に自動で最新の状態に保たれます。

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

Gemini CLI を再起動します。リポジトリルートの gemini-extension.json がマニフェストです。

別のエージェントを使用していますか？MCP Server と Agent Skills のガイドでは、Claude Desktop、Windsurf、Cline、Zed、および MCP 互換クライアントについて説明しています。

利用できるもの

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

MCP サーバー

サーバー	目的	Auth
`dodopayments-api`	Live API access — payments, subscriptions, customers, products, refunds, licenses, usage	OAuth (browser)
`dodo-knowledge`	すべての Dodo Payments ドキュメントを横断する Semantic search	None

両方のサーバーは Streamable HTTP を使用します。標準の mcp.json は両方をネイティブに宣言し、Codex CLI や Kiro などの仕様ネイティブクライアントが使用します。生成された互換性マニフェスト .mcp.json は、Streamable HTTP に直接接続できないクライアント向けに、mcp-remote 経由で接続します。

Agent Skills

Skill	Description
`dodo-best-practices`	SDK のセットアップ、環境、API キー、checkout から webhook までの標準アーキテクチャ
`framework-adapters`	Next.js、Express、Hono、Astro、Remix、SvelteKit、Nuxt、Fastify、TanStack、Bun、Convex 向けの公式 `@dodopayments/*` route handlers
`testing-and-go-live`	Test mode、test payment methods、webhook testing、本番リリースチェックリスト
`checkout-integration`	Checkout Sessions、payment links、overlay または inline checkout
`subscription-integration`	Subscription lifecycle、trials、plan changes、proration、on-demand charges
`mobile-checkout`	React Native、Flutter、iOS、Android 向けのアプリ内 checkout
`webhook-integration`	Standard Webhooks 仕様を使用した webhook の受信と検証
`credit-based-billing`	Credit entitlements、balances、ledger、rollover、overage、meter-based deduction
`usage-based-billing`	Meters、event ingestion、aggregation、per-unit pricing
`license-keys`	License key の activation、validation、instance management
`product-catalog-management`	Products、pricing、add-ons、collections、images、digital product delivery
`discounts-and-promotions`	Discount codes、eligibility rules、stacking、subscription-cycle limits
`localized-pricing`	Localized pricing、Adaptive Currency、purchasing power parity
`customer-management`	Customers、セルフサービスのポータル、保存済みの payment methods、wallets
`refunds-and-disputes`	Refunds の発行、disputes と chargebacks の処理、アクセスの照合
`billing-sdk`	Pricing tables と billing UI 向けの BillingSDK React components
`better-auth-integration`	Customer sync、checkout、portal access 向けの `@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 スキルを読み込み、dodo-knowledge MCP を使用して最新の payload shapes を取得し、Standard Webhooks 仕様に従う signature verification を含む handler を作成します。

クライアントサポート

このプラグインは Agent Plugins 1.0.0 仕様に従います。ネイティブサポートを備えたクライアントは直接読み込み、それ以外のクライアントは生成された互換性マニフェストを使用します。

プラグインインストールに対応するエージェント

1 回のインストールで、両方の 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 エントリが 1 つ必要です。Gemini CLI には agent-skill primitive がないため、仕様上スキルは利用できません。

その他の MCP 互換クライアント

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

エージェント	MCP サーバー	スキル
Claude Desktop	MCP Server guide	not supported
Windsurf	MCP Server guide	Skills CLI
Cline / Zed / others	MCP Server guide	Skills CLI

エージェント向けに構築されたドキュメント

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

Full docs index: docs.dodopayments.com/llms.txt — コンテキスト取り込み用の完全なドキュメントインデックス
Plain markdown: 任意のドキュメント URL に .md を追加すると、raw markdown 版を取得できます（例：/api-reference/introduction.md）
Source repository: github.com/dodopayments/dodo-docs — オフラインでインデックスを作成する場合にクローンします

エージェントでできること

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

checkout sessions と payment links を作成 — One-time payments と subscriptions
subscription と usage-based billing をエンドツーエンドで構築 — Subscriptions、Usage-based billing、Credit-based billing
Standard Webhooks 準拠の handlers を signature verification 付きで生成 — Webhooks
公式 adapters を使用して framework に route handlers をマウント — Framework adaptors
pricing tables と subscription management 用に BillingSDK React components を接続 — BillingSDK
デジタル製品向けの license-key flows を作成 — License keys
entitlements、balances、rollover、overage を使用して credit-based billing を実装 — Credits
add-ons と collections を備えた product catalog を構築・管理 — Products、Add-ons、Product collections
discounts と localized pricing を追加 — Discount codes、Localized pricing、Adaptive currency
React Native、Flutter、iOS、Android 向けの mobile in-app checkout を提供 — Mobile integration
refunds、disputes、customer self-service を処理 — Refunds、Disputes、Customer portal
integration をテストして安全に本番稼働 — Test mode vs live mode

セキュリティとベストプラクティス

本番 API キーをコミットしないでください。開発中は test mode を使用してください。

まず test mode を使用する。 本番稼働前に、test mode API key を使用して integration を構築・テストします。Test Mode vs Live Mode を参照してください。
OAuth がデフォルトです。 Agent Plugin はブラウザ OAuth（ローカルシークレットなし）で認証します。必要な場合にのみ API-key mode を使用してください。
エージェントが生成したコードを確認する。 webhook handlers に Standard Webhooks spec に従った signature verification が含まれていることを必ず確認してください。

API キーで設定する

デフォルトでは、Agent Plugin はブラウザ OAuth を使用する remote MCP server を使います。代わりにローカル API キーを使用するには、たとえば 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 がローカル 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 で自分で宣言します。独自のエントリがプラグインのデフォルト 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 endpoints の完全な OpenAPI reference

Getting Started

Features

Integrate

Merchant of Record

Miscellaneous

プラグインをインストールする

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 キーで設定する

次のステップ