Dodo Payments Docs

Dodo Payments エージェントプラグイン

AI コーディングエージェント向けの Dodo Payments 公式プラグインです。単一の信頼できる情報源から、Claude Code、Codex CLI、Cursor、VS Code / GitHub Copilot、Grok Build、Meta Muse Code、Gemini CLI、Antigravity、Junie、OpenCode などに、Dodo Payments の統合スキルと 2 つの MCP サーバーをインストールします。

このプラグインは Agent Plugins 1.0.0 仕様に準拠しています。ルートに plugin.json があり、skills/ の直下にスキルがあり、mcp.json に MCP サーバーが定義されています。Agent Plugins にネイティブ対応しているクライアントはプラグインを直接読み込みます。リポジトリ内のプロバイダー固有のマニフェストは、ネイティブ対応していないクライアント向けに生成された互換性シムです。

利用できる機能

• Dodo Payments API MCP サーバー - ライブ API にアクセスできます（決済、サブスクリプション、顧客、製品、返金、ライセンス、使用状況）。ブラウザー OAuth で認証するため、ローカルに認証情報を用意する必要はありません。
• Dodo Knowledge MCP サーバー - 認証情報は不要です。最新の Dodo Payments ドキュメントを対象に、セマンティック検索を行います。
• エージェントスキル - 統合ガイド（以下に記載）です。YAML フロントマター付きの SKILL.md ファイルとして記述されています。タスクに応じて、エージェントが適切なスキルを自動的に読み込みます。

インストール

クライアント	スキル	MCP	方法
Claude Code	✅	✅	マーケットプレイス
Codex CLI / ChatGPT	✅	✅	マーケットプレイス
Cursor（Grok Bot も対応）	✅	✅	クローン
VS Code / GitHub Copilot	✅	✅	プラグインビュー · Copilot CLI
Grok Build	✅	✅	grok plugin install
grok.com、xAI API	—	✅	コネクター / API ツール
Meta Muse Code	✅	✅	muse plugins install
Gemini CLI	✅	✅	拡張機能
Google Antigravity	✅	✅	agy plugin install
JetBrains Junie	✅	✅	拡張機能
Kiro	✅	✅	Power
OpenCode	✅	✅	npm
Qwen Code、Devin、Goose、Factory Droid、Augment、OpenHands、OpenClaw、Hermes	✅	✅	その他のクライアント
Cline、Kilo、Zed、Warp、Amp、Continue、Kimi、…	✅	✅	npx skills + npx add-mcp
Claude.ai、ChatGPT、Perplexity、Mistral	—	✅	カスタムコネクター

Claude Code

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

API MCP サーバーはデフォルトでブラウザー OAuth を使用するため、インストール時にキーは必要ありません。エージェントが初めて Dodo ツールを呼び出すときに、サインインを求められます。

Codex CLI

マーケットプレイスを登録してから、プラグインをインストールします。

codex plugin marketplace add dodopayments/dodo-agent-plugin
codex plugin add dodopayments@dodopayments

確認します。

codex plugin list     # dodopayments  installed, enabled
codex mcp list        # dodo-knowledge, dodopayments-api
codex mcp login dodopayments-api    # browser OAuth, only needed for the API server

TUI 内からインストールすることもできます。codex を実行し、/plugins と入力して、Dodo Payments マーケットプレイスと dodopayments プラグインを選択し、Install plugin を選びます。

以前にマーケットプレイスを追加したのにプラグインが表示されない場合は、更新してください。

codex plugin marketplace upgrade dodopayments

Cursor

手動でインストールする場合：

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

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

Cursor 3.14.27 は Agent Plugins 1.0.0 も直接認識します。エージェントホストには両方の仕様スキーマ URL と仕様独自の name 正規表現が含まれており、マーケットプレイスソースとして .cursor-plugin/marketplace.json と .claude-plugin/marketplace.json のどちらも受け付けます。生成された .cursor-plugin/plugin.json は、古いビルドとの互換性を確保するために引き続き用意されています。

v0.5.0 より前は、このクローンから動作するスキルを含まないプラグインが生成されていました。skills/ には git サブモジュールへのシンボリックリンクが含まれていましたが、通常の git clone では取得されません。現在はスキルが実ファイルとして同梱されているため、上記のコマンドは説明どおりに動作します。以前のバージョンをインストールした場合は、再度クローンしてください。

Kiro

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

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

クローンしたフォルダーを Kiro に指定してください。スキルは skills/ から、MCP サーバーは mcp.json から読み込まれ、Kiro 固有の表示は plugin.json の dev.kiro 拡張名前空間から取得されます。

Gemini CLI

gemini extensions install https://github.com/dodopayments/dodo-agent-plugin

リポジトリのルートにある gemini-extension.json がマニフェストで、Gemini はその隣にある skills/ ディレクトリを自動検出します。Gemini CLI 0.63.0 で検証済みです。gemini skills list にはすべてのスキルが表示され、gemini mcp list には両方のサーバーが表示されます。

VS Code / GitHub Copilot

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

次に、チャットビューを開き、プラグインに移動して、クローンしたフォルダーを追加します。スキルは skills/ から読み込まれ、両方の MCP サーバーは .mcp.json から読み込まれます。

VS Code 1.125.1 は Agent Plugins の $schema を参照しません。この文字列はバンドル内のどこにもありません。ローダーは .plugin/plugin.json、.claude-plugin/plugin.json、ルートの plugin.json の順に調べてマニフェストを選び、MCP の設定ファイルには mcp.json ではなく .mcp.json を使用します。このリポジトリには生成された .claude-plugin/plugin.json が含まれているため、VS Code はこの分岐を通じてそれを読み込みます。仕様準拠のマニフェストではなく、互換性マニフェストを介して、すべてのスキルと両方の MCP サーバーが正常に動作します。

OpenCode

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

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

OpenCode を再起動します。プラグインの config フックによって、両方の MCP サーバー（dodopayments-api、dodo-knowledge）がネイティブのリモートサーバーとして自動登録されます。手動で mcp ブロックを追加する必要はありません。opencode mcp auth dodopayments-api を実行して API サーバーにサインインします。

スキルを使うには、パッケージをローカルにインストールしたうえで、もう1行設定を追加する必要があります。 OpenCode はインストール済みパッケージのスキルをスキャンしないため、パッケージの skills/ ディレクトリを自分で指定してください。skills.paths のエントリーはプロジェクトディレクトリを基準に解決されるため、パッケージはプロジェクトの node_modules に存在している必要があります。OpenCode 自身のプラグインキャッシュは同じ場所ではありません。

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 run "List every skill available to you by name." で確認します。含まれるスキルにあるすべてのスキルが表示されるはずです。存在しないスキルパスは何も通知されずに無視されるため、想定するだけでなく確認してください。

0.5.0 より前のバージョンでは、これらのスキルは自動検出されると説明されていましたが、実際には検出されませんでした。OpenCode はインストール済みパッケージをスキャンしないため、OpenCode ユーザーは MCP サーバーを利用できても、スキルは利用できませんでした。プラグインの config フックで config.skills を設定しても解決しません。スキルのインデックスは config フックの実行前に構築されるため、何も登録されないからです。

デフォルトのリモート OAuth サーバーではなく、自分の API キーを使ってローカルの stdio API サーバーを使いたい場合は、opencode.json に dodopayments-api を自分で宣言してください。設定したエントリーがプラグインのデフォルトより優先されます。

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

含まれるスキル

はじめに

スキル	説明
dodo-best-practices	SDK のセットアップ、環境、API キー、標準的なチェックアウトから Webhook までのアーキテクチャ
framework-adapters	Next.js、Express、Hono、Astro、Remix、SvelteKit、Nuxt、Fastify、TanStack、Bun、Convex 向けの公式 @dodopayments/* ハンドラー
testing-and-go-live	テストモード、テスト用決済方法、Webhook テスト、本番環境へのリリースチェックリスト
dodo-mcp-usage	ドキュメントと API MCP サーバーの使い分け、テストモードの安全ルール、認証、トラブルシューティング

決済の受け付け

スキル	説明
checkout-integration	Checkout Sessions、決済リンク、オーバーレイチェックアウト
subscription-integration	サブスクリプションのライフサイクル、トライアル、プラン変更、日割り計算、オンデマンド課金
mobile-checkout	React Native、Flutter、iOS、Android 向けのアプリ内チェックアウト
webhook-integration	Standard Webhooks 仕様に基づく Webhook の受信と検証

課金モデル

スキル	説明
credit-based-billing	クレジットの利用権、残高、台帳、繰り越し、超過利用、メーターに基づく差し引き
usage-based-billing	メーター、イベントの取り込み、集計、単位ごとの価格設定
license-keys	ライセンスキーの有効化、検証、インスタンス管理

カタログと価格設定

スキル	説明
product-catalog-management	商品、価格設定、アドオン、コレクション、画像、デジタル商品の配信
discounts-and-promotions	割引コード、適用条件、併用、サブスクリプションの課金サイクル上限
localized-pricing	ローカライズされた価格設定、適応型通貨、購買力平価

顧客と運用

スキル	説明
customer-management	顧客、セルフサービスのポータル、決済方法、ウォレット
refunds-and-disputes	返金、異議申し立てとチャージバック、アクセス権の調整

UI と連携

スキル	説明
billing-sdk	価格表と課金 UI 用の BillingSDK React コンポーネント
better-auth-integration	顧客同期、チェックアウト、ポータル用の @dodopayments/better-auth プラグイン

スキルのソース：dodopayments/skills を skills/ に実ファイルとして取り込んでいます。出所（上流コミットと適用された変換）は .skills-source.json に記録されています。

含まれる MCP サーバー

サーバー	目的	認証
dodopayments-api	ライブ API アクセス（決済、サブスクリプション、顧客、商品、返金、ライセンス、利用状況）	OAuth（ブラウザー）
dodo-knowledge	Dodo Payments ドキュメントのセマンティック検索	なし

どちらのサーバーも HTTPS 経由の Streamable HTTP を使用し、すべてのマニフェストがネイティブに接続します。npx mcp-remote のブリッジも Node の依存関係も不要です。標準の mcp.json では仕様の type: "streamable-http" を使用します。生成された .mcp.json（Claude Code、Cursor、VS Code、Grok Build、Devin、Goose、Droid）では、同じエンドポイントを各形式で使用される名前である type: "http" として記述します。Muse、Antigravity、Junie、Gemini には、ジェネレーターがそれぞれ固有の記述形式を使用します。

設定（任意、Claude Code）

リモートサーバーの代わりに API キーを使って API MCP をローカルで実行する場合は、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 を実行します。

MCP サーバーを個別に有効化／無効化する

どちらの MCP もデフォルトで有効になっています。それぞれ個別に無効化できます。

OpenCode

npm プラグインは、MCP サーバーを登録する前に2つの環境変数を読み取ります。

環境変数	効果
DODO_DISABLE_API_MCP=1	dodopayments-api の登録をスキップします
DODO_DISABLE_KNOWLEDGE_MCP=1	dodo-knowledge の登録をスキップします

真偽値として扱われる値：1、true、yes、on（大文字と小文字は区別しません）。シェルのプロファイルで変数をエクスポートするか、インラインで設定します。

DODO_DISABLE_API_MCP=1 opencode

Claude Code、Codex CLI、Cursor

これらのクライアントは、プラグインに同梱されている静的な .mcp.json からMCP サーバーを読み込みます。サーバーを無効にするには、プロジェクトレベルの独自の設定でそのエントリを上書きし、"enabled": false を設定します。

Claude Code - プロジェクトのルートにある .mcp.json を編集するか、claude mcp disable dodopayments-api を実行します。

{
    "mcpServers": {
        "dodopayments-api": {
            "type": "http",
            "url": "https://mcp.dodopayments.com/mcp",
            "enabled": false
        }
    }
}

適用するには /reload-plugins を実行します。

Codex CLI / Cursor - プラグインに同梱されたファイルを上書きするプロジェクトレベルの .mcp.json であれば、同じ enabled: false のパターンを使用できます。編集後、クライアントを再起動してください。

Claude Code の /plugin UI 内でMCP サーバーごとに切り替える機能は、anthropics/claude-code#27105 と #46373 で上流の対応が進められています。これらが実装されるまでは、上記の enabled: false による上書きがサポートされている方法です。

まず試すプロンプト

プラグインが有効になったら、次を試してください。

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

エージェントは webhook-integration スキルを読み込み、dodo-knowledge MCP を使用して最新のペイロード形式を取得し、Standard Webhooks 仕様に従った署名検証を行うハンドラーを作成します。

ローカル開発

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

サブモジュールもビルド手順も不要です。skills/ は実ファイルとしてベンダー同梱されています。

Claude Code プラグインとマーケットプレイスを検証します。

claude plugin validate .

開発セッションでプラグインを直接読み込みます。

claude --plugin-dir ./dodo-agent-plugin

プッシュする前にすべてを検証します。

npm run verify     # generated artifacts in sync + Agent Plugins conformance

リポジトリの構成

パス	役割
plugin.json	正規のソース。 Agent Plugins v1.0.0 マニフェストであり、バージョンの唯一の情報源です
mcp.json	正規のソース。 Agent Plugins v1.0.0 MCP 設定です
skills/	正規のソース。 実ファイルとしてベンダー同梱されたスキルです。宣言されたセットは .skills-source.json にあります
overlays/*.json	仕様のスキーマでは表現できない、手作業で作成されたプロバイダー固有の追加設定です
.claude-plugin/、.cursor-plugin/、.codex-plugin/、.muse-plugin/、.agents/、.mcp.json、gemini-extension.json、plugins/dodopayments/、providers/	生成物。 手作業で編集しないでください。npm run build を実行してください
scripts/build.mjs	唯一のジェネレーター（差分の確認には --check を使用）
scripts/conformance.mjs	Agent Plugins 仕様適合性バリデーター
.skills-source.json	ベンダー同梱されたスキルの上流の由来情報

スキルは dodopayments/skills で作成され、ここにベンダー同梱されています。週次ワークフローで再同期し、PRを作成します。必要に応じて Sync skills from upstream ワークフローのディスパッチで実行できます。

メンテナー向け

このリポジトリは、GitHub Release ごとに OpenCode npm パッケージを公開するよう設定されています。

初回のみの設定（このリポジトリでは設定済みです）：

• npm スコープ @dodopayments は存在し、Dodo Payments が所有しています。
• publish-opencode.yml に対して @dodopayments/opencode-plugin の npm Trusted Publishing（OIDC）が設定されています。リポジトリに npm トークンは保存されていません。

リリースワークフロー：

1. plugin.json の version を更新します（唯一の信頼できる情報源です）。
2. npm run build を実行して、すべての生成済みマニフェストに反映します。
3. npm run verify を実行し、コミットしてタグを付けます。
4. GitHub Release を作成します。Publish @dodopayments/opencode-plugin ワークフローが、provenance 付きで npm に公開します。

手動ドライラン：

• dry_run: true を指定してワークフローをディスパッチすると、公開せずにリリースパイプラインを検証できます。

CI チェック：

• Verify はすべてのプルリクエストと main へのプッシュで実行されます。成果物の不整合、Agent Plugins への準拠、ライブ JSON Schema 検証、「宣言されたすべてのスキルが存在し、シンボリックリンクがないこと」のアサーション、クライアントごとのマニフェストチェック（Muse、Antigravity、Junie、Gemini）、npm ペイロードチェックを行います。
• リリースワークフローでは、公開前に同じゲートを再実行します。

リソース

• Dodo Payments のドキュメント
• Agent Skills のドキュメント
• MCP サーバーのドキュメント
• Skills のソースリポジトリ
• Discord コミュニティ

ライセンス

MIT - LICENSE を参照してください。