觀點 · 資訊分享

Cloudflare 授權 AI 代理可以只給一半權限：Wrangler 與 API MCP 伺服器改用選填的 OAuth 範圍

Cloudflare 在 8 月 22 日宣布，Wrangler 與 Cloudflare API MCP 伺服器授權時可自行挑選要給哪些權限，必要權限仍預設勾選。讓 AI 代理操作帳號時，可以先只給需要的。

一句話看懂：Cloudflare 的 Wrangler 指令列工具和 API MCP 伺服器，現在授權時可以自己挑要給哪些權限，不用再「全部同意」才能用。

Cloudflare 授權範圍可自選資訊圖卡：登入 Wrangler 或 API MCP 時，可挑要給哪些權限，不用全給

先用白話講：授權範圍是什麼？

你請朋友幫你去管理室領包裹。你可以把整棟大樓的萬用鑰匙交給他，也可以只給他信箱的鑰匙。後者萬一弄丟，頂多信件被拿走，不會連你家大門都開了。

網路上「用某某帳號登入」「允許這個程式存取你的資料」背後用的是 OAuth。程式向你要的每一項權限，就叫一個 scope（授權範圍）。你按下「同意」的時候，其實是在決定要把哪些鑰匙交出去。

Cloudflare 在 8 月 22 日的更新日誌宣布：Wrangler（Cloudflare 開發者平台的指令列工具）和 Cloudflare API MCP 伺服器，現在使用「選填的 OAuth 授權範圍」。

公告沒有列出「哪些權限是必要、哪些是選填」，要看授權畫面本身。

Cloudflare API MCP 伺服器是專門給 AI 代理（像 Claude、Cursor 這類工具）操作 Cloudflare 帳號用的。依官方 MCP 文件（該頁後續又更新過，以下數字是我 10 月讀到的版本）：

網址是 https://mcp.cloudflare.com/mcp，連線時會導到 Cloudflare 做 OAuth 授權並選擇權限
它涵蓋超過 2,500 個 API 端點，主要提供 search()、execute() 搜尋與呼叫 API，以及 docs() 查文件
用「Code Mode」做法，讓模型寫程式去呼叫 API，而不是把每個端點都塞給模型，文件說大約只用 1,000 個 token；全部端點都做成原生工具的話要超過 100 萬個 token

這代表 AI 代理一旦拿到授權，能做的事很多。所以「少給權限」不是小事。

Wrangler 的登入指令可以先列出所有可用的授權範圍，再自己挑。以下是目前官方 Wrangler 文件（9 月更新，不能確認 8 月 22 日當天就有）寫的用法：

# 列出所有可用的授權範圍與說明
npx wrangler login --scopes-list

# 只授予帳號與使用者的唯讀權限
npx wrangler login --scopes account:read user:read

MCP 文件提到，自動化流程（CI/CD）可以改建一個只含必要權限的 Cloudflare API Token，放在 Authorization 標頭傳給伺服器
MCP 文件也提醒，新連線請用 Streamable HTTP 的 /mcp 網址；舊的 /sse 網址只是同一個處理程式的別名，強制用 SSE 傳輸的用戶端要改

我自己在 NAS 上架服務、又常讓 AI 工具幫忙操作各種平台，最怕的就是「為了省事一路按同意」。這次的改動方向是對的：預設仍然能用，但你有機會少給。

給想讓 AI 代理動 Cloudflare 的人一個簡單原則：先給唯讀，需要寫入時再重新授權。幫客戶操作更要如此，因為你拿到的權限，等於客戶帳號被 AI 代理拿到的權限。

當然，少給權限不等於安全，AI 代理執行的指令仍要自己看過。但至少，出錯時能影響的範圍小很多。

這項改動要怎麼用？

照常用 Wrangler 登入或連線 Cloudflare API MCP 伺服器，授權畫面會有編輯權限的選項，你可以取消勾選不需要的選填權限。必要權限會維持勾選。

少給權限，之後要補怎麼辦？

官方說，如果某個指令或工具呼叫需要你先前拒絕的權限，重新授權該用戶端並補上那項權限即可。

哪些權限是必要、哪些是選填？

更新日誌沒有列出清單，請以授權畫面為準。Wrangler 文件另外提到，可以用 wrangler login --scopes-list 列出所有授權範圍與說明，但該頁後續有更新，無法確認 8 月 22 日當天就有。

作者

接案做系統開發、網站與主機託管。觀點裡的文章都是我自己寫的,寫的是做專案時第一手遇到的事。