Dockhold MCP Server認証済み注目

Dockhold MCP Server とは？

Dockhold MCP Server は、アプリホスティングプラットフォーム Dockhold の公式 MCP サーバーです。Claude Code、Cursor、VS Code などの AI コーディングツールから、現在のフォルダや GitHub リポジトリを公開 HTTPS URL にデプロイし、ステータスやログの確認、変数の設定、アプリやマネージドデータベースのサイズ変更ができます。

一度インストールしてブラウザで一度サインインすれば、あとはツールに「put this online」と伝えるだけです。ローカルのインストール方法はすべて同じコマンド npx -y dockhold mcp を実行し、Dockhold CLI がマシンに保存したサインインを使って各リクエストを Dockhold に転送します。エディタの設定に機密情報は入りません。ローカルコマンドを起動できないクライアント向けに、同じツールが https://api.dockhold.eu/mcp でもリモート提供されており、ダッシュボードの API トークンで認証します。公式 MCP レジストリには eu.dockhold/dockhold として掲載されています。

Dockhold MCP Server の使い方

Node.js 18 以降（npx 用）と Dockhold アカウントが必要です。app.dockhold.eu で登録でき、無料プランはカード不要です。

Claude Code

Claude Code 内で次の 2 つのコマンドを実行します。

/plugin marketplace add dockhold/mcp
/plugin install dockhold@dockhold

MCP サーバーと deploy スキル（/dockhold:deploy）がインストールされます。スキルは事前チェック、サインイン、デプロイ、ビルド失敗時の対処という一連の流れを把握しています。

Cursor

README の「Add to Cursor」ボタンを使うか、~/.cursor/mcp.json（全プロジェクト）または .cursor/mcp.json（1 プロジェクト）に次を追加します。

{
  "mcpServers": {
    "dockhold": {
      "command": "npx",
      "args": ["-y", "dockhold", "mcp"],
      "env": { "DOCKHOLD_REF": "cursor" }
    }
  }
}

VS Code

code --add-mcp '{"name":"dockhold","command":"npx","args":["-y","dockhold","mcp"],"env":{"DOCKHOLD_REF":"vscode"}}'

Codex と Gemini CLI

codex mcp add dockhold --env DOCKHOLD_REF=codex -- npx -y dockhold mcp
gemini mcp add -e DOCKHOLD_REF=gemini dockhold npx -y dockhold mcp

Claude Desktop、Windsurf、その他のクライアント

コマンドを起動できるクライアントなら、MCP 設定に同じブロックを使えます（Windsurf は ~/.codeium/windsurf/mcp_config.json を読み込みます）。

{
  "mcpServers": {
    "dockhold": {
      "command": "npx",
      "args": ["-y", "dockhold", "mcp"]
    }
  }
}

DOCKHOLD_REF は任意で、どのツールから来たかを Dockhold に伝えるだけのものです。

サインイン

ツールが初めてアカウントを必要としたとき、ターミナルで次を実行するよう案内されます。

npx dockhold login

ブラウザのタブが開くので承認します。サインインは 90 日間有効で、エディタの設定ではなくマシン上に保存され、CLI とすべてのクライアントで共有されます。

リモートサーバー

HTTP でしか接続できないクライアントでは、Dockhold ダッシュボードの Settings → API tokens でトークン（読み取り専用、読み取り+デプロイ、または secrets 付き）を作成し、bearer として渡します。

claude mcp add --transport http dockhold https://api.dockhold.eu/mcp --header "Authorization: Bearer YOUR_DOCKHOLD_API_TOKEN"

これは設定ファイルにトークンが入る唯一の方法なので、そのファイルはバージョン管理に含めないでください。

Dockhold MCP Server の主な機能

• すべてのクライアントで同じローカルコマンドを使い、エディタの設定にトークンを貼る必要がありません。
• ブラウザでのサインインは Dockhold CLI と共有され、90 日間有効です。
• ローカルフォルダは CLI 経由でデプロイされ GitHub アカウントは不要、GitHub リポジトリは deploy_app ツールでデプロイされます。
• チャットからログやステータスを確認し、変数、メモリ、データベース、ストレージを変更できます。
• デプロイ全体の流れを扱う deploy スキル付きの Claude Code プラグインがあります。
• secrets スコープを含む、スコープ付きダッシュボードトークンで使える任意のリモートエンドポイントがあります。
• ツールができるのは、自分のアプリに対してプランの範囲内で、ダッシュボードでできることだけです。

Dockhold MCP Server のツール

• 読み取り：list_apps、get_app_status（デプロイ状況、URL、最新コミット、エラー）、get_app_logs、get_resource_usage（コンピュート、データベースメモリ、ストレージのプール）、そしてプライベートリポジトリのデプロイに必要な github_installation_id を返す list_github_repos。
• デプロイ：deploy_app は GitHub リポジトリを公開 Web アプリとしてデプロイし、deploy_group は連携する複数のサービスをまとめてデプロイし、redeploy_app はダウンタイムなしで再起動します。
• 設定：set_app_variable と unset_app_variable は機密でない環境変数を変更して反映します。
• サイズとストレージ：resize_app、resize_database、resize_database_storage、set_app_storage、remove_app_storage。remove_app_storage はファイルを消去する前に確認を求めます。
• シークレット（リモートのみ）：secrets スコープ付きのダッシュボードトークンで set_app_secret、unset_app_secret、bind_app_secret、list_secrets、list_app_secrets が使えるようになります。ブラウザでのサインインにはこのスコープは付きません。

Dockhold MCP Server のユースケース

• 初めてのデプロイ：「Put this online.」ツールがプロジェクトを確認し、必要ならサインインを促し、デプロイして公開 URL を伝えます。
• デバッグ：「recipe-box のログを見せて、前回のデプロイが失敗した理由を教えて。」
• プライベートリポジトリ：「GitHub のプライベートリポジトリ api-server をデプロイして。」
• スケーリング：「このアプリはメモリ不足になりがちなので増やして。」
• 複数サービスのアプリ：「フロントエンドと API をまとめてデプロイしてつないで。」

Dockhold MCP Server のトラブルシューティング

• サーバーの起動中にクライアントが待ちきれない：初回の npx -y dockhold のダウンロードが遅すぎることがあります。npm i -g dockhold で CLI を一度インストールし、コマンドを dockhold、引数を ["mcp"] にします。
• ツールがサインインしていないと言う：npx dockhold login を実行します。ツールは再起動なしで次の呼び出し時にサインインを認識します。
• デプロイはできたが応答しない：アプリは 0.0.0.0:$PORT で待ち受ける必要があります。
• プッシュしたのに再デプロイされない：URL だけでデプロイしたリポジトリは一度しかビルドされません。プッシュごとにデプロイするには、リポジトリを Dockhold に接続します。
• set_app_variable が値を拒否する：キーやパスワードに見えるものは拒否されます。シークレットはダッシュボードの Secrets セクションで追加してください。