Figma MCP 是什麼?讓 Cursor 與 Claude Code 直接讀取 Design Token,告別切版走樣

還在截圖丟給 AI 寫前端卻老是對不齊嗎?本文解析 Figma MCP(Model Context Protocol)與 Code Connect 運作原理,教你讓 Cursor 與 Claude Code 直接讀取 Design Token、圖層與元件規範,實現近乎零誤差的自動化切版工作流。

Share
Figma MCP 串接 Cursor 與 Claude Code 讀取 Design Token 的自動化切版架構圖

「Figma 上按鈕明明是 #2563EB、圓角 8px,為什麼做出來變成 #3B82F6、圓角 4px?」

這句話幾乎每週都在各大產品團隊的驗收會議上重複。過去我們把設計稿截圖貼進 AI 編輯器,AI 只能靠「猜」來還原畫面,色碼、字距與間距往往差了一截。

現在透過 Figma MCP(Model Context Protocol),Cursor 與 Claude Code 不再需要「看圖猜字」,而是直接連進 Figma 檔案的結構層讀取精準數據。

當 Design Token 與 Code Connect 透過 MCP 串起來,AI 產出的前端程式碼就能直接呼叫公司現有的設計元件,徹底告別切版走樣。

延伸閱讀:Zapier MCP 實戰:讓 ChatGPT 與 Claude 直接連動 Notion 與工作流

延伸閱讀:Screenshot to Code 81K 星開源專案:截圖轉前端程式碼的極限與突破

Figma MCP 串接 Cursor 與 Claude Code 讀取 Design Token 的自動化切版架構圖
透過 Figma MCP 協定,AI 寫程式工具能直接讀取設計系統變數與元件結構,大幅降低切版誤差。 圖片來源:官方來源。

Figma MCP 的運作原理:從「視覺猜測」進化到「語意讀取」

Model Context Protocol(MCP)是由 Anthropic 推動的開放標準,扮演 AI 模型與外部工具之間的「萬用轉接頭」。當 Figma 啟用 MCP Server 後,AI 代理(如 Cursor、Claude Code 或 Windsurf)就能拿到該設計畫布的結構化 JSON 資料,而不是一張扁平的 PNG 截圖。

這意味著 AI 不只看到顏色長什麼樣,它還能讀出「這個背景使用的是 color/brand/primary 變數」、「這個卡片套用了 Auto Layout gap: 16px」,以及「這個區塊引用了設計系統裡的 Button/Primary 元件」。

切版輔助方式 讀取資訊來源 Design Token 準確度 既有元件複用率 常見痛點
傳統截圖貼上 像素圖片(PNG/JPG) 低(AI 自行估計色碼與間距) 極低(常重寫一套新 CSS) 圓角、陰影、響應式間距容易走樣
單純讀取 Figma REST API 原始節點座標與樣式 中(有數值但缺程式碼對應) 低(不知對應專案哪個元件) 產生大量重複的寫死數值(Hardcoded)
Figma MCP + Code Connect 語意變數、Auto Layout 與元件映射 極高(直接對應 Token 名稱) 極高(直接引用專案元件) 前期需由設計與前端整理 Figma 變數與映射

四步驟實戰:把 Figma MCP 接進 Cursor 與 Claude Code

要在團隊專案中跑通這套工作流,其實不需要複雜的客製化開發,只要依序完成以下四個設定步驟:

步驟一:整理 Figma 檔案的 Auto Layout 與 Variables

AI 讀得懂的前提是設計稿本身結構乾淨。請確保交付開發的頁面已經套用 Auto Layout(對應 CSS Flexbox / Grid),並將顏色、字級與間距建立為 Figma Variables(Design Tokens)。雜亂無章的 Group 與寫死色碼,就算接上 MCP 也只能產出雜亂的 CSS。

步驟二:取得 Figma 開發者權限與啟用 MCP Server

在 Figma 桌面版或支援的 MCP 工具設定中,確認帳號具備 Dev Mode 權限並產生對應的 Personal Access Token(或啟用官方本地端 MCP 服務)。複製這段連線設定,準備填入 AI 編輯器。

步驟三:在 Cursor 或 Claude Code 註冊 MCP 伺服器

開啟 Cursor 的 Settings > MCP(或 Claude Code 的 .mcp.json 設定檔),加入 Figma MCP Server 的啟動指令與環境變數。設定完成後,當你在對話框貼上一個 Figma Frame 的連結(Node URL),AI 就會自動呼叫 get_figma_data 工具抓取該畫面的完整結構。

步驟四:搭配 Code Connect 映射專案真實元件

這是進階但最關鍵的一步。透過 Figma 的 Code Connect 功能,工程師可以把 Figma 裡的 Button 元件直接綁定到程式碼庫中的 @/components/ui/button。當 Cursor 透過 MCP 讀到這個畫面時,它不會傻傻地重新手刻一個 <button>,而是直接寫出 <Button variant="primary" size="lg">送出訂單</Button>,大幅降低專案技術債。

設計師與工程師的新協作默契

導入 Figma MCP 後,設計師的產出物不再只是「給人看的畫」,同時也是「給 AI 讀的規格書」。以下是團隊實測最有效的三個習慣調整:

  • 圖層命名語意化:把 Frame 1024 改成 CheckoutSummaryCard,AI 產出的 React 元件名稱就會直接對齊,省去工程師重命名的時間。
  • 使用元件變體(Variants)而非拆散圖層:維持元件實例(Instance)不拆散(Detach),MCP 才能正確辨識它對應的屬性(如 disabled=true)。
  • 在 Prompt 中明確指定 Token 檔案位置:下指令給 Cursor 時順手附上 @tailwind.config.ts 或 @tokens.css,讓 AI 將 Figma 變數精準對應到專案變數。

常見問題(FAQ)

Q1:沒有企業版 Figma 帳號,也能使用 Figma MCP 嗎?

可以。無論是使用 Figma 官方提供的 MCP 整合或開源社群維護的 Figma-Context-MCP 工具,只要帳號能產生 Personal Access Token 並讀取目標檔案即可運作;但若要使用官方完整的 Code Connect 元件映射功能,則需視 Figma 方案等級(通常為 Organization 或 Enterprise 方案)而定。

Q2:Figma MCP 可以直接把整個網站一次轉換成完整專案嗎?

不建議一次丟整份幾十頁的檔案。實務上最穩定的做法是「逐一區塊或單一頁面」貼上 Node URL,搭配專案的路由與資料結構讓 Cursor 逐步實作,這樣不僅 Token 消耗較少,程式碼品質也最容易掌控。

Q3:如果設計稿沒有設定 Variables,接上 MCP 還有用嗎?

依然有用。AI 還是能透過 MCP 讀取精確的長寬、Padding、Gap、字體大小與十六進位色碼,精準度遠勝過單純貼截圖;只是產出的程式碼會是固定數值,少了對應 Design Token 的一致性優勢。

Q4:Cursor 與 Claude Code 哪一個搭配 Figma MCP 效果比較好?

兩者皆支援標準 MCP 協定,核心讀取能力相同。若你習慣邊看畫面預覽、邊用視覺化介面微調前端樣式,Cursor 的整合體感較直覺;若是需要跨多個檔案重構整個元件庫與測試流程,Claude Code 在終端機裡的長程執行能力往往更穩定。

結語:Design Token 終於從理想變成日常

過去 Design System 常常是設計師辛苦建完、工程師卻因為趕工而沒時間對齊的擺設。Figma MCP 的出現,讓設計系統第一次真正成為驅動程式碼生成的「單一真實來源(Single Source of Truth)」。建議團隊先挑一個新功能模組試跑,讓 AI 幫你把繁瑣的樣式對齊做完,工程師與設計師就能把時間留給真正影響產品價值的體驗設計。

歡迎免費訂閱 AI 郵報,每週追蹤更多 UI/UX 與產品經理(PM)AI 實戰工作流。

Read more