用量限額是導入前最該先算清楚的一項,因為它會直接改變工作流的設計方式。Professional 方案是每天 200 次呼叫、每分鐘 10 次——而一次「選 frame → 取輪廓 → 取脈絡 → 截圖驗證」的完整循環就用掉 3 到 4 次。本篇把官方載明的各項限制整理出來,並指出哪些可以靠流程繞過、哪些是硬限制。
📖 用量限額
官方載明的完整數字(2026-11-01 查證):
| 方案 | Full/Dev 席次:每日 | 每分鐘 |
|---|---|---|
| Starter | 不可用 | — |
| Professional | 200 | 10 |
| Organization | 200 | 15 |
| Enterprise | 600 | 20 |
| Education | 200 | 10 |
View 與 Collab 席次:所有方案一律每月 20 次呼叫。
官方說明:每分鐘限制是額外疊加的,不是取代每日或每月限制。Figma 保留隨時調整的權利。
什麼計入、什麼不計入:
- 限額適用於從 Figma 讀取資料的工具
- 四個寫入工具不計入:
add_code_connect_map、create_new_file、generate_figma_design、whoami - 使用 Figma AI credits 的動作不計入 MCP 限額(但會消耗 credits)
兩個實際的推論:
一、「每月 20 次」等於不能用。 View 或 Collab 席次的額度只夠試玩,不要用它評估這個工具值不值得——那會得到錯誤的結論。
二、
add_code_connect_map不計入限額,所以批次建立對應是可行的。 這讓「花一個下午把整個元件庫對應起來」成為實際可執行的事,而不受每日 200 次的拖累。
每分鐘 10 次是比每日 200 次更容易撞到的那一個。 一個讓 agent 自由探索的 session 很容易在一兩分鐘內連續呼叫十幾次。這直接支持了「先 get_metadata 再針對性取用」的做法——它把探索式的多次呼叫換成一次輪廓加少數幾次精確取用。
📖 方案與席次的門檻
| 功能 | 要求 |
|---|---|
| 本機/桌面伺服器 | Dev 或 Full 席次;Professional、Education、Organization、Government 或 Enterprise 方案 |
| Code Connect 連結 | Full 或 Dev 席次;Professional、Organization、Government 或 Enterprise 方案 |
| 寫回畫布 | 遠端伺服器;Professional 以上方案;對檔案有編輯權限;草稿之外需 Full 席次 |
| Figma Specs 寫入 | 遠端伺服器;對檔案有編輯權限 |
| Figma for Government | 只支援本機伺服器,工具受限 |
存取權仍受檔案權限約束——官方明確指出你只能使用本來就有權限的檔案。MCP 不會繞過 Figma 的權限模型。
Enterprise 的 Okta Cross App Access:官方說明企業託管的授權目前只支援 Claude 透過 Okta XAA,讓成員以 Okta 單一登入。其他 client 沒有同等支援。
📖 大型 frame
官方把它列為獨立的問題頁。症狀是 agent 拿到太多脈絡而無法處理,導致工具變慢、出錯,或回傳不完整的結果。
官方沒有給出任何 node 數量或尺寸門檻,只有定性描述。
官方建議:
- 針對較小的區段或單一元件生成——卡片、header、sidebar
- 覺得慢或卡住時,選少一點再試
- 大型設計先呼叫
get_metadata取輕量輪廓,再針對需要的部分取完整脈絡
「回傳不完整的結果」是三種症狀裡最危險的一種——慢和出錯會讓你知道有問題,不完整的結果看起來像是成功的。產出少了一個區塊、或某些屬性沒帶到,要到人工審查時才會發現。
📖 寫入功能的限制
官方載明:
- 每次工具呼叫最多回傳 20 KB
use_figma無法自行加入圖片(要配合upload_assets或generate_image)- 含圖片或影片的元件匯入、建立 GIF:目前不支援
- 字型必須已上傳到 Figma 帳號——只裝在本機電腦的字型不可用
- 元件必須手動發布後才能完成 Code Connect 對應
- 產出為 beta 品質,官方自述「may need manual review and cleanup」
官方的警告:先在元件庫的複本或草稿檔測試,再動正式檔案,並保留備份。
費用:beta 期間免費,之後會變成按用量計費,價格未公布。
📖 credits 與費用
與限額分開計算的部分:
| 動作 | 費用 |
|---|---|
generate_image | 每張消耗 Figma AI credits,依影像模型而定 |
send_prompt(Figma Make 建立或修改程式碼) | 消耗 Figma AI credits |
send_code_to_figma | 首次上傳免費;後續提示與修改消耗 credits |
| Weave 工具 | 消耗 Weave credits(不是 Figma AI credits) |
官方沒有公布任何實際金額或每單位 credit 價格。
📖 忠實度的上限
三類資訊本來就不在設計檔裡,MCP 傳不過來:
互動與狀態。 設計檔通常只有靜態畫面。變體能表達部分狀態,但變體不等於行為——它不會告訴你點擊之後要做什麼、載入中怎麼處理、錯誤怎麼顯示。
響應式斷點。 auto layout 表達了部分意圖,但斷點在哪、斷點之後怎麼重排,多半要人補。官方的緩解做法是在生成前縮放 frame 確認行為,以及用註解說明。
無障礙。 設計檔很少帶這些資訊。要讓它進入產出,只能靠規則檔與 Code Connect 自訂指示,見 與前端 agent 的整合。
把這三項當成 agent 的失敗是誤判。 它們不是能力問題而是資訊問題——檔案裡沒有的東西,任何模型都變不出來。正確的反應是把它們納入人工審查範圍,或想辦法把資訊放進檔案(註解、dev resources、Code Connect 指示)。
📖 何時仍然需要人工
依確定性由高到低:
判斷設計本身好不好。 MCP 讓實作忠於設計,但完全不會告訴你那個設計是不是對的。這一項永遠是人的工作。
互動、響應式、無障礙的實作。 見上。
確認 Code Connect 沒有連到淘汰元件。 這類錯誤會穩定地產生,而且因為「看起來用了設計系統」而特別難發現。見 Code Connect。
檢查不完整的結果。 大型選取可能回傳不完整而不報錯。
決定一個東西該不該成為元件。 search_design_system 能查有沒有現成的,但「這個值得抽象化嗎」是判斷題。
寫回畫布的產出審查。 官方自述 beta 品質需要人工清理。
📖 一張風險對照
| 風險 | 可控嗎 | 怎麼控 |
|---|---|---|
| 撞到每分鐘限額 | 可 | 先 get_metadata 再針對性取用 |
| 撞到每日限額 | 部分 | 批次 Code Connect 不計入;必要時升級方案 |
| 大型 frame 回傳不完整 | 可 | 選小範圍;先取輪廓 |
| 產出沒用既有元件 | 可 | Code Connect |
| 產出硬編碼值 | 可 | 變數 + 規則檔 |
| 連到淘汰元件 | 可 | 建立對應前先確認 codebase 這一側 |
| 拿到錯誤框架 | 部分 | 提示指定;Professional 單框架限制須管理員調整 |
| 互動/響應式/無障礙缺失 | 不可 | 納入人工審查;用註解與規則補資訊 |
| 寫回畫布損壞正式檔案 | 可 | 只在複本與草稿操作;保留備份 |
| 未來寫入功能收費 | 不可 | beta 結束後重新評估 |
「不可控」那三項是選型與流程設計的輸入,不是工程問題。
🧠 重點整理
Professional 每天 200 次、每分鐘 10 次;Enterprise 每天 600 次。每分鐘限制是額外疊加的。
View/Collab 席次每月只有 20 次,等於不能用——別用它評估這個工具。
每分鐘限額比每日更容易撞到,這直接支持「先 metadata 再精確取用」。
四個寫入工具不計入限額,所以批次建立 Code Connect 對應可行。
官方沒有給大型 frame 的具體門檻,只有定性描述。
「回傳不完整」比「出錯」更危險,因為它看起來像成功。
寫入功能限制明確:20 KB、不支援含圖片影片的元件與 GIF、字型須已上傳、元件須先發布。
官方要求先在複本或草稿測試寫入功能。
寫回畫布 beta 免費,之後按用量計費,價格未公布。
互動、響應式、無障礙是資訊問題不是能力問題——檔案裡沒有就傳不過來。
MCP 不會告訴你設計是不是好的。
✍️ 動手做
算出你自己的限額預算,20 分鐘。這一步會直接影響你怎麼設計工作流:
- 呼叫
whoami,確認你的方案與席次。 - 對照上面的表,寫下你每天與每分鐘的上限。
- 跑一次完整的元件生成流程(取輪廓 → 取脈絡 → 截圖驗證),數一數實際用掉幾次呼叫。
- 用每日上限除以第 3 步的數字,得出你一天大概能做幾個元件。
- 把這個數字跟你的實際工作量比較。
第 4 步的數字常常比預期小。如果它低於你一天的實際需求,那麼「先 metadata 再精確取用」就不是優化而是必要條件——而這個結論最好在導入前就知道,不要等到某天下午被擋住才發現。
🔗 資料來源
- Figma 開發者文件 — 限額與存取——完整限額表、每分鐘疊加規則、計入與不計入的工具、credits 計費、Okta XAA、檔案權限(一手,2026-11-01 查證)。
- Figma 開發者文件 — 避免大型 frame——三種症狀與官方建議;官方未給具體門檻。
- Figma 開發者文件 — 寫回畫布——全部寫入限制、beta 警告、免費期與未來計費、方案與席次要求。
- Figma 開發者文件 — Figma MCP server——各功能的方案與席次門檻、Figma for Government。
- Figma 開發者文件 — Code Connect 整合——Code Connect 的方案要求。
- 忠實度上限的三分類、何時需人工的清單、風險對照表是我的歸納,非官方建議。