> ## 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.

# MCP Server

> Enable AI assistants to interact with the Dodo Payments API through Code Mode—a high-performance architecture for seamless payment operations and subscription management.

## 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:

1. **Docs Search Tool**: Queries documentation about the Dodo Payments API and SDK to understand available operations and parameters.
2. **Code Execution Tool**: Writes TypeScript code against the SDK that executes in a secure sandbox environment.

This architecture allows agents to perform complex, multi-step operations in a single invocation. For example, an agent can list all active subscriptions, filter them based on specific criteria, and apply a discount to each—all within one script.

<Tip>
  Using Code Mode, agents can chain multiple API calls, handle conditional logic, and perform calculations without requiring multiple round-trips to the LLM.
</Tip>

### Quick Setup

Connect to the Dodo Payments MCP Server in your AI client:

【ロック済パターン\_a9b6608d5d94f83fccc83919e48cbf54】
【ロック済パターン\_d0d1af507f36eeb86f27c5d096d95b75】
[Dodo Agent Plugin](/developer-resources/build-with-ai-coding-agents) は、Claude Code、Codex CLI、Cursor、OpenCode のために MCP サーバーとすべての8つのスキルを1ステップでインストールします。エージェント別のインストールコマンドについては、[AI Coding Agentsガイド](/developer-resources/build-with-ai-coding-agents)を参照してください。

お使いのエージェントがリストに含まれていない場合は、以下のタブを使用して MCP サーバーを直接設定してください。
【ロック済パターン\_78e639af1281cd283655f496a1d1405c】

【ロック済パターン\_668e5829242d9859453a3ec6cfa681f2】
次のコードを \[INSERT] に追加してください:

コード プレースホルダー\_415eb83919874446\_END

【ロック済パターン\_78e639af1281cd283655f496a1d1405c】

【ロック済パターン\_1f346507fc300f1006ffeccfe8906790】
Claude Desktop の設定に次を追加してください:

コード プレースホルダー\_415eb83919874446\_END

構成ファイルの場所:

* **macOS**: \[INSERT]
* **Windows**: \[INSERT]
* **Linux**: \[INSERT]
  【ロック済パターン\_78e639af1281cd283655f496a1d1405c】

【ロック済パターン\_e01afe5ad2b70c1861708d679d3c0fa9】
次のコードを \[INSERT] に追加してください:

コード プレースホルダー\_415eb83919874446\_END

【ロック済パターン\_78e639af1281cd283655f496a1d1405c】

【ロック済パターン\_03fd3a56aff47a5edfec79dadbdf26a7】
ターミナルで次を実行してください:

コード プレースホルダー\_407da95b630d262a\_END

【ロック済パターン\_78e639af1281cd283655f496a1d1405c】
【ロック済パターン\_0c2288c06aada9f019d2bafea4e5f3fb】

【ロック済パターン\_53d873bd6fa65f248f65f62194471195】
Node.js 18以上が必要です。リモートサーバーはOAuthで認証を行います。初回接続時にAPIキーの入力と環境の選択を求められます。
【ロック済パターン\_49aff3a3aee1d0bab41e7eade47939d0】

## Dodo Knowledge MCP

Dodo Payments MCP サーバー（API 操作を実行するためのサーバー）に加えて、**Dodo Knowledge MCP** というセマンティック検索サーバーを提供し、AI アシスタントが Dodo Payments のドキュメントと知識ベースへ即座にアクセスできるようにします。

【ロック済パターン\_6fa96040307d68e9fa44436559d63ee8】
**[ContextMCP.ai](https://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】

【ロック済パターン\_e01afe5ad2b70c1861708d679d3c0fa9】
次のコードを \[INSERT] に追加してください:

コード プレースホルダー\_7bb51f8707109df8\_END

【ロック済パターン\_78e639af1281cd283655f496a1d1405c】

【ロック済パターン\_03fd3a56aff47a5edfec79dadbdf26a7】
ターミナルで次を実行してください:

コード プレースホルダー\_2d51ee178da6f0af\_END

【ロック済パターン\_78e639af1281cd283655f496a1d1405c】
【ロック済パターン\_0c2288c06aada9f019d2bafea4e5f3fb】

【ロック済パターン\_53d873bd6fa65f248f65f62194471195】
Node.js 18以上が必要です。\[INSERT] パッケージはリモート MCP サーバーへの接続を処理します。
【ロック済パターン\_49aff3a3aee1d0bab41e7eade47939d0】

### 両方のMCPサーバーを同時に使用

最良のAI支援開発体験を得るために、両方のMCPサーバーを使用することをお勧めします:

| サーバー                   | 目的           | 使用ケース                                                              |
| ---------------------- | ------------ | ------------------------------------------------------------------ |
| **Dodo Knowledge MCP** | ドキュメンテーション検索 | "How do I handle webhooks?", "What payment methods are supported?" |
| **Dodo Payments MCP**  | API操作        | 支払いの作成、サブスクリプションの管理、返金の処理                                          |

コード プレースホルダー\_0aeac97bfecbb7f2\_END

【ロック済パターン\_317ec56569e36d0c9e56c2648890a76e】
両方のサーバーが設定されていると、AIアシスタントは最初に文書を検索して機能の実装方法を理解し、その後実際のAPIコールを実行できます—すべて1つの会話で。
【ロック済パターン\_4dec52ce04aa8849a8a60508baae30ae】

### Knowledge MCPのトラブルシューティング

接続問題に遭遇した場合:

1. **MCP認証キャッシュをクリア**: \[INSERT]。
2. **クライアントアプリケーションを再起動**
3. **クライアントログを確認** エラーメッセージをチェック
4. **Node.jsバージョンの確認**: Node.js 18以上が必要

【ロック済パターン\_0d288b5f7e2819b6a54bf391a66e053a】
Dodo Knowledge MCP設定ページにアクセス
【ロック済パターン\_4ceaf3811b39bde3b7bfedbcf0487a0b】

## インストール

ワークフローに最も適したインストール方法を選択してください。

### リモート MCP サーバー (推奨)

ホストされた MCP サーバーにアクセスし、ローカルセットアップやインストールは不要です。これが最も速く始める方法です。

【ロック済パターン\_3081a298b9494352000db8bcb2f0ac9f】

<iframe className="w-full aspect-video rounded-md" src="https://www.youtube.com/embed/TxGgYxNmkT4" title="Using Dodo Payment's Remote MCP Server" frameBorder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture" allowFullScreen />

【ロック済パターン\_62a33af6ad2d743416e07b4e382a6c2b】

【ロック済パターン\_bd2642ca094c2e4ce733f0386172be2d】
【ロック済パターン\_bd1568a9aaf0e86b69853e215d3d5723】
ブラウザで [https://mcp.dodopayments.com](https://mcp.dodopayments.com) に移動します。
【ロック済パターン\_640d0b31f6faa54914d25c81f5dbf413】

【ロック済パターン\_b8d4e4a1a3c0fcf28fd2afe7ce9e8316】
特定のクライアント用に提供された JSON 設定をコピーします。Cursor または Claude Desktop の場合、これを MCP 設定に追加してください:

コード プレースホルダー\_9997dbc806dba3c6\_END

【ロック済パターン\_640d0b31f6faa54914d25c81f5dbf413】

【ロック済パターン\_8be57788a275cad53ee59f91af51bfd5】
OAuth フローは次のことを促します:

* Dodo Payments API キーの入力
* 環境の選択 (テストまたはライブ)
* MCP クライアントタイプの選択

【ロック済パターン\_4907e9f6f7fbd509120d7a87afc829e9】
API キーを安全に保管してください。開発中はテストモードキーを使用してください。
【ロック済パターン\_176d815432e7554ac558e8631b2bc397】
【ロック済パターン\_640d0b31f6faa54914d25c81f5dbf413】

【ロック済パターン\_606fac2bd646ef76f5d66097882887ed】
**ログインして承認**をクリックして接続を承認します。

【ロック済パターン\_3c8e9103f1fb437472f20f9142ad5c56】
接続が完了すると、AI アシスタントが Dodo Payments API を代理で操作できるようになります。
【ロック済パターン\_6abc13ae2ca3ecce11977a5f9bd347f4】
【ロック済パターン\_640d0b31f6faa54914d25c81f5dbf413】
【ロック済パターン\_a01a451f7aba1a80f0af7148df811dfc】

### 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](https://github.com/orgs/dodopayments/packages/container/package/mcp) で入手可能です。
【ロック済パターン\_49aff3a3aee1d0bab41e7eade47939d0】

## クライアント設定

お好みの AI クライアントで Dodo Payments MCP サーバーを設定してください。

【ロック済パターン\_a9b6608d5d94f83fccc83919e48cbf54】
【ロック済パターン\_668e5829242d9859453a3ec6cfa681f2】
カーソルで Dodo Payments MCP サーバーを設定し、支払いデータへの会話形式のアクセスを可能にします。

**ワンクリックインストール**

以下のボタンを使用して、カーソルに直接 MCP サーバーをインストールしてください:

\[

![カーソルを追加](https://cursor.com/deeplink/mcp-install-dark.svg)

]\([https://cursor.com/en-US/install-mcp?name=dodopayments-mcp\&config=eyJjb21tYW5kIjoibnB4IiwiYXJncyI6WyIteSIsImRvZG9wYXltZW50cy1tY3AiXSwiZW52Ijp7IkRPRE9fUEFZTUVOVFNfQVBJX0tFWSI6IlNldCB5b3VyIERPRE9fUEFZTUVOVFNfQVBJX0tFWSBoZXJlLiIsIkRPRE9fUEFZTUVOVFNfV0VCSE9PS19LRVkiOiJTZXQgeW91ciBET0RPX1BBWU1FTlRTX1dFQkhPT0tfS0VZIGhlcmUuIn19](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】

【ロック済パターン\_0112f2d89dc6125934d590d4a51a751d】
テキストエディタでファイルを開き、Dodo Payments設定を追加します:

**リモートサーバー (推奨)**

コード プレースホルダー\_f2721f34619bf3b8\_END

**ローカル NPX**

コード プレースホルダー\_712b4ef4dd61616b\_END

【ロック済パターン\_640d0b31f6faa54914d25c81f5dbf413】

【ロック済パターン\_83563b32c3caf8bd7aa68192b6ebcc7d】
変更が適用されるために、Claude Desktop を閉じて再度開きます。

【ロック済パターン\_317ec56569e36d0c9e56c2648890a76e】
Claude Desktop の 🔌 アイコンで MCP サーバーが接続されていることを確認します。
【ロック済パターン\_4dec52ce04aa8849a8a60508baae30ae】
【ロック済パターン\_640d0b31f6faa54914d25c81f5dbf413】
【ロック済パターン\_a01a451f7aba1a80f0af7148df811dfc】
【ロック済パターン\_78e639af1281cd283655f496a1d1405c】

【ロック済パターン\_03fd3a56aff47a5edfec79dadbdf26a7】
Claude Code CLI で Dodo Payments MCP サーバーを設定してください。

ターミナルで次のコマンドを実行してください:

コード プレースホルダー\_70033a040015c752\_END

構成はホームディレクトリの \[INSERT] ファイルに保存されます。

【ロック済パターン\_317ec56569e36d0c9e56c2648890a76e】
Claude Code はシェルからの環境変数を自動的に取得するため、コマンドを実行する前にそれらをエクスポートできます。
【ロック済パターン\_4dec52ce04aa8849a8a60508baae30ae】
【ロック済パターン\_78e639af1281cd283655f496a1d1405c】

【ロック済パターン\_8365d87b980f5d0fb6ff0207825c13c5】
VS Code で Dodo Payments MCP サーバーを設定。

**ワンクリックインストール**

[VS Codeを開く](https://vscode.stainless.com/mcp/%7B%22name%22%3A%22dodopayments-mcp%22%2C%22command%22%3A%22npx%22%2C%22args%22%3A%5B%22-y%22%2C%22dodopayments-mcp%22%5D%2C%22env%22%3A%7B%22DODO_PAYMENTS_API_KEY%22%3A%22Set%20your%20DODO_PAYMENTS_API_KEY%20here.%22%2C%22DODO_PAYMENTS_WEBHOOK_KEY%22%3A%22Set%20your%20DODO_PAYMENTS_WEBHOOK_KEY%20here.%22%7D%7D)

クリック後、VS Code の \[INSERT] に環境変数を設定してください。 **コマンドパレット** > **MCP: ユーザー設定を開く**。

**手動設定**

【ロック済パターン\_bd2642ca094c2e4ce733f0386172be2d】
【ロック済パターン\_01c11d820b190ade4d2a29feff5a49da】
コマンドパレットを開き (\[INSERT]), "MCP: ユーザー設定を開く" を検索します。
【ロック済パターン\_640d0b31f6faa54914d25c81f5dbf413】

【ロック済パターン\_b62f78a8bb37ff0ea4a9a60d555a640c】
Dodo Payments MCP サーバーを追加します:

コード プレースホルダー\_712b4ef4dd61616b\_END

【ロック済パターン\_640d0b31f6faa54914d25c81f5dbf413】

【ロック済パターン\_fabb79a0cecb26359867d78b61382dd7】
VS Code をリロード ( \[INSERT] > "Windowを再読み込み")して MCP サーバーを有効にします。
【ロック済パターン\_640d0b31f6faa54914d25c81f5dbf413】
【ロック済パターン\_a01a451f7aba1a80f0af7148df811dfc】
【ロック済パターン\_78e639af1281cd283655f496a1d1405c】

【ロック済パターン\_cdb3c08aa62f9fa061b05f4461f312ea】
Cline (VS Code) に Dodo Payments MCP サーバーを設定して、会話形式の支払いデータへのアクセスを有効にします。
【ロック済パターン\_bd2642ca094c2e4ce733f0386172be2d】
【ロック済パターン\_43db9eecf5eea8e9c4ad60b6c3ff1c0b】
Cline 設定ファイルを見つけます:

* **macOS**: \[INSERT]
* **Windows**: \[INSERT]
* **Linux**: \[INSERT]
  【ロック済パターン\_640d0b31f6faa54914d25c81f5dbf413】

【ロック済パターン\_0849b9a67e72024819745a9889898853】
Dodo Payments MCP サーバーの設定を追加します:

コード プレースホルダー\_712b4ef4dd61616b\_END

【ロック済パターン\_640d0b31f6faa54914d25c81f5dbf413】

【ロック済パターン\_43be57c73e24741f16da5f79d5398749】
VS Code ウィンドウを再読み込み ( \[INSERT] > "Windowを再読み込み")して MCP サーバー接続を有効にします。
【ロック済パターン\_640d0b31f6faa54914d25c81f5dbf413】
【ロック済パターン\_a01a451f7aba1a80f0af7148df811dfc】
【ロック済パターン\_78e639af1281cd283655f496a1d1405c】

【ロック済パターン\_451e6857150052529899b42238b46953】
Zed に Dodo Payments MCP サーバーを設定し、会話形式の支払いデータへのアクセスを可能にします。
【ロック済パターン\_bd2642ca094c2e4ce733f0386172be2d】
【ロック済パターン\_a48799001554eb7ef4b2ac1e56fab915】
**設定** > **アシスタント** > **モデル構文プロトコル** にナビゲートしてください。
【ロック済パターン\_640d0b31f6faa54914d25c81f5dbf413】

【ロック済パターン\_b62f78a8bb37ff0ea4a9a60d555a640c】
次の設定を追加します:

コード プレースホルダー\_712b4ef4dd61616b\_END

【ロック済パターン\_640d0b31f6faa54914d25c81f5dbf413】

【ロック済パターン\_b1c8821108a3bf0ac4028a0196176d66】
設定を保存します。MCP サーバーは Zed の AI アシスタントで利用できるようになります。
【ロック済パターン\_640d0b31f6faa54914d25c81f5dbf413】
【ロック済パターン\_a01a451f7aba1a80f0af7148df811dfc】
【ロック済パターン\_78e639af1281cd283655f496a1d1405c】

【ロック済パターン\_71257692833d303ebb288457e9ce7134】
他の MCP 対応クライアントで Dodo Payments MCP サーバーを設定してください。

**リモートサーバー (推奨)**

コード プレースホルダー\_415eb83919874446\_END

**ローカル NPX**

コード プレースホルダー\_2956c5199bf91c90\_END

【ロック済パターン\_6fa96040307d68e9fa44436559d63ee8】
[modelcontextprotocol.io/clients](https://modelcontextprotocol.io/clients) を訪問して、MCP対応クライアントの完全なリストとその設定方法を確認してください。
【ロック済パターン\_07427f62e4e59df6149fbd24d60de439】
【ロック済パターン\_78e639af1281cd283655f496a1d1405c】
【ロック済パターン\_0c2288c06aada9f019d2bafea4e5f3fb】

## 環境変数

環境変数を使用して 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](https://blog.cloudflare.com/code-mode/)
【ロック済パターン\_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メソッドのみ。

### すべてのAPIサイズにスケール

APIが拡大するにつれて、従来のMCPの性能は低下します。 Code ModeはAPIの広さに関係なく2つのツールで一定です。Cloudflareは2,500以上のAPIエンドポイントをわずか2つのツールと約1,000の文脈トークンに縮小することに成功しました。

【ロック済パターン\_6fa96040307d68e9fa44436559d63ee8】
このアーキテクチャの利点についての詳細は、[Anthropic](https://www.anthropic.com/engineering/advanced-tool-use) や [Cloudflare](https://blog.cloudflare.com/code-mode/) のエンジニアリングブログ、[Programmatic Tool Calling](https://platform.claude.com/docs/en/agents-and-tools/tool-use/programmatic-tool-calling) のClaudeのドキュメントを参照してください。
【ロック済パターン\_07427f62e4e59df6149fbd24d60de439】

## リソース

【ロック済パターン\_bd3b9ce11ef978f59c6eb5461169b62d】
【ロック済パターン\_4325afcb089e351f99ef591b38203ac2】
Dodo Payments API ドキュメントを完全に探検してください
【ロック済パターン\_4ceaf3811b39bde3b7bfedbcf0487a0b】

【ロック済パターン\_1cbca36bdeb2bbbc77032220bd30c277】
モデル文脈プロトコル規格についてもっと学ぶ
【ロック済パターン\_4ceaf3811b39bde3b7bfedbcf0487a0b】

【ロック済パターン\_02488b19a875a7c4cd24c2f5651e4831】
MCP サーバーのソースコードを表示し、貢献する
【ロック済パターン\_4ceaf3811b39bde3b7bfedbcf0487a0b】

【ロック済パターン\_d4dbe77bbb87d236d98e318084853b86】
NPMからMCPサーバーをインストール
【ロック済パターン\_4ceaf3811b39bde3b7bfedbcf0487a0b】
【ロック済パターン\_639ec37665c9a30d7ddbd3a284a688a5】