AIエージェントに決済機能を一括追加するDodo Agent Plugin

コーディングエージェントに決済機能をインストールするのに、複数の設定ファイルを手で書く必要はなくなった。

Dodo Paymentsが2026年4月24日にリリースした「dodo-agent-plugin」は、同社のMCPサーバー2本とエージェントスキル8種をワンステップで追加できる公式プラグインだ。Claude Code、Codex CLI、Cursor、OpenCodeが対象で、インストール後はエージェントが決済・サブスクリプション・使用量課金などをコードとして実装できる状態になる。

この記事でわかること:

dodo-agent-pluginが含む機能の全体像
Code Modeアーキテクチャがコンテキスト消費を95%削減する仕組み
対応エージェント別のインストール方法

Dodo Agent Pluginとは

https://dodopayments.com/

Dodo Paymentsは、AI・SaaS向けの決済プラットフォームだ。クレジット課金、使用量課金、サブスクリプション、グローバル決済を一括で扱える。25,000社以上のビルダーに採用されている。

今回リリースされた「dodo-agent-plugin」は、以下の2つをワンステップでインストールする公式プラグインだ。

MCPサーバー×2本: Dodo Payments MCP（API実行）と Dodo Knowledge MCP（ドキュメント検索）
エージェントスキル×8種: チェックアウト・サブスクリプション・Webhook・ライセンスキーなど

これまでMCPサーバーとスキルはそれぞれ個別に設定が必要だったが、プラグインを追加するだけですべてが有効になる。

コーディングエージェントと決済が難しかった理由

AIエージェントは、コードの生成・デプロイ・インフラ管理を自律的にこなせる。一方、「決済処理」だけは人間がドキュメントを読んで手動実装する前提の設計になっていた。

最大のボトルネックは、従来のMCPサーバーの設計にある。一般的なMCP実装ではAPIエンドポイントごとに1つのツールを定義する。決済APIのエンドポイントが50個あれば50個のツール定義が必要になり、それだけでコンテキストウィンドウの55,000トークン以上を消費してしまう。

もう一つの問題がエージェントの「知識」だ。APIドキュメントを渡しただけでは、Webhookハンドラーやサブスクリプションフローといったパターンをエージェントは正しく把握できない。RAWなAPI仕様から実装パターンを推論するだけではハルシネーションが起きやすく、動かないコードが生成されるケースが多かった。

Code Modeアーキテクチャ — 2ツールで全APIを操作する

Dodo PaymentsのMCPサーバーは、AnthropicとCloudflareが検証した「Code Mode」アーキテクチャを採用している。

従来のMCPがエンドポイントごとにツールを定義するのに対し、Code Modeはツールを2つだけ持つ。

ツール	役割
Docs Search	Dodo Paymentsのドキュメントを意味検索する
Code Execution	TypeScript SDKのコードをサンドボックスで実行する

エージェントは「決済を作成するコードを書いて」という指示に対し、Docs Searchで仕様を調べてからCode ExecutionでTypeScriptコードをサンドボックス実行する。エンドポイントが何百あっても定義は2つのまま変わらない。

コンテキスト消費は約1,000トークンで済む（従来比95%以上削減）。Cloudflareが2,500以上のAPIエンドポイントをこの方式で2ツールに集約し、AnthropicはトークンUsageの37%削減と知識検索精度の向上を測定している（参考）。

セキュリティ面では、APIキーがサーバーサイドで注入されるためLLMのコンテキストには含まれない。サンドボックスはDodo Payments API以外へのネットワークアクセスを持たない設計になっている。

8つのエージェントスキルの内容

スキルは、実装パターンの「手順書」をエージェントに与える仕組みだ。APIドキュメントだけでは得られない、実際の統合に必要な知識をエージェントに渡す。

スキル名	内容
dodo-best-practices	セキュリティ・エラーハンドリングを含む統合ガイド
webhook-integration	Webhookのセットアップと決済イベント処理
subscription-integration	トライアル・階層プランを含むサブスクリプション実装
checkout-integration	チェックアウトセッションと決済フローの構築
usage-based-billing	使用量イベントとメーターによる従量課金
billing-sdk	React向けBillingSDKコンポーネントの使い方
license-keys	デジタルプロダクト向けライセンスキー管理
credit-based-billing	クレジット残高と従量クレジット消費の実装

スキルが読み込まれると、エージェントはそのスキルの実装パターンを参照しながらコードを生成する。テスト済みのワークフローに沿って進むため、ハルシネーションによる実装ミスが減る。

インストール方法

Claude Codeの場合

/plugin marketplace add dodopayments/skills
/plugin install checkout-integration

必要なスキルだけ選んでインストールすることも可能だ。全スキルを一括で追加するには以下を実行する。

npx skills add dodopayments/skills

Cursor・Claude Desktop・Windsurf向けMCP設定

{
  "mcpServers": {
    "dodo-knowledge": {
      "command": "npx",
      "args": ["-y", "mcp-remote@latest", "https://knowledge.dodopayments.com/mcp"]
    },
    "dodopayments": {
      "command": "npx",
      "args": ["-y", "mcp-remote@latest", "https://mcp.dodopayments.com/sse"]
    }
  }
}

リモートサーバー方式はローカルインストール不要で、認証はOAuthで処理される。APIキーを設定ファイルに書く必要がない点が利点だ。

エージェントネイティブな決済スタック

dodo-agent-pluginが示すのは、「決済実装を人間が調べてエージェントに渡す」から「エージェント自身が正しいパターンで決済機能を実装する」への転換だ。

Code ModeアーキテクチャでMCPのコンテキスト消費を抑え、スキルで実装精度を底上げする。AIファーストなSaaSやvibe-codingで作られたアプリに課金機能を後付けする手間が、大幅に減る設計になっている。