連接遠端伺服器只需要兩樣東西：端點 https://mcp.figma.com/mcp 與 HTTP transport，首次連線時以 OAuth 登入 Figma 帳號，不需要 Figma 桌面 App。各 client 的差別只在於設定寫在哪裡，以及官方有沒有提供 plugin 形式的快捷安裝。
官方建議優先用 plugin 安裝（在有提供的 client 上），理由是 plugin 內含伺服器設定與 Figma 的 skills——skills 是讓 agent 可靠使用寫入工具的關鍵，手動加 server 不會帶進這些。
📖 Claude Code
建議做法（plugin）：
claude plugin install figma@claude-plugins-official重啟 Claude Code，執行 /plugin，到 Installed 分頁選 figma，按 Enter 登入，點 Allow access。
手動做法：
claude mcp add --transport http figma https://mcp.figma.com/mcp要套用到所有專案就加 --scope user：
claude mcp add --scope user --transport http figma https://mcp.figma.com/mcp接著開新 session，執行 /mcp，選 figma，選 Authenticate，點 Allow access。再執行一次 /mcp 確認連上。
--scope user的取捨：Figma MCP 的用量是按帳號計算的（見 限額），全域開啟代表任何專案裡的 agent 都可能呼叫它。若你只有一兩個專案會用到設計資料，用專案層級的 scope 比較不容易誤觸限額。
📖 Cursor
建議做法（plugin）——在對話框輸入：
/add-plugin figma
點 Add Plugin，然後開 Cursor Settings → Tools & MCP，在 Figma 旁點 Connect，再點 Allow access。
手動做法——在 Tools & MCP 加入：
{
"mcpServers": {
"figma": {
"url": "https://mcp.figma.com/mcp"
}
}
}存檔後在 Figma 旁點 Connect。
📖 VS Code
開命令面板，執行 MCP: Open User Configuration（套用所有專案）或 MCP: Open Workspace Folder Configuration（只套用目前 workspace），把以下內容貼進 mcp.json：
{
"inputs": [],
"servers": {
"figma": {
"url": "https://mcp.figma.com/mcp",
"type": "http"
}
}
}存檔後，在 Figma server 名稱上方點 Start，再點 Allow access。
📖 Codex
App：點左上角 Plugins，在 Figma 旁點 +，點 Install Figma，點 Allow access。
CLI：
codex mcp add figma --url https://mcp.figma.com/mcp📖 Xcode
需要 Xcode 27 beta，且只支援遠端伺服器。
手動：Settings → Intelligence → Plug-ins → Add plug-in → Add from URL，輸入 https://github.com/figma/mcp-server-guide，選 Figma plug-in，點 Sign in…。
📖 其他 client
官方的做法是：新增一個 MCP server，transport 選 HTTP，URL 填 https://mcp.figma.com/mcp，然後依提示登入 Figma。
官方 client 對照表列出的名單包含 Claude Code、Claude Desktop、Codex、Cursor、VS Code、Kiro、Gemini CLI、Warp、Augment Code、Copilot CLI、Factory、Firebender、OpenCode、Linear、Replit、Openhands、Amazon Q、Android Studio、Dia、Meta Muse、Xcode（beta）。
這張表有四個欄位：桌面支援、遠端支援、寫回畫布支援、plugin 或 skills 支援。四欄不是同時具備的——某個 client 能連上遠端，不代表它能寫回畫布。官方建議以 Figma MCP catalog 的現況為準，因為名單會變。
只有在 catalog 裡的 client 能連上遠端伺服器。 官方為尚未支援的 client 提供了一個 waitlist 表單。
📖 本機伺服器
需要 Figma 桌面 App，端點為 http://127.0.0.1:3845/mcp，在 inspect 面板的 MCP server 區塊啟用。
要求：Dev 或 Full 席次，且方案須為 Professional、Education、Organization、Government 或 Enterprise。
什麼時候才用它：官方把它定位為「for specific organization and enterprise needs」。實務上的理由通常是網路隔離或合規要求。Figma for Government 是唯一必須用它的情況——該方案只支援本機伺服器，且工具受限。
注意一個反直覺的取捨：本機版聽起來「資料不出本機所以比較安全」，但它的功能明顯少於遠端版——大量寫入工具與跨檔案查詢工具標註為 Remote only。選本機版是以功能換取部署模式，不是免費的安全升級。
📖 連不上的排查
官方有專門的疑難排解頁面，涵蓋工具載不出來、500 錯誤、卡住或變慢、圖片停止載入、client 相關問題。依可能性排序：
工具沒出現在 client 裡。 先確認 OAuth 真的完成了——多數 client 在未認證時仍會顯示 server 但工具清單是空的。在 Claude Code 用 /mcp 檢查狀態。
席次或方案不符。 本機伺服器需要 Dev 或 Full 席次。View 或 Collab 席次每月只有 20 次呼叫（見 限額），很容易以為是連線問題。
client 不在 catalog 裡。 遠端伺服器只接受 catalog 內的 client。
撞到限額。 每分鐘的限制比每日的更容易無預警觸發——Professional 每分鐘只有 10 次。
選取範圍太大。 官方把「卡住或變慢」單獨列為一個問題，解法是選小一點，見 大型 frame。
一個有用的第一步：呼叫 whoami（遠端限定）。它回傳你的身分、方案與席次——一次就能排除「認證沒過」與「方案不符」兩種可能，而這兩者合起來是絕大多數的連線問題。
🧠 重點整理
遠端只需要端點 ＋ HTTP transport ＋ OAuth，不需要桌面 App。
優先用 plugin 安裝——它會一併帶進 Figma 的 skills，手動加 server 不會。
Claude Code 的 --scope user 要想清楚，用量按帳號計算，全域開啟容易誤觸限額。
官方 client 表有四個欄位，能連上不代表能寫回畫布。
只有 catalog 內的 client 能連遠端。
本機版功能明顯少於遠端版，選它是以功能換部署模式，不是安全升級。
Figma for Government 只支援本機版且工具受限。
排查的第一步是呼叫 whoami，一次排除認證與方案兩種可能。
✍️ 動手做
把連線確認到底，約 15 分鐘：
- 用 plugin 方式連上你主要使用的 client。
- 執行 client 的 MCP 狀態指令（Claude Code 是
/mcp），確認工具清單不是空的。 - 呼叫
whoami，記下你的方案與席次。 - 對照 限額表，算出你每天與每分鐘的呼叫上限各是多少。
- 在 Figma 裡選一個最小的元件（一顆按鈕就好），請 agent 取得它的設計脈絡。
第 4 步值得在第一天就做。知道自己每分鐘只有 10 次呼叫，會改變你設計工作流的方式——例如改成先用 get_metadata 取輪廓再針對性取用，而不是讓 agent 反覆探索。
🔗 資料來源
- Figma 開發者文件 — 遠端伺服器安裝——各 client 的完整指令與設定片段、OAuth 流程、catalog 限制與 waitlist（一手，2026-11-01 查證）。
- Figma 開發者文件 — Figma MCP server——client 對照表的四個欄位、方案與席次要求、Figma for Government。
- Figma Help Center — Guide to the Figma MCP server——本機端點、建議使用遠端。
- 疑難排解章節：
tools-not-loading、getting-500-error、stuck-or-slow、images-stopped-loading、mcp-clients-issues（官方）。