Cloudways MCP：Access Token 權限、連接 Claude 與 Cursor，用 AI 管理伺服器
將 Cloudways MCP 連接到 Claude Code，完成了用唯讀 Access Token 透過對話查詢 Cloudways 伺服器的設定。因為名稱的關係，很容易誤以為要在 Cloudways 伺服器上安裝東西，實際上要新增設定的地方是 AI 程式端的設定檔。
用同一個 Token 查詢了伺服器清單、服務狀態與 CPU 用量，也確認了清除快取會因權限錯誤被拒絕。
1️⃣ Cloudways MCP 的運作方式
Cloudways MCP 是讓 Claude、Cursor、ChatGPT 等 AI 程式代替你呼叫 Cloudways API 的連接伺服器，提供給所有 Cloudways 客戶，不另外收費。
架構分成三個部分。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 也不會接受要求。Token 是在 Cloudways 右上角個人資料選單的 [API Integration] 中建立。
按下 [Create Access Token] 後，會開啟設定名稱、到期期限與權限範圍的視窗，接著在視窗中繼續。
權限範圍（Scope）有三種，預設值是 [Limited Access(Beta)]。[Read-Only Access] 只能查詢伺服器狀態、應用程式設定與用量，不能建立、變更或刪除；[Full Access] 可以使用帳號權限內的所有 API。[Limited Access] 只允許所選的功能。
第一次連接時先用 [Read-Only Access]。[Read-Only Access] 沒有誤刪的風險，但如果要讓 AI 執行清除快取或備份這類操作，就必須用 [Limited Access] 只開放那項功能。
到期期限可以從 1 天選到永不到期，測試時用的是 1 個月。
Token 值只會在建立時顯示一次，關閉視窗後就看不到，只能撤銷（Revoke）後重新建立，所以要在頁面上先把 Token 值複製下來。
舊的 API Key 方式將在 2026 年 10 月中旬結束，所以用 API Key 連接的 MCP 也要改成 Access Token。
3️⃣ Claude · Cursor · VS Code 連線設定
建立 Token 後，在新增到 AI 程式之前還不能在對話中使用。Claude Code 直接支援遠端 HTTP MCP，一行指令就能新增。這次是在另一台安裝並使用 Claude Code 的 Linux 伺服器（不是 Cloudways 伺服器）的終端機執行。
claude mcp add --transport http --header "X-Access-Token: YOUR_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）。Token 只填以 [cw_] 開頭的值，如果連說明文字中的角括號（< >）一起填入，就不會被辨識為 Token。
用 [-s user] 新增的話，不論在哪個資料夾執行 claude 都看得到 Cloudways 工具；[-s local] 則只有在執行新增指令的資料夾中執行時才看得到。一開始在工作資料夾以 local 新增，但從其他資料夾執行時看不到工具，所以改成了 user。
即使以 user 新增，Claude Code 也只會先載入工具名稱，使用時才載入說明，所以和 local 相比，token 用量沒有太大差別。
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] 填入相同的網址與 Token。
Cursor、VS Code 等其他 AI 程式，也是在設定檔中填入相同的網址與 Token，各程式的格式請依照 Cloudways 說明中心 的說明。
4️⃣ 可以用提示詞執行的工作
在以 Read-Only Token 連接的狀態下，依序要求了伺服器清單、伺服器詳細資料、服務狀態、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 分鐘 1 筆共 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 要求什麼都會被執行，但能執行的範圍由 Token 權限決定。要求清除快取時，[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] 則表示 Token 輸入錯誤，或是已撤銷、已過期的 Token。
要更換 Token 時，用 [claude mcp remove cloudways -s user] 刪除新增的設定後，再用新 Token 重新新增；如果終端機中無法執行 [claude] 指令，就用完整路徑指定 Claude Code 執行檔來執行。
很容易以為關閉視窗再打開，工具清單也會跟著重新整理，但 Claude Desktop、Cursor 這類程式會保存第一次連接時的工具清單，關閉視窗後也仍在系統匣中執行。Cloudways 新增工具後如果看不到新工具，請在設定中停用 cloudways 連線再重新啟用，或完全結束程式（macOS 按 Cmd+Q，Windows 從系統匣圖示結束）後重新執行。
🔢 FAQ & 推薦內容
ℹ️ 聯盟行銷說明
本站內容包含聯盟行銷連結。訪客透過這些連結購買商品或服務時，本站會從賣家獲得佣金。在這個過程中，購買者支付的金額（遇到活動折扣時金額會降低↓）並不會因此提高。刊登的價格、折扣與庫存資訊以撰寫當時為準，可能與實際情況不同，購買前請向賣家做最後確認。商品的挑選與評價依本站自訂的標準撰寫，是否支付佣金不會影響介紹順序或評價內容。