AI Coding Agentsで構築する

Dodo Agent Pluginは、2つのMCPサーバーと17の統合スキルを、1回のインストールでAIコーディングエージェントに接続します。Claude Code、Codex CLI、Cursor、VS Code / GitHub Copilot、Kiro、OpenCodeで利用できます。Gemini CLIでは2つのMCPサーバーのみ利用できます。MCPサーバーとスキルCLIは、MCP互換クライアントであれば利用できます。このプラグインはAgent Plugins 1.0.0仕様に準拠しているため、ネイティブ対応クライアントはルートのplugin.jsonとmcp.jsonから直接読み込めます。仕様より前のクライアントは、生成された互換マニフェストを通じて同じコンテンツを読み込みます。

3つのプリミティブを1つのプラグインに。 Agent Pluginには必要なものがすべて含まれています:

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

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

以下から使用するコーディングエージェントを選択してください。どのインストールでも両方のMCPサーバーが追加されます。Gemini CLI以外では、17のスキルも追加されます。

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は2段階でプラグインをインストールします。まずシェルからマーケットプレイスを登録し、次に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のスキルが自動的に登録されます。

Codex CLIにはcodex plugin installサブコマンドがありません。プラグインのインストールは常にTUI内の/pluginsフローで行います。公式のCodex pluginsドキュメントを参照してください。

以前にマーケットプレイスを追加したにもかかわらず、/pluginsの下にプラグインが表示されない場合は、更新してください:

codex plugin marketplace upgrade dodopayments

Cursor

手動インストール — リポジトリをCursorのローカルプラグインディレクトリにcloneします:

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

Cursorを再起動します。プラグインはskills/からスキルを、.mcp.jsonからMCPサーバーを読み込みます。これは.cursor-plugin/plugin.jsonで宣言されています。

最近のCursorビルドはAgent Plugins 1.0.0も直接認識し、マーケットプレイスソースとして.cursor-plugin/marketplace.jsonまたは.claude-plugin/marketplace.jsonのいずれかを受け付けます。このプラグインには.claude-plugin/marketplace.jsonが含まれているため、そのパスを使用してください。生成された.cursor-plugin/plugin.jsonは、古いビルド向けに保持されています。

0.5.0より前のバージョンでは、skills/がgitサブモジュールへのシンボリックリンクとして提供されていたため、このcloneでは動作するスキルがないプラグインが作成されました。現在、スキルは実ファイルとして提供されています。以前のバージョンをインストールしている場合は、ディレクトリを削除して再度cloneしてください。

OpenCode

OpenCodeはnpm経由で配布されます。プラグインをopencode.jsonに追加します:

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

OpenCodeを再起動します。両方のMCPサーバー（dodopayments-api、dodo-knowledge）は、プラグインの設定フックによって自動的に登録されます。手動のmcpブロックは必要ありません。スキルには追加の1行が必要です。 OpenCodeはインストール済みパッケージからスキルをスキャンしないため、パッケージのskills/ディレクトリを自分で指定します:

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"]
  }
}

相対skills.pathsエントリはプロジェクトディレクトリを基準に解決されるため、パッケージはそのプロジェクトのnode_modulesに存在している必要があります。OpenCode独自のプラグインキャッシュは別の場所です。絶対パスも使用でき、ローカルインストールの要件を回避できます。

存在しないスキルパスは黙って無視されます。推測せず、確認してください:

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

17個すべてが表示されるはずです。0.5.0より前のバージョンでは、これらのスキルは自動検出されると説明されていましたが、実際には検出されませんでした。そのためOpenCodeユーザーはMCPサーバーを利用できても、スキルは利用できませんでした。

VS Code / GitHub Copilot

リポジトリを任意の場所にcloneしてから登録します:

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

Chatビューを開き、Pluginsに移動して、cloneしたフォルダーを追加します。settings.jsonに直接登録することもできます:

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

キーはパスで、値は有効化を示します。絶対パスと~/のどちらも使用できます。相対パスは各ワークスペースフォルダーを基準に解決されます。この設定はライブで読み込まれるため、実行中のウィンドウでも再起動なしに反映されます。スキルはskills/から、両方のMCPサーバーは.mcp.jsonから読み込まれます。

chat.pluginLocationsはexperimentalとしてマークされたrestricted設定であるため、適用するにはワークスペースが信頼されている必要があります。Agent-pluginのサポート全体は、chat.plugins.enabledによって管理されるプレビュー機能で、デフォルトではonです。組織がポリシーで無効にしている場合にのみ設定する必要があります。

VS CodeはAgent Pluginsの$schemaを基準にしません。ローダーは.plugin/plugin.json、次に.claude-plugin/plugin.json、さらにルートのplugin.jsonを順に調べ、MCPの既定値をmcp.jsonではなく.mcp.jsonにします。このリポジトリには生成された.claude-plugin/plugin.jsonが含まれているため、VS Codeは互換ブランチ経由でそれを読み込み、mcp.jsonのネイティブトランスポートではなくmcp-remoteブリッジを使用します。すべて正常に動作しますが、パスが異なります。

Kiro

KiroはAgent Pluginsマニフェストをネイティブに読み込み、これをPowerとしてロードします。

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を選択し、cloneしたディレクトリ（plugin.jsonを含むディレクトリ）を選択して、Installをクリックします。

スキルはskills/から、MCPサーバーはmcp.jsonから読み込まれます。Kiro固有の表示は、plugin.json内のdev.kiro拡張名前空間から提供されます。

Agent Plugins形式のプラグインでは、KiroがMCPサーバーを内部で管理します。これらはユーザーレベルの~/.kiro/settings/mcp.jsonには書き込まれないため、そこに表示されるとは限りません。KiroではGitHub URLから直接Powerをインストールすることもできます。詳しくはKiroのインストールドキュメントを参照してください。

Gemini CLI (MCP only)

Gemini CLIにはagent-skillプリミティブがないため、利用できるのは2つのMCPサーバーのみです。17のスキルは利用できません。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サーバー

サーバー	用途	認証
`dodopayments-api`	支払い、サブスクリプション、顧客、商品、返金、ライセンス、使用量へのリアルタイムAPIアクセス	OAuth（ブラウザ）
`dodo-knowledge`	Dodo Paymentsのドキュメント全体を対象としたセマンティック検索	なし

両方のサーバーはStreamable HTTPを使用します。正式なmcp.jsonでは、サーバーがネイティブに宣言されています（type: "streamable-http"）。これはCodex CLIやKiroなど、仕様にネイティブ対応したクライアントが使用する形式です。生成された互換マニフェスト.mcp.jsonでは、同じ2つのエンドポイントをmcp-remote経由で接続します。そのため、Streamable HTTPに直接接続できないクライアント（Claude Code、VS Code、上記で説明したgit-cloneインストールによるCursor）でも実行できます。これらの.cursor-plugin/plugin.jsonは.mcp.jsonを指します。

Agentスキル

スキル	説明
`dodo-best-practices`	SDKのセットアップ、環境、APIキー、checkoutからwebhookまでの標準アーキテクチャ
`framework-adapters`	Next.js、Express、Hono、Astro、Remix、SvelteKit、Nuxt、Fastify、TanStack、Bun、Convex向けの公式`@dodopayments/*`ルートハンドラー
`testing-and-go-live`	テストモード、テスト支払い方法、webhookテスト、本番起動チェックリスト
`checkout-integration`	Checkout Sessions、payment links、オーバーレイまたはインラインチェックアウト
`subscription-integration`	サブスクリプションのライフサイクル、トライアル、プラン変更、按分、オンデマンドチャージ
`mobile-checkout`	React Native、Flutter、iOS、Android向けのアプリ内チェックアウト
`webhook-integration`	Standard Webhooks仕様を使用したwebhookの受信と検証
`credit-based-billing`	クレジットのentitlements、残高、台帳、繰り越し、超過、メーターに基づく控除
`usage-based-billing`	メーター、イベント取り込み、集計、単位ごとの価格設定
`license-keys`	ライセンスキーのアクティベーション、検証、インスタンス管理
`product-catalog-management`	商品、価格、アドオン、コレクション、画像、デジタル商品の配信
`discounts-and-promotions`	割引コード、適格性ルール、併用、サブスクリプションサイクルの上限
`localized-pricing`	ローカライズされた価格設定、Adaptive Currency、購買力平価
`customer-management`	顧客、セルフサービスのCustomer Portal、保存済み支払い方法、ウォレット
`refunds-and-disputes`	返金の発行、異議申し立てとチャージバックの処理、アクセスの照合
`billing-sdk`	価格表と課金UI向けのBillingSDK Reactコンポーネント
`better-auth-integration`	顧客同期、チェックアウト、ポータルアクセス用の`@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仕様に従った署名検証付きのハンドラーを作成します。

クライアントのサポート

Agent Pluginをインストールできるクライアント

1回のインストールで、両方のMCPサーバーが接続されます。スキルプリミティブを持つすべてのクライアントでは、スキルも接続されます。

エージェント	インストール	スキル	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プリミティブがないため、仕様上スキルは利用できません。

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

これらのクライアントにはAgent Pluginのインストール機能がありません。2つの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を追加すると、raw Markdown版を取得できます（例: /api-reference/introduction.md）。
ソースリポジトリ: github.com/dodopayments/dodo-docs — オフラインでのインデックス作成用にcloneできます。

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

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

checkoutセッションとpayment linksを作成する — One-time paymentsとサブスクリプション
サブスクリプションおよび使用量ベースの課金をエンドツーエンドで構築する — サブスクリプション、使用量ベースの課金、クレジットベースの課金
署名検証付きのStandard Webhooks準拠ハンドラーを生成する — Webhooks
公式アダプターを使用してフレームワークにルートハンドラーを組み込む — Framework adaptors
価格表とサブスクリプション管理用のBillingSDK Reactコンポーネントを接続する — BillingSDK
デジタル商品向けのライセンスキーフローを作成する — ライセンスキー
entitlements、残高、繰り越し、超過を備えたクレジットベースの課金を実装する — クレジット
アドオンとコレクションを含む商品カタログを構築・管理する — 商品、アドオン、商品コレクション
割引とローカライズされた価格設定を追加する — 割引コード、ローカライズされた価格設定、Adaptive Currency
React Native、Flutter、iOS、Android向けのモバイルアプリ内チェックアウトを提供する — モバイル統合
返金、異議申し立て、顧客自身によるセルフサービスを処理する — 返金、異議申し立て、Customer Portal
統合をテストし、安全に本番環境へ移行する — テストモードとライブモード

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

本番APIキーは決してcommitしないでください。 開発中はテストモードを使用してください。Agent PluginはデフォルトでブラウザOAuthを使用します。ローカルAPIキーへの切り替えは、ワークフローで必要な場合に限ってください。

まずテストモードを使用する。 本番開始前にdodo_test_...キーで統合をサンドボックス化してください。Test Mode vs Live Modeを参照してください。
OAuthがデフォルトです。 Agent PluginはブラウザOAuthで認証するため、ローカルシークレットは不要です。必要な場合にのみAPI-keyモードを使用してください。詳しくは以下のConfigureセクションを参照してください。
エージェントが生成したコードを確認する。 webhookハンドラーにStandard Webhooks仕様に従った署名検証が含まれていることを必ず確認してください。

APIキーで設定する

デフォルトでは、Agent PluginはブラウザOAuthを使用するリモートMCPサーバーを使用するため、ローカル認証情報は必要ありません。ローカルAPIキーが必要なワークフロー（CI環境、ヘッドレスサーバーなど）では、stdioモードに切り替えられます。

Local API key mode — Claude Code

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

dodo_api_key — dodo_test_...またはdodo_live_...キー
dodo_webhook_key — webhook署名シークレット
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": "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リファレンス

Getting Started

Features

Integrate

Merchant of Record

Miscellaneous

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

Dodo Agent Plugin on GitHub

利用できるもの

MCPサーバー

Agentスキル

まずこのプロンプトを試す

クライアントのサポート

Agent Pluginをインストールできるクライアント

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

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

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

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

APIキーで設定する

次のステップ

MCP Server

Agent Skills

Sentra IDE Assistant

API Reference

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

Dodo Agent Plugin on GitHub

​利用できるもの

​MCPサーバー

​Agentスキル

​まずこのプロンプトを試す

​クライアントのサポート

​Agent Pluginをインストールできるクライアント

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

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

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

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

​APIキーで設定する

​次のステップ

MCP Server

Agent Skills

Sentra IDE Assistant

API Reference

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

利用できるもの

MCPサーバー

Agentスキル

まずこのプロンプトを試す

クライアントのサポート

Agent Pluginをインストールできるクライアント

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

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

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

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

APIキーで設定する

次のステップ