Cloudways MCP：Access Tokenの権限とClaude・Cursorの接続、AIでサーバー管理
Cloudways MCPをClaude Codeに接続し、読み取り専用のAccess TokenでCloudwaysサーバーを会話で照会する設定を終えました。名前からCloudwaysサーバーに何かをインストールするものと誤解しがちですが、実際に登録するのはAIプログラム側の設定ファイルです。
同じトークンでサーバー一覧とサービス状態、CPU使用量を照会し、キャッシュのクリアは権限エラーで拒否されることまで確認しました。
1️⃣ Cloudways MCPの仕組み
Cloudways MCPは、Claude・Cursor・ChatGPTのようなAIプログラムがCloudways APIを代わりに呼び出せるようにする接続サーバーで、すべてのCloudwaysの顧客に追加料金なしで提供されます。
構成は3か所に分かれます。AIプログラム（MCPクライアント）がリクエストを受けて使うツールを選び、Cloudwaysが運営するリモートMCPサーバー（mcp.cloudways.com）がそのリクエストをCloudways APIの呼び出しに変換して実行します。管理対象のCloudwaysサーバーには何もインストールしません。
登録はClaude Codeがインストールされたコンピューターで行い、Windows PCでも可能です。今回はCloudwaysサーバーではなく、Claude Codeをインストールして利用している別のLinuxサーバーで行いました。
ツールは250個を超えますが、AIプログラムに最初に見えるのは66個です。残りはリクエスト時に探して実行するため、別途設定することはありません。
2️⃣ Access Tokenの発行と権限範囲
MCPのアドレスを登録しても、Access TokenがなければCloudwaysはリクエストを受け付けません。トークンはCloudways右上のプロフィールメニューの [API Integration]で作成します。
[Create Access Token]を押すと、名前・有効期限・権限範囲を決める画面が開くので、続けて進めます。
権限範囲（Scope）は3種類で、初期値は[Limited Access(Beta)]です。[Read-Only Access]はサーバーの状態・アプリケーション設定・使用量を照会するだけで作成・変更・削除はできず、[Full Access]はアカウント権限内のすべてのAPIを使います。[Limited Access]は選んだ機能だけを許可します。
最初に接続するときは[Read-Only Access]から始めます。[Read-Only Access]は誤って削除する危険がありませんが、キャッシュのクリアやバックアップのように何かを実行させるには、[Limited Access]でその機能だけを開く必要があります。
有効期限は1日から無期限まで選べ、テストでは1か月を使いました。
トークンの値は作成時に一度だけ表示され、画面を閉じると再表示できず、失効（Revoke）させて作り直す必要があるため、ページ内でトークンの値を先にコピーします。
従来のAPI Key方式は2026年10月中旬に終了するため、API Keyで接続しているMCPもAccess Tokenに切り替える必要があります。
3️⃣ Claude・Cursor・VS Codeの接続設定
トークンを作っても、AIプログラムに登録するまでは会話で使えません。Claude CodeはリモートHTTP MCPに直接対応しており、コマンド1行で登録します。今回はClaude Codeをインストールして利用している別のLinuxサーバー（Cloudwaysサーバーではない）のターミナルで実行しました。
claude mcp add --transport http --header "X-Access-Token: トークン" --header "X-Mcp-Host: claude-code" -s user cloudways https://mcp.cloudways.com/mcp/コマンドの[cloudways]は登録名で、[X-Access-Token]には発行したAccess Tokenを、[X-Mcp-Host]には使うAIプログラムの名前（claude-code）を入れます。トークンは[cw_]で始まる値だけを入れ、案内文の山かっこ（< >）まで一緒に入れるとトークンとして認識されません。
[-s user]で登録すると、どのフォルダーでclaudeを実行してもCloudwaysのツールが表示され、[-s local]はコマンドを実行したフォルダーで実行したときだけ表示されます。最初は作業フォルダーにlocalで登録しましたが、別のフォルダーで実行するとツールが表示されなかったため、userに変更しました。
userで登録しても、Claude Codeはツール名だけを先に読み込み、説明は使うときに読み込むため、localと比べてトークン使用量に大きな差はありません。
claude mcp list
cloudways: https://mcp.cloudways.com/mcp/ (HTTP) - ✔ Connected[claude mcp list]を実行して[cloudways]の行末に[Connected]が表示されれば接続済みです。登録した直後に今の会話で使えるわけではありません。MCPツールはセッション開始時に読み込まれるため、新しく開いたセッションからCloudwaysのツールが表示されます。
登録情報はClaude Codeの設定ファイルであるホームフォルダーの[.claude.json]に保存され、Linuxのrootアカウントなら[/root/.claude.json]です。userはこのファイル最上部の[mcpServers]に、localは[projects]の下の該当フォルダーのパスに記録されます。WindowsのClaude Desktopは[%APPDATA%\Claude\claude_desktop_config.json]に同じアドレスとトークンを入れます。
Cursor・VS CodeのようなほかのAIプログラムも設定ファイルに同じアドレスとトークンを入れ、プログラムごとの形式は Cloudwaysヘルプセンター の案内に従います。
4️⃣ プロンプトで実行できる作業
Read-Onlyトークンで接続した状態で、サーバー一覧、サーバー詳細、サービス状態、CPU使用量、アプリケーション一覧、SSL証明書の状態を順に依頼し、照会のリクエストはすべて結果を受け取りました。下の応答時間はCloudways MCPサーバーが結果を返した時間で、AIが回答をまとめる時間は含みません。
| リクエスト | 実行されるツール | 応答時間 | 応答内容 |
|---|---|---|---|
| サーバー一覧を見せて | server_list | 0.72秒 | サーバー1台、実行中（running）、Vultrソウルリージョン、1GB、MariaDB 10.11 |
| サーバーの詳細を教えて | server_get | 0.68秒 | Debian 12、ディスク25GB、インストール済みアプリケーション1個（WordPress） |
| サービスの状態を確認して | service_status | 5.10秒 | 実行中8個（Nginx・Apache・MySQL・PHP 8.2-FPM・Redis・Varnish・Memcached・Imunify360）、停止1個（New Relic） |
| 直近24時間のCPU使用量 | monitoring_server_graph | 1.75秒 | 5分間隔の値288個、平均使用率約13%、最高約30% |
| アプリケーション一覧を見せて | app_list | 0.67秒 | WordPress 1個、接続ドメイン cw.testpilotweb.com |
| SSL証明書の状態を確認して | app_get | 3.04秒 | Let's Encryptのインストール・確認完了、自動更新を使用 |
| キャッシュをクリアして | app_purge_cache | 0.42秒 | 実行拒否 — 403 insufficient_scope |
CPU使用量はアイドルCPU（Idle CPU）の比率で返り、平均86.8%は使用率約13%にあたります。SSLの状態を照会する専用ツールはないため、アプリケーション詳細（[app_get]）のLet’s Encrypt項目で確認しました。
AIに頼めば何でも実行されそうですが、実行範囲を決めるのはトークンの権限です。キャッシュのクリアを依頼した結果、[app_purge_cache]ツールは実行されましたが、Cloudwaysは[Cloudways API error (403): This token does not have access to this endpoint — insufficient_scope]エラーで拒否しました。
どのツールが書き込み作業かは、[get_write_tools]ツールが返す一覧で確認できます。
5️⃣ 接続エラーとツール一覧の更新
接続できないときは、[claude mcp list]で[cloudways]の行が[Connected]かどうかから確認します。アドレスが[https://mcp.cloudways.com/mcp/]と末尾のスラッシュまで一致しないとエラーメッセージなしで接続されず、[401 Unauthorized]が出たらトークンの入力ミスか、失効・期限切れのトークンです。
トークンを替えるときは[claude mcp remove cloudways -s user]で登録を削除してから新しいトークンで再登録し、ターミナルで[claude]コマンドが実行できなければClaude Codeの実行ファイルをフルパスで指定して実行します。
ウィンドウを閉じて開き直せばツール一覧も更新されると考えがちですが、Claude Desktop・Cursorのようなプログラムは最初に接続したときのツール一覧を保存しており、ウィンドウを閉じてもトレイで動き続けます。Cloudwaysがツールを追加した後に新しいツールが表示されなければ、設定でcloudwaysの接続を無効にしてから再び有効にするか、プログラムを完全に終了（macOSはCmd+Q、Windowsはトレイアイコンの終了）してから再起動します。
🔢 FAQ & おすすめコンテンツ
ℹ️ 提携について
当サイトのコンテンツにはアフィリエイトリンクが含まれています。訪問者がこのリンクを通じて商品やサービスを購入すると、当サイトは販売元から手数料を受け取ります。この過程において、購入者が支払う金額（イベント割引適用で金額が下がります↓）は上昇しません。掲載されている価格・割引・在庫情報は作成時点のものであり、実際とは異なる場合がありますので、ご購入前に販売元にて最終確認をお願いいたします。商品の選定および評価は独自の基準に基づいて行われており、手数料の支払いの有無は紹介順や評価内容に影響を与えません。