Documentation Index
Fetch the complete documentation index at: https://docs.dodopayments.com/llms.txt
Use this file to discover all available pages before exploring further.
Overview
The Model Context Protocol (MCP) is an open standard that enables AI applications to securely connect to external data sources and APIs. The Dodo Payments MCP Server provides AI assistants like Claude, Cursor, and other MCP-compatible clients with structured access to your payment infrastructure. The Dodo Payments MCP Server uses the Code Mode architecture. Instead of exposing hundreds of individual tools for every API endpoint, Code Mode enables AI agents to write and execute TypeScript code against the Dodo Payments SDK in an isolated sandbox environment.Key capabilities
- Payment Operations: Create, retrieve, and manage payments and refunds
- Subscription Management: Handle recurring billing, upgrades, and cancellations
- Customer Administration: Manage customer data and portal access
- Product Catalog: Create and update products, pricing, and discounts
- License Management: Activate, validate, and manage software licenses
- Usage-Based Billing: Track and bill for metered usage
How Code Mode Works
The Dodo Payments MCP Server provides your AI agent with exactly two tools:- Docs Search Tool: Queries documentation about the Dodo Payments API and SDK to understand available operations and parameters.
- Code Execution Tool: Writes TypeScript code against the SDK that executes in a secure sandbox environment.
Quick Setup
Connect to the Dodo Payments MCP Server in your AI client: 【ロック済パターン_a9b6608d5d94f83fccc83919e48cbf54】 【ロック済パターン_d0d1af507f36eeb86f27c5d096d95b75】 Dodo Agent Plugin は、Claude Code、Codex CLI、Cursor、OpenCode のために MCP サーバーとすべての8つのスキルを1ステップでインストールします。エージェント別のインストールコマンドについては、AI Coding Agentsガイドを参照してください。 お使いのエージェントがリストに含まれていない場合は、以下のタブを使用して MCP サーバーを直接設定してください。 【ロック済パターン_78e639af1281cd283655f496a1d1405c】 【ロック済パターン_668e5829242d9859453a3ec6cfa681f2】 次のコードを [INSERT] に追加してください: コード プレースホルダー_415eb83919874446_END 【ロック済パターン_78e639af1281cd283655f496a1d1405c】 【ロック済パターン_1f346507fc300f1006ffeccfe8906790】 Claude Desktop の設定に次を追加してください: コード プレースホルダー_415eb83919874446_END 構成ファイルの場所:- macOS: [INSERT]
- Windows: [INSERT]
- Linux: [INSERT] 【ロック済パターン_78e639af1281cd283655f496a1d1405c】
Dodo Knowledge MCP
Dodo Payments MCP サーバー（API 操作を実行するためのサーバー）に加えて、Dodo Knowledge MCP というセマンティック検索サーバーを提供し、AI アシスタントが Dodo Payments のドキュメントと知識ベースへ即座にアクセスできるようにします。 【ロック済パターン_6fa96040307d68e9fa44436559d63ee8】 ContextMCP.ai で構築: Dodo Knowledge MCP は ContextMCP によって強化され、ベクトル埋め込みを使用してドキュメント全体の高速なセマンティック検索を可能にしています。 【ロック済パターン_07427f62e4e59df6149fbd24d60de439】Dodo Knowledge MCP とは？
Dodo Knowledge MCP は次を提供するリモート MCP サーバーです:- セマンティックドキュメント検索: 自然言語クエリを使用して関連ドキュメントを検索。
- 文脈的な回答: AI アシスタントが Dodo Payments に関する正確で最新の情報を取得。
- ゼロセットアップ: API キーもローカルインストールも不要—接続するだけでクエリを開始できます。
簡単セットアップ
AI クライアントで Dodo Knowledge MCP に接続してください: 【ロック済パターン_a9b6608d5d94f83fccc83919e48cbf54】 【ロック済パターン_668e5829242d9859453a3ec6cfa681f2】 次のコードを [INSERT] に追加してください: コード プレースホルダー_7bb51f8707109df8_END 【ロック済パターン_78e639af1281cd283655f496a1d1405c】 【ロック済パターン_1f346507fc300f1006ffeccfe8906790】 Claude Desktop の設定に次を追加してください: コード プレースホルダー_7bb51f8707109df8_END 構成ファイルの場所:- macOS: [INSERT]
- Windows: [INSERT]
- Linux: [INSERT] 【ロック済パターン_78e639af1281cd283655f496a1d1405c】
両方のMCPサーバーを同時に使用
最良のAI支援開発体験を得るために、両方のMCPサーバーを使用することをお勧めします:| サーバー | 目的 | 使用ケース |
|---|---|---|
| Dodo Knowledge MCP | ドキュメンテーション検索 | ”How do I handle webhooks?”, “What payment methods are supported?” |
| Dodo Payments MCP | API操作 | 支払いの作成、サブスクリプションの管理、返金の処理 |
Knowledge MCPのトラブルシューティング
接続問題に遭遇した場合:- MCP認証キャッシュをクリア: [INSERT]。
- クライアントアプリケーションを再起動
- クライアントログを確認 エラーメッセージをチェック
- Node.jsバージョンの確認: Node.js 18以上が必要
インストール
ワークフローに最も適したインストール方法を選択してください。リモート MCP サーバー (推奨)
ホストされた MCP サーバーにアクセスし、ローカルセットアップやインストールは不要です。これが最も速く始める方法です。 【ロック済パターン_3081a298b9494352000db8bcb2f0ac9f】
【ロック済パターン_62a33af6ad2d743416e07b4e382a6c2b】
【ロック済パターン_bd2642ca094c2e4ce733f0386172be2d】
【ロック済パターン_bd1568a9aaf0e86b69853e215d3d5723】
ブラウザで https://mcp.dodopayments.com に移動します。
【ロック済パターン_640d0b31f6faa54914d25c81f5dbf413】
【ロック済パターン_b8d4e4a1a3c0fcf28fd2afe7ce9e8316】
特定のクライアント用に提供された JSON 設定をコピーします。Cursor または Claude Desktop の場合、これを MCP 設定に追加してください:
コード プレースホルダー_9997dbc806dba3c6_END
【ロック済パターン_640d0b31f6faa54914d25c81f5dbf413】
【ロック済パターン_8be57788a275cad53ee59f91af51bfd5】
OAuth フローは次のことを促します:
- Dodo Payments API キーの入力
- 環境の選択 (テストまたはライブ)
- MCP クライアントタイプの選択
NPM パッケージ
NPM を使用して MCP サーバーをローカルにインストールして実行します。 【ロック済パターン_a9b6608d5d94f83fccc83919e48cbf54】 【ロック済パターン_c8776436a7ae17e188a287e7c6852f16】 コード プレースホルダー_381a63f499d30fb7_END 【ロック済パターン_78e639af1281cd283655f496a1d1405c】 【ロック済パターン_8d04e6cca1a5903f80148c5b923e5c3f】 コード プレースホルダー_a416b82db9704459_END 【ロック済パターン_78e639af1281cd283655f496a1d1405c】 【ロック済パターン_0c2288c06aada9f019d2bafea4e5f3fb】 【ロック済パターン_317ec56569e36d0c9e56c2648890a76e】 使用 [INSERT] で常に最新のバージョンを取得するか、固定 [INSERT] で安定性のある特定のバージョンを選択します。 【ロック済パターン_4dec52ce04aa8849a8a60508baae30ae】Docker
コンテナ化された環境で MCP サーバーを実行し、一貫したデプロイメントを実現します。 【ロック済パターン_278c8ff892f265e3e925879c7aa762a2】 コード プレースホルダー_532b3d8b277f8ccf_END コード プレースホルダー_dbbb27b6ff12ee43_END 【ロック済パターン_2a2518a6b81e50ec206d5e6c9d83c4eb】 【ロック済パターン_53d873bd6fa65f248f65f62194471195】 Docker イメージは GitHub Container Registry で入手可能です。 【ロック済パターン_49aff3a3aee1d0bab41e7eade47939d0】クライアント設定
お好みの AI クライアントで Dodo Payments MCP サーバーを設定してください。 【ロック済パターン_a9b6608d5d94f83fccc83919e48cbf54】 【ロック済パターン_668e5829242d9859453a3ec6cfa681f2】 カーソルで Dodo Payments MCP サーバーを設定し、支払いデータへの会話形式のアクセスを可能にします。 ワンクリックインストール 以下のボタンを使用して、カーソルに直接 MCP サーバーをインストールしてください: [
](https://cursor.com/en-US/install-mcp?name=dodopayments-mcp&config=eyJjb21tYW5kIjoibnB4IiwiYXJncyI6WyIteSIsImRvZG9wYXltZW50cy1tY3AiXSwiZW52Ijp7IkRPRE9fUEFZTUVOVFNfQVBJX0tFWSI6IlNldCB5b3VyIERPRE9fUEFZTUVOVFNfQVBJX0tFWSBoZXJlLiIsIkRPRE9fUEFZTUVOVFNfV0VCSE9PS19LRVkiOiJTZXQgeW91ciBET0RPX1BBWU1FTlRTX1dFQkhPT0tfS0VZIGhlcmUuIn19)
クリックした後、カーソルの [INSERT] に環境変数を設定してください: カーソル設定 > ツール & MCP > 新しい MCP サーバー。
手動設定
【ロック済パターン_bd2642ca094c2e4ce733f0386172be2d】
【ロック済パターン_b5120fe2afbf9bb96d1de6f9549e8f41】
カーソル設定 > 機能 > モデル構文プロトコル をナビゲートしてください。もしくは、[INSERT] を押し、「MCP 設定」を検索してください。
【ロック済パターン_640d0b31f6faa54914d25c81f5dbf413】
【ロック済パターン_0112f2d89dc6125934d590d4a51a751d】
設定の編集をクリックして [INSERT] ファイルを開きます。
【ロック済パターン_640d0b31f6faa54914d25c81f5dbf413】
【ロック済パターン_a65e4e236194f7c177caa156c6d0b797】
次の設定のいずれかを選択します:
リモートサーバー (推奨)
コード プレースホルダー_f2721f34619bf3b8_END
ローカル NPX
コード プレースホルダー_712b4ef4dd61616b_END
【ロック済パターン_640d0b31f6faa54914d25c81f5dbf413】
【ロック済パターン_8368e3e8540b47a92000151cb7e30a33】
設定ファイルを保存し、カーソルを再起動します。
【ロック済パターン_3c8e9103f1fb437472f20f9142ad5c56】
AI アシスタントに Dodo Payments データについて質問して接続を確認します。
【ロック済パターン_6abc13ae2ca3ecce11977a5f9bd347f4】
【ロック済パターン_640d0b31f6faa54914d25c81f5dbf413】
【ロック済パターン_a01a451f7aba1a80f0af7148df811dfc】
【ロック済パターン_78e639af1281cd283655f496a1d1405c】
【ロック済パターン_1f346507fc300f1006ffeccfe8906790】
Claude Desktop で Dodo Payments MCP サーバーを設定し、支払いデータへの会話形式のアクセスを可能にします。
【ロック済パターン_bd2642ca094c2e4ce733f0386172be2d】
【ロック済パターン_ecfdd2e916ed4a93d6b3950e9027df3f】
Claude Desktop の設定ファイルを探します:
- macOS: [INSERT]
- Windows: [INSERT]
- Linux: [INSERT] 【ロック済パターン_640d0b31f6faa54914d25c81f5dbf413】
- macOS: [INSERT]
- Windows: [INSERT]
- Linux: [INSERT] 【ロック済パターン_640d0b31f6faa54914d25c81f5dbf413】
環境変数
環境変数を使用して MCP サーバーの動作を設定します。| 変数 | 説明 | 必須 |
|---|---|---|
| [INSERT] | あなたの Dodo Payments API キー | はい |
| [INSERT] | あなたのウェブフック署名キー | いいえ |
| [INSERT] | スタート [INSERT] 本番環境の場合 | いいえ |
リモートでの実行
Web ベースのクライアントやエージェンティック ワークフローのために MCP サーバーをリモート HTTP サーバーとしてデプロイします。 コード プレースホルダー_bf62a40d701379f3_ENDリモートサーバー設定
デプロイ後、クライアントはサーバー URL を使用して接続できます: コード プレースホルダー_ed19761cff56a36f_END認証ヘッダー
リモートサーバーは、次のヘッダーを介して認証を受け入れます:| ヘッダー | 説明 |
|---|---|
| [INSERT] | ベアラートークン認証 |
| [INSERT] | 直接 API キーヘッダー |
セキュリティのベストプラクティス
Code Mode は、コードをサンドボックス環境で実行し、サーバー側で API キーを注入することにより固有のセキュリティを提供します。資格情報を保護するために、これらの追加のベストプラクティスを遵守してください。 【ロック済パターン_3a00efd457b01f610250031fcbf16962】 【ロック済パターン_58b09b66cd00f40de384d770573ae848】 資格情報をバージョン管理にコミットしない API キーは環境変数やセキュアシークレット管理システムに保存してください。 コード プレースホルダー_2748a5cfd62644a7_END キーを定期的にローテーション 定期的に新しい API キーを生成し、古いキーを Dodo Payments ダッシュボードで取り消します。 開発にはテストキーを使用 開発中は常にテストモードの API キーを使用し、本番データに影響を与えないようにしてください。 【ロック済パターン_aae63d8bf6b6da4ac6fb501e13691e4d】 【ロック済パターン_1d0876565ecc6c625335a3849461e889】 リモートサーバーに認証を実装 リモートデプロイ時には常に [INSERT] ヘッダーまたは [INSERT] ヘッダーを介して認証を要求します。 API 使用状況の監視 Dodo Payments ダッシュボードを通じて MCP サーバーのアクティビティを追跡し、異常なパターンに対するアラートを設定します。 【ロック済パターン_aae63d8bf6b6da4ac6fb501e13691e4d】 【ロック済パターン_ddb4fc82978c8dda72d606214fdad81d】 リモートサーバーには HTTPS を使用 常に HTTPS エンドポイントの後ろでリモート MCP サーバーをデプロイしてください。 レート制限を実装 MCPサーバーとAPIレベルの両方で濫用を防ぐためにレートリミットを実装します。 ネットワークアクセスを制限 ファイアウォールルールを設定して、MCPサーバーに接続できるクライアントを制限してください。 【ロック済パターン_aae63d8bf6b6da4ac6fb501e13691e4d】 【ロック済パターン_7a451aee1061c1cf2a4108f13acbafff】トラブルシューティング
【ロック済パターン_3a00efd457b01f610250031fcbf16962】 【ロック済パターン_3e10fc2511884be492da344a929e2311】 API キーを確認 API キーが正しく設定され、必要な権限を持っていることを確認してください。 コード プレースホルダー_f38160fe3cf56865_END ネットワーク接続を確認 Dodo Payments API エンドポイントにアクセスできることを確認してください。 クライアントログを確認 MCP クライアントで詳細なログを有効にして接続問題の診断を行います。 【ロック済パターン_aae63d8bf6b6da4ac6fb501e13691e4d】 【ロック済パターン_8f29ea613a43315c29bf194043f8ada2】 API キーの環境を確認 テストエンドポイントにテストキーを使い、本番エンドポイントにライブキーを使っているか確認してください。 環境変数の確認 [INSERT] が正しく設定されていることを確認してください（本番の場合は[INSERT]）。 資格情報を再生成 問題が続く場合は、ダッシュボードで新しい API キーを生成してください。 【ロック済パターン_aae63d8bf6b6da4ac6fb501e13691e4d】 【ロック済パターン_565675849d369f82d965d1f3a122632b】 入力パラメータを検証 AIアシスタントが各ツールに正しい形式のパラメータを提供しているか確認します。 エラーメッセージの確認 APIのエラーレスポンスを確認し、具体的な失敗原因を特定します。 API で直接テスト Dodo Payments API を curl や Postman で直接呼び出して操作が機能することを確認してください。 【ロック済パターン_aae63d8bf6b6da4ac6fb501e13691e4d】 【ロック済パターン_7a451aee1061c1cf2a4108f13acbafff】Code Mode が選ばれる理由
従来の MCP 実装では、多くの API エンドポイントが個別のツールとして公開される「ツール乱立」が発生します。Code Mode は以下の理由でこの問題を優れた方法で解決します:LLMはツール呼び出しよりもコードを書くのが得意
LLMは、何百万行もの現実世界のコードに基づいて訓練されており、スクリプトを書くのに自然な能力を持っています。これに対し、ツール呼び出しは人工的な例に基づいていることが多いです。 【ロック済パターン_6fa96040307d68e9fa44436559d63ee8】 “LLMにツール呼び出しでタスクを実行させると、シェイクスピアに1か月のマンダリンダース授業を受けさせて、そこで劇を書くように頼むようなものです。” — Cloudflare 【ロック済パターン_07427f62e4e59df6149fbd24d60de439】コンテキストウィンドウの膨張を排除
従来の方法では、会話が始まる前に各ツール定義がトークンを消費します。50以上のツールが公開されると、容易に55K〜100K以上のトークンが消費されます。Anthropicは、最適化前にツール定義が最大134Kトークンを使用する可能性があることを発見しました。 Code Mode では、2つのツール定義のみがロードされ（約1Kトークン）、エージェントは必要な文書をオンデマンドで検索します。Anthropicのツール検索ツールは、コンテキストウィンドウの95%を保持し、オーバーヘッドを77Kから8.7Kトークンに削減しました。プログラム的オーケストレーションによるレイテンシー削減
従来のツール呼び出しでは、単一の操作ごとに完全なモデル推論が必要です。タスクが20のAPI呼び出しを要求する場合、それは20回の往復です。Code Modeでは、エージェントがスクリプトを作成し、すべての呼び出しを実行し、最終結果のみを返します。 Anthropicは、このプログラム的アプローチを使用して、トークンの37％削減と精度の改善（知識検索が25.6％から28.5％に向上）を観察しました。設計上よりセキュアに
Code Mode は固有のセキュリティの利点を提供します:- パラメータにAPIキーがない: APIキーはサーバー側で注入され、LLMに送信されるツールパラメータでは公開されません。
- 分離されたサンドボックス: コードはセキュアな環境で実行され、ネットワークやホストファイルシステムへのアクセスはありません。
- 制御されたSDK: エージェントに利用可能な認可されたSDKメソッドのみ。