Mcp Server

Dodo Payments TypeScript MCP サーバー

インストール

直接実行

npx を使って MCP サーバーを直接実行できます。

export DODO_PAYMENTS_API_KEY="My Bearer Token"
export DODO_PAYMENTS_WEBHOOK_KEY="My Webhook Key"
export DODO_PAYMENTS_ENVIRONMENT="live_mode"
npx -y dodopayments-mcp@latest

MCP クライアント経由

既存のクライアントの一覧の一部は、modelcontextprotocol.io にあります。すでに クライアントをお持ちの場合は、MCP サーバーのインストール方法について、クライアントのドキュメントをご確認ください。

設定用 JSON があるクライアントでは、次のような設定になります。

{
  "mcpServers": {
    "dodopayments_api": {
      "command": "npx",
      "args": ["-y", "dodopayments-mcp"],
      "env": {
        "DODO_PAYMENTS_API_KEY": "My Bearer Token",
        "DODO_PAYMENTS_WEBHOOK_KEY": "My Webhook Key",
        "DODO_PAYMENTS_ENVIRONMENT": "live_mode"
      }
    }
  }
}

Cursor

Cursor をお使いの場合は、下のボタンを使って MCP サーバーをインストールできます。環境変数は、Cursor Settings > Tools & MCP > New MCP Server にある Cursor の mcp.json で設定する必要があります。

VS Code

MCP をお使いの場合は、下のリンクをクリックして MCP サーバーをインストールできます。環境変数は、Command Palette > MCP: Open User Configuration から開ける VS Code の mcp.json で設定する必要があります。

VS Code を開く

Claude Code

Claude Code をお使いの場合は、ターミナルで下のコマンドを実行して MCP サーバーをインストールできます。環境変数は、ホームディレクトリにある Claude Code の .claude.json で設定する必要があります。

claude mcp add dodopayments_mcp_api --env DODO_PAYMENTS_API_KEY="My Bearer Token" DODO_PAYMENTS_WEBHOOK_KEY="My Webhook Key" -- npx -y dodopayments-mcp

コードモード

この MCP サーバーは、「Code Mode」ツールスキームに基づいて構築されています。この MCP サーバーでは、 エージェントが TypeScript SDK を使ってコードを記述し、そのコードが 分離されたサンドボックス内で実行されます。これを実現するため、サーバーはエージェントに次の 2 つのツールを公開します。

• 1 つ目のツールはドキュメント検索ツールで、API／SDK のドキュメントを 検索するために使用できます。

• 2 つ目のツールはコードツールで、エージェントは TypeScript SDK を使ってコードを記述できます。 コードは、Web やファイルシステムにアクセスできないサンドボックス環境で実行されます。その後、 コードが返す、または出力する内容はすべて、ツール呼び出しの結果として エージェントに返されます。

このスキームを使うことで、エージェントは非常に複雑なタスクを決定論的かつ 再現可能な方法で実行できます。

コードツールの要件

execute ツールはローカルの Deno サンドボックスでコードを実行するため、Deno が利用可能である必要があります。サーバーは次の順序で Deno を探します。

1. PATH 上の deno バイナリ。
2. このパッケージと同じ node_modules ツリーにインストールされている場合は、deno npm package の deno バイナリ。

どちらも見つからない場合、execute ツールはエラーを返しますが、ドキュメント検索を含むその他すべてのツールは引き続き動作します。

メモ

サーバーを npx で起動する場合、またはグローバルにインストールする場合、サーバーはプロジェクトではなく独自のキャッシュディレクトリから解決されるため、手順 2 は適用されません。npx -y dodopayments-mcp が最も一般的な起動方法であるため、PATH に Deno をインストールすることを推奨します。

警告

現時点では Deno 2.8 以前を使用してください。Deno 2.9 以降では、ワーカーの Unix ソケットへのバインドに --allow-net 権限が必要になりましたが、ワーカーにはその権限が付与されないため、サンドボックスの起動に失敗します。なお、現在 npm install deno でインストールされるのは、この影響を受けるバージョンです。#330 で追跡されています。

重要

ローカルでのコード実行は macOS と Linux のみでサポートされています。サンドボックスは Unix ドメインソケットを介して Deno サブプロセスと通信しますが、Windows で実行中の Deno はそのソケットをリッスンできないため、Windows では動作しません（denoland/deno#18236 を参照）。Deno をインストールしても、この制限は変わりません。Windows では、WSL2 上でサーバーを実行するか、REST API または dodopayments SDK を直接呼び出してください。

リモートでの実行

--transport=http を指定してクライアントを起動すると、Streamable HTTP トランスポートを使用するリモートサーバーとしてサーバーが起動します。--port 設定で実行するポートを指定でき、--socket 設定を使うと Unix ソケットで実行できます。

認証には、Bearer スキームを使用して Authorization ヘッダーを指定できます。

また、次のヘッダーを使用して認証することもできます。

ヘッダー	対応するクライアントオプション	セキュリティスキーム
x-dodo-payments-api-key	bearerToken	API_KEY

サーバーが http://localhost:3000 でホストされている場合、このサーバーの設定 JSON は次のようになります。

{
  "mcpServers": {
    "dodopayments_api": {
      "url": "http://localhost:3000",
      "headers": {
        "Authorization": "Bearer <auth value>"
      }
    }
  }
}