AI Coding Agentsで構築する

Dodo Agent Pluginは、2つのMCPサーバーと8つのインテグレーションスキルを、1回のインストールでAIコーディングエージェントに組み込みます。Claude Code、Codex CLI、Cursor、OpenCodeで利用でき、MCPサーバーとskills CLIは、MCP互換クライアントであれば利用できます。

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

API MCP server — payments、subscriptions、customers、products、refunds、licenses、usageへのライブアクセス。ブラウザOAuthで認証されるため、ローカルキーは不要です。
Knowledge MCP server — Dodo Paymentsのドキュメント全体を対象としたセマンティック検索。認証情報は不要です。
8つのagent skills — checkout、subscriptions、webhooks、usage-based billing、credit-based billing、license keys、BillingSDK、ベストプラクティスについて、必要に応じてエージェントが読み込むチートシートです。

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

以下から使用するコーディングエージェントを選択してください。インストールすると、2つのMCPサーバーと8つすべてのスキルが自動的に追加されます。

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を選びます。

プラグインをインストールすると、2つのMCPサーバーと8つすべてのスキルが自動的に登録されます。

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

以前にマーケットプレイスとプラグインを追加したにもかかわらず、/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を再起動します。プラグインは.claude/skills/（CursorのClaude Code互換レイヤー経由）からスキルを読み込み、.mcp.jsonからMCPサーバーを読み込みます。

Cursorのマーケットプレイスサポートは近日提供予定です。現時点では、上記の手動インストールを使用してください。

OpenCode

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

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

OpenCodeを再起動します。両方のMCPサーバー（dodopayments-api、dodo-knowledge）はプラグインのconfig hookによって自動的に登録され、8つのスキルはインストール済みパッケージから自動検出されます。手動のmcpブロックは不要です。

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

利用できるもの

プラグインをインストールすると、エージェントから2つのMCPサーバーと8つのスキルにアクセスできます。

MCPサーバー

サーバー	目的	認証
`dodopayments-api`	ライブAPIアクセス — payments、subscriptions、customers、products、refunds、licenses、usage	OAuth（ブラウザ）
`dodo-knowledge`	Dodo Paymentsのドキュメント全体を対象としたセマンティック検索	なし

両方のサーバーはmcp-remote経由で接続されるため、MCP互換クライアントであれば実行できます。

エージェントスキル

スキル	説明
`best-practices`	Dodo Paymentsとのインテグレーションに関する包括的なガイドとベストプラクティス
`checkout-integration`	checkout sessionと支払いフローの作成
`subscription-integration`	subscription billingフローの実装
`webhook-integration`	支払いイベント用webhooksの設定と処理
`usage-based-billing`	eventsとmetersを使用したmetered billingの実装
`credit-based-billing`	クレジットエンタイトルメント、残高、従量制クレジットの差し引き
`license-keys`	デジタル製品の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を使用して最新のpayload形式を取得し、Standard Webhooks仕様に従った署名検証付きのhandlerを作成します。

その他のサポート対象エージェント

Agent PluginはClaude Code、Codex CLI、Cursor、OpenCodeに対応しています。別のエージェントを使用する場合は、MCPサーバーとskills CLIを通じてDodo Paymentsに接続してください。

エージェント	最短の方法	その他の対応
Claude Code	Agent Plugin（1コマンド）	MCP server、個別のスキル
Codex CLI	Agent Plugin（1コマンド）	MCP server
Cursor	Agent Plugin（git clone）	MCP server config、skills CLI
OpenCode	Agent Plugin（npm）	MCP server config、skills CLI
GitHub Copilot（VS Code）	MCP Serverガイド	Skills CLI
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を追加すると、生のMarkdown版を取得できます（例: /api-reference/introduction.md）。
ソースリポジトリ: github.com/dodopayments/dodo-docs — オフラインでのインデックス作成用にcloneできます。

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

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

checkout sessionと支払いリンクを作成 — One-time paymentsとsubscriptions
subscriptionとusage-based billingをエンドツーエンドで構築 — Subscriptions、Usage-based billing、Credit-based billing
Standard Webhooks準拠のhandlerを署名検証付きで生成 — Webhooks
料金表とsubscription管理用のBillingSDK Reactコンポーネントを組み込む — BillingSDK
デジタル製品向けのlicense-keyフローを作成 — License keys
エンタイトルメント、残高、繰り越し、超過分を含むcredit-based billingを実装 — Credits

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

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

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

APIキーで設定する

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

Local API key mode — Claude Code

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

dodo_api_key — 使用するdodo_test_...またはdodo_live_...キー
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で自分で宣言します。このエントリがプラグインのデフォルトのリモートサーバーより優先されます。

{
  "$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搭載billing assistant — エディターで質問、構築、計画を実行

API Reference

Dodo Paymentsの全エンドポイントに関する完全なOpenAPIリファレンス

Getting Started

Features

Integrate

Merchant of Record

Miscellaneous

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

Dodo Agent Plugin on GitHub

利用できるもの

MCPサーバー

エージェントスキル

最初に試すプロンプト

その他のサポート対象エージェント

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

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

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

APIキーで設定する

次のステップ

MCP Server

Agent Skills

Sentra IDE Assistant

API Reference

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

Dodo Agent Plugin on GitHub

​利用できるもの

​MCPサーバー

​エージェントスキル

​最初に試すプロンプト

​その他のサポート対象エージェント

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

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

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

​APIキーで設定する

​次のステップ

MCP Server

Agent Skills

Sentra IDE Assistant

API Reference

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

利用できるもの

MCPサーバー

エージェントスキル

最初に試すプロンプト

その他のサポート対象エージェント

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

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

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

APIキーで設定する

次のステップ