The Deployer

The Deployer MCP サーバー

Claude Code、Codex、Cursor、VS Code、または任意の AI コーディングエージェントが、The Deployer を使ってアプリをデプロイし、実行できるようにします。アプリをオンラインにするよう依頼すると、コードをチェックし、デプロイを妨げる問題を修正して、プロジェクトを作成し、環境変数を設定します。ホスティングプランと月額費用を提示し、あなたが承認すると、あなた自身のクラウドにアプリを起動します。その後、デプロイの状況を確認し、失敗した場合は修正します。さらに、再デプロイ、ドメインの追加、スケール変更、起動と停止のスケジュール設定、データベースの接続なども行えます。

The Deployer は、あなた自身の DigitalOcean、AWS、Google Cloud、Azure のアカウント、またはあなた自身のサーバー上でアプリを実行するため、クラウド料金はクラウドプロバイダーからあなたに直接請求されます。

ツール

ツール	機能	キー
guide	エージェント向けの The Deployer のプレイブック。デプロイの手順、必要なコード、失敗時の修正方法を説明します	不要
check_repo	公開リポジトリをデプロイできるかを確認します。検出した内容、不足しているもの、各クラウドでの費用を提示します	不要
plan_deploy	チェック結果に加えて、接続済みのアカウントとプロジェクト、次に行う手順を提示します	任意
account	接続済みのクラウドとコードホスト、ワークスペース、キーでできる操作を表示します	任意
status	プロジェクト、公開中のアドレス、最新のデプロイを表示します	任意
project	1 つのプロジェクトの詳細と、次に行うべき手順を表示します	任意
deployment	デプロイの状況、待機中の内容、失敗時に修正すべき内容を表示します	任意
logs	シークレットを除いたデプロイのログを表示します	任意
diagnose	稼働中のサーバーで、コンテナ、アプリのログ、メモリ、ディスクを読み取り専用でチェックします	任意
redeploy	稼働中のプロジェクトのブランチから最新のコードを取得し、再起動します	任意
create_project	リポジトリからプロジェクトを作成し、コードを読み取ります	操作
set_env	環境変数を設定します。値が再表示されることはありません	操作
launch	プランと費用を提示し、あなたの承認後に起動します	操作
api_catalog / api_schema / api	その他すべての操作：ドメイン、スケーリング、スケジュール、データベース、アクセス、環境、ブループリント、サーバー、移行	読み取り：任意。変更：操作
request_done_for_you	代行での Launch または Move を依頼します。注文は The Deployer で完了します	任意

キーを作成するには、The Deployer にサインインし、Profile を開いて、API keys and AI coding tools を選択します。エージェントにプロジェクトのセットアップと実行を許可するには Operate を選択し、それ以外の場合は Look and redeploy を選択します。このページには、キーが入力済みのこれらの設定方法も表示されます。

キーを使ってエージェントが行うことのできない操作：クラウドや Git の認証情報、環境変数の値の閲覧、請求、チーム、アカウントの変更、プロジェクト、データベース、サーバーの削除、キーの作成。費用が発生する操作は、あなたの承認を待ってから実行されます。

セットアップ

ホスト型サーバーでは、何もインストールする必要はありません。dpl_your_key をご自身のキーに置き換えてください。

コミットするファイルにキーを含めないでください。ユーザーレベルの設定に保存するか、プロジェクトファイル向けの以下の例のように、ツールが環境変数またはプロンプトから読み取るようにしてください。

Claude Code：すべてのプロジェクトで使用する場合（~/.claude.json に保存）：

claude mcp add --transport http --scope user thedeployer https://app.thedploy.com/api/v1/mcp --header "Authorization: Bearer dpl_your_key"

プロジェクトの .mcp.json でサーバーを共有するには、ヘッダーに "Authorization": "Bearer ${THEDEPLOYER_API_KEY}" を使用してください。Claude Code は、各ユーザーの THEDEPLOYER_API_KEY 環境変数から値を設定します。

Codex：~/.codex/config.toml に設定します。

[mcp_servers.thedeployer]
command = "npx"
args = ["-y", "thedeployer-mcp"]
env = { THEDEPLOYER_API_KEY = "dpl_your_key" }

Cursor：~/.cursor/mcp.json に設定します。

{
  "mcpServers": {
    "thedeployer": {
      "url": "https://app.thedploy.com/api/v1/mcp",
      "headers": { "Authorization": "Bearer dpl_your_key" }
    }
  }
}

プロジェクトの .cursor/mcp.json では、代わりに "Authorization": "Bearer ${env:THEDEPLOYER_API_KEY}" を使用し、Cursor が環境変数からキーを読み取るようにしてください。

VS Code：.vscode/mcp.json に設定します。初回にキーの入力を求められ、安全に保存されます。

{
  "inputs": [
    { "type": "promptString", "id": "thedeployer-key", "description": "The Deployer API key", "password": true }
  ],
  "servers": {
    "thedeployer": {
      "type": "http",
      "url": "https://app.thedploy.com/api/v1/mcp",
      "headers": { "Authorization": "Bearer ${input:thedeployer-key}" }
    }
  }
}

ユーザー設定でも同じように使えます（MCP: Open User Configuration を実行してください）。

Gemini CLI：~/.gemini/settings.json に設定します。

{
  "mcpServers": {
    "thedeployer": {
      "httpUrl": "https://app.thedploy.com/api/v1/mcp",
      "headers": { "Authorization": "Bearer dpl_your_key" }
    }
  }
}

ローカルコマンドを起動するツール（Cline、Windsurf など）では、Node.js 18 以降が必要なこのパッケージを使用します。ツールのユーザーレベルの MCP 設定に追加してください。

{
  "mcpServers": {
    "thedeployer": {
      "command": "npx",
      "args": ["-y", "thedeployer-mcp"],
      "env": { "THEDEPLOYER_API_KEY": "dpl_your_key" }
    }
  }
}

ツールの設定形式が異なる場合は、MCP のドキュメントで同等の項目を確認してください。Authorization ヘッダー付きの URL、または環境変数を指定したコマンドを使用します。

プロキシと社内ネットワーク

ホスト型サーバーでは、AI ツールが接続を行うため、ツール独自のプロキシ設定が適用されます。

このパッケージは Node.js を使用しており、設定を有効にしない限り HTTPS_PROXY を無視します。Node.js 22.21 以降、または 24.0 以降では、隣に NODE_USE_ENV_PROXY を追加してください。（--use-env-proxy フラグでも同様に設定できます。Node.js 22.21 または 24.5 以降が必要です。）それより古いバージョンでは、このパッケージはプロキシ経由で接続できません。

ネットワークで独自の証明書を使って HTTPS を検査する場合は、NODE_EXTRA_CA_CERTS にその証明書ファイル（PEM）を指定してください。

"env": {
  "THEDEPLOYER_API_KEY": "dpl_your_key",
  "HTTPS_PROXY": "http://proxy.example.com:8080",
  "NODE_USE_ENV_PROXY": "1",
  "NODE_EXTRA_CA_CERTS": "/path/to/company-ca.pem"
}

キーでできること、できないこと

キーを使えるのは The Deployer の MCP サーバーと、そのツール（check_repo、plan_deploy、status、（シークレットを削除した）logs、redeploy、request_done_for_you）のみです。クラウドや git の認証情報、環境変数、請求情報、アカウント設定にはアクセスできず、キーを追加作成することもできません。The Deployer はキーのハッシュのみを保存します。キーはいつでも Profile ページから無効化できます。残りのキーに影響を与えずに無効化できるよう、ツールまたはマシンごとにキーを使ってください。パスワードを変更またはリセットすると、すべてのキーが無効になります。

redeploy は稼働中のアプリを変更します。redeploy の実行を自動承認せず、ツールが実行前に確認するようにしてください。

ツールの回答は、リポジトリとデプロイから取得されます。エージェントが読む他のテキストと同じように扱ってください。

このパッケージの仕組み

index.mjs は依存関係のないブリッジです。標準入力から MCP メッセージを読み取り、それぞれをキーとともに HTTPS 経由で The Deployer のホスト型エンドポイントに送信し、回答を標準出力に書き込みます。ツールは The Deployer 上で実行されるため、ツール側が変更されてもこのパッケージは変わりません。

すべてのリクエストに回答が返されます。The Deployer がリクエストを拒否した場合や到達できない場合は、キーが無効化されている、タイムアウトしたなど、理由を示すエラーが回答として返されます。ブリッジはリダイレクトを追跡せず、キーを Authorization ヘッダー以外の場所に設定することもありません。

変数	意味
THEDEPLOYER_API_KEY	個人用 API キーです。設定しない場合、使用できるのは check_repo のみです
THEDEPLOYER_MCP_URL	https://app.thedploy.com/api/v1/mcp 以外のエンドポイントです。このコンピューター上（127.0.0.1、::1、または localhost）を除き、https:// を使用する必要があります
THEDEPLOYER_TIMEOUT_MS	1 回の回答を待つ時間をミリ秒で指定します。範囲は 1000～600000 で、デフォルトは 200000 です

npm test

ライセンス

MIT