# figma/mcp-server-guide: nối Figma với AI viết code — hướng dẫn cài đặt và dùng

> figma/mcp-server-guide là kho hướng dẫn chính thức của Figma về cách nối Figma MCP server vào trợ lý AI. Nhờ đó AI đọc được khung thiết kế (frame), biến số và component rồi sinh code. Cài không khó: chủ yếu là một lệnh hoặc vài dòng cấu hình, nhưng bạn cần tài khoản Figma và có giới hạn lượt gọi theo loại ghế (seat).

- Tác giả: Ông T (https://ongt.vn/gioi-thieu)
- Chủ đề: Repo & Skill
- Đăng: 2026-09-05 · Cập nhật: 2026-11-13
- URL: https://ongt.vn/bai-viet/figma-mcp-server-guide-noi-figma-voi-ai-viet-code

Figma MCP server guide là kho hướng dẫn chính thức của Figma, chỉ cách nối Figma vào các trợ lý AI viết code như Claude Code, Cursor, VS Code (GitHub Copilot) hay Gemini CLI. Sau khi nối, AI không phải "nhìn ảnh đoán" nữa. Nó đọc được dữ liệu thật của thiết kế: bố cục, màu, khoảng cách, component, rồi viết code bám sát bản thiết kế.

Repo này hợp với dev mới, lập trình viên frontend, và cả nhóm có designer đang phải ngồi "dịch" Figma sang code bằng tay. Điểm đáng giá nhất là bạn chỉ cần copy link một khung trong Figma, dán vào khung chat của AI và yêu cầu làm theo. Repo hiện có khoảng 2180 sao và 215 fork, vẫn được cập nhật trong 3 tháng gần đây.

Một điều nên nói rõ ngay: đây chủ yếu là kho hướng dẫn, file cấu hình và các skill (bộ chỉ dẫn làm việc cho AI), không phải một ứng dụng bạn bấm cài rồi chạy. Phần lõi là server của Figma nằm trên mạng, bạn chỉ cần "chỉ đường" cho trợ lý AI đến đó. Xem video ngắn bên dưới để thấy cách làm trước khi đọc chi tiết.

```repo
- repo | figma/mcp-server-guide
- kind | Plugin
- desc | Hướng dẫn kết nối Figma MCP server với VS Code, Cursor, Claude Code, Gemini CLI để AI đọc thiết kế Figma và viết code đúng ý bạn.
- stars | 2.2k
- lang | Python
```

```video
- youtube | https://youtube.com/shorts/k8JgTWPrLDg
- title | Video giới thiệu mcp-server-guide
```

## Figma MCP server làm được gì

Theo README, server này cung cấp cho AI nhiều khả năng. Mình diễn giải theo lợi ích thực tế:

- **Sinh code từ khung đã chọn.** Bạn chọn một frame trong Figma, AI biến nó thành code. Hợp với đội làm sản phẩm đang dựng màn hình mới hoặc sửa tính năng.
- **Lấy ngữ cảnh thiết kế.** Biến số (variables), component và dữ liệu bố cục được kéo thẳng vào IDE. Nhờ vậy code dùng đúng token màu, khoảng cách của hệ thống thiết kế thay vì số cứng.
- **Code Connect.** Tính năng này giúp AI tái dùng component có sẵn trong codebase của bạn. README nói đây là cách tốt nhất để code sinh ra nhất quán; không có nó thì mô hình "đang đoán".
- **Ghi ngược lên canvas (chỉ với server từ xa).** Với các skill phù hợp, AI có thể tạo và sửa frame, component, biến số, auto layout ngay trong file Figma. README ghi tính năng này hiện miễn phí trong giai đoạn beta, sau này sẽ tính phí theo mức dùng.
- **Tạo ảnh giữ chỗ (placeholder).** Khi không có ảnh nguồn, AI có thể dùng `generate_image`, nhưng phải hỏi quyền bạn và nói rõ việc này tiêu hao credit Figma AI trước.
- **Tạo thiết kế Figma từ trang web** (đang triển khai dần). Chụp, nhập hoặc chuyển một trang web thành thiết kế Figma ngay từ trợ lý AI.

Ngoài ra repo còn có hai skill độc lập: `workflow-skills/video-interaction-mapper` biến video ghi màn hình UI thành storyboard Figma có chú thích, và `workflow-skills/generate-project-plan` biến một PRD thành bảng kế hoạch dự án trên FigJam.

## Cần chuẩn bị gì

Tư liệu không liệt kê yêu cầu hệ điều hành hay phiên bản Node/Python, nên mình không dám nêu. Những gì README có nói:

- **Tài khoản Figma** và một công cụ AI hỗ trợ MCP: VS Code, Cursor, Claude Code, Gemini CLI, hoặc công cụ khác hỗ trợ Streamable HTTP.
- **VS Code:** phải bật GitHub Copilot trên tài khoản thì mới dùng được MCP.
- **Claude Code / Gemini CLI:** bạn cần đã cài sẵn công cụ dòng lệnh `claude` hoặc `gemini`. README không hướng dẫn cài hai công cụ này.
- **Loại ghế Figma ảnh hưởng giới hạn dùng.** Gói Starter, hoặc ghế View/Collab trên gói trả phí, bị giới hạn tối đa 6 lượt gọi công cụ mỗi tháng. Ghế Dev hoặc Full trên gói Professional, Organization, Enterprise có giới hạn theo phút, giống bậc Tier 1 của Figma REST API. Figma có quyền đổi các giới hạn này.
- Khi dùng server và các skill, bạn đồng ý với Điều khoản nhà phát triển của Figma (Figma Developer Terms). Các skill hiện ở dạng Beta.

```note
Nếu bạn đang dùng gói Starter, chỉ có 6 lượt gọi mỗi tháng. Thử nghiệm xong là hết, nên hãy kiểm tra loại ghế của mình trước khi lên kế hoạch dùng hằng ngày. Ghi ngược lên canvas và tạo ảnh bằng Figma AI cũng có thể tiêu hao credit, nên đọc kỹ thông báo AI hiện ra trước khi đồng ý.
```

## Cài đặt từng bước

Cách cài tuỳ công cụ bạn đang dùng. Mình tóm tắt trước, rồi đi vào từng công cụ.

```steps
- Chọn công cụ | Xác định bạn dùng VS Code, Cursor, Claude Code, Gemini CLI hay công cụ khác
- Thêm server Figma | Chạy một lệnh hoặc dán cấu hình trỏ tới https://mcp.figma.com/mcp
- Đăng nhập Figma | Xác thực khi công cụ yêu cầu (với Gemini CLI dùng /mcp auth figma)
- Kiểm tra công cụ | Xem danh sách tool của Figma có hiện ra chưa
```

### Cài cho Claude Code

Cách README khuyên dùng là cài Figma Plugin, đã gồm cấu hình MCP và các Agent Skills cho quy trình thường gặp. Mở terminal (cửa sổ dòng lệnh) rồi chạy:

```bash
claude plugin install figma@claude-plugins-official
```

Lệnh này lấy plugin từ kho plugin chính thức của Anthropic. Nếu muốn tự cài thủ công, dùng lệnh sau:

```bash
claude mcp add --transport http figma https://mcp.figma.com/mcp
```

Sau đó có thể kiểm tra và quản lý các server bằng những lệnh README liệt kê:

```bash
claude mcp list
claude mcp get my-server
claude mcp remove my-server
```

`claude mcp list` liệt kê mọi server đã cấu hình. `claude mcp get` xem chi tiết một server, còn `claude mcp remove` gỡ nó. Chỗ người mới hay vấp: `my-server` chỉ là tên ví dụ, bạn thay bằng tên bạn đã đặt, ở đây là `figma`.

### Cài cho Cursor

Cách khuyên dùng là cài plugin. Gõ lệnh sau vào khung chat agent của Cursor (không phải terminal):

```
/add-plugin figma
```

Plugin gồm cấu hình MCP, các skill (triển khai thiết kế, nối component qua Code Connect, tạo quy tắc hệ thống thiết kế) và các quy tắc xử lý tài nguyên ảnh. Nếu muốn cài tay: mở Cursor → Settings → Cursor Settings → tab MCP → bấm "+ Add new global MCP server", rồi dán cấu hình này và lưu:

```json
{
  "mcpServers": {
    "figma": {
      "url": "https://mcp.figma.com/mcp"
    }
  }
}
```

### Cài cho VS Code

Bạn làm theo các bước sau trong VS Code. README ghi phím tắt kiểu macOS (`⌘ Shift P`); trên Windows bạn mở bảng lệnh (Command Palette) theo cách quen thuộc của mình.

1. Mở bảng lệnh, tìm `MCP:Add Server`.
2. Chọn `HTTP`.
3. Dán địa chỉ `https://mcp.figma.com/mcp` rồi nhấn Enter.
4. Khi được hỏi ID server, nhập `figma`.
5. Chọn thêm toàn cục (global) hay chỉ cho workspace hiện tại.

Xong bước đó, file `mcp.json` sẽ có cấu hình như sau:

```json
{
  "servers": {
    "figma": {
      "type": "http",
      "url": "https://mcp.figma.com/mcp"
    }
  }
}
```

Cuối cùng mở khung chat, chuyển sang chế độ **Agent**. Nhớ là tài khoản phải bật GitHub Copilot.

### Cài cho Gemini CLI

Cài tiện ích mở rộng Figma bằng lệnh:

```bash
gemini extensions install https://github.com/figma/mcp-server-guide
```

Sau đó chạy `gemini`, và trong giao diện của nó gõ lệnh sau để đăng nhập Figma:

```
/mcp auth figma
```

Muốn gỡ thì chạy:

```bash
gemini extensions uninstall figma
```

### Cài cho công cụ khác

Nếu công cụ của bạn hỗ trợ Streamable HTTP, thêm server thủ công bằng cấu hình dưới đây. Hãy xem tài liệu của công cụ để biết dán vào đâu.

```json
{
  "mcpServers": {
    "figma": {
      "url": "https://mcp.figma.com/mcp"
    }
  }
}
```

## Kiểm tra đã chạy được chưa

README chỉ cho cách kiểm tra rõ nhất ở VS Code: mở khung chat, gõ `#get_design_context`. Nếu danh sách công cụ của Figma MCP hiện ra là thành công. Nếu không có công cụ nào, hãy khởi động lại VS Code.

Với Claude Code, chạy `claude mcp list` và xem `figma` có nằm trong danh sách không. Với Gemini CLI, README không mô tả kết quả kiểm tra sau cài; bạn hoàn tất bước `/mcp auth figma` là đã đăng nhập xong. Với Cursor và các công cụ khác, README không ghi cách kiểm tra riêng, bạn có thể thử luôn một yêu cầu thật như ở phần dưới.

## Dùng vào việc thật

Cách dùng cơ bản theo README: copy link của một frame hoặc layer trong Figma, rồi nhờ trợ lý AI làm theo thiết kế ở link đó. Công cụ AI không mở được link, nhưng nó lấy `node-id` trong link để biết cần lấy đúng đối tượng nào.

> Prompt tốt giống một bản giao việc cho đồng nghiệp: rõ ý định thì kết quả ít phải sửa.
>
> — Ông T

### Dev frontend dựng thẻ giá từ thiết kế

Bạn là dev nhận thiết kế thẻ bảng giá. Copy link frame trong Figma và gõ vào AI một yêu cầu cụ thể về chỗ đặt file, ví dụ lấy từ README: "Add this to `src/components/marketing/PricingCard.tsx`". Nếu dự án dùng thư viện giao diện riêng, nói thẳng như "Use Chakra UI for this layout". Kết quả là một component bám đúng bố cục thiết kế và nằm đúng thư mục bạn chỉ định.

### Lập trình viên mới làm ứng dụng iOS

Bạn đang tập làm app SwiftUI và có sẵn thiết kế. Dán link khung và viết: "Generate iOS SwiftUI code from this frame". README nói `get_design_context` mặc định trả về dạng React + Tailwind, nhưng AI có thể dịch sang framework khác theo prompt của bạn. Kết quả là đoạn SwiftUI để bạn đọc, chạy thử và học cách dựng giao diện.

### Nhóm sản phẩm muốn code dùng đúng token màu

Nếu code ra toàn mã màu cứng, README gợi ý nói rõ: "Get the variable names and values used in this frame.". Câu này gọi công cụ `get_variable_defs`, lấy biến số và style (màu, khoảng cách, chữ) trong vùng chọn. Sau đó nhờ AI viết lại code dùng đúng tên token. Để khỏi nhắc đi nhắc lại, bạn có thể chép khối quy tắc "Figma MCP Integration Rules" của README vào file chỉ dẫn của dự án. Quy tắc này ép AI chạy `get_design_context` trước, rồi `get_screenshot`, sau đó mới viết code.

### Chia nhỏ màn hình quá lớn

Bạn chọn nguyên một trang dài và AI chạy chậm, báo lỗi hoặc trả thiếu. README khuyên chia thành phần nhỏ như Card, Header, Sidebar. Nếu phản hồi quá lớn, AI có thể chạy `get_metadata` để lấy sơ đồ node tổng quát, rồi chỉ lấy lại đúng node cần bằng `get_design_context`. Kết quả ổn định hơn, và bạn ghép từng phần lại với nhau.

## Lỗi hay gặp và cách xử lý

- **Gõ `#get_design_context` không thấy công cụ nào (VS Code).** README bảo khởi động lại VS Code. Kiểm tra thêm bạn đã chuyển sang chế độ Agent và đã bật GitHub Copilot.
- **AI bỏ qua dữ liệu Figma, trả code "tự bịa" hoặc màu cứng.** Nói rõ tên công cụ trong prompt, ví dụ yêu cầu lấy biến số bằng `get_variable_defs`. Thêm quy tắc dự án như phần trên để AI làm đúng quy trình.
- **Chọn vùng quá lớn nên chậm hoặc kết quả dở dang.** Chia nhỏ thành từng component hoặc khối, theo hướng dẫn trong README.
- **Bị chặn hoặc hết lượt gọi.** Gói Starter hay ghế View/Collab chỉ có 6 lượt mỗi tháng; ghế Dev/Full có giới hạn theo phút. Xem lại loại ghế của bạn, hoặc chờ rồi thử lại, đừng bấm gửi liên tục.
- **Dán link nhưng AI nói không mở được link.** Đó là bình thường: công cụ không điều hướng tới URL, nó chỉ lấy `node-id` từ link. Hãy chắc là link trỏ tới đúng frame hoặc layer bạn muốn.

## Có nên dùng không

**Điểm mạnh:** đây là hướng dẫn chính thức từ Figma, có sẵn cấu hình cho nhiều công cụ phổ biến. Cài thường chỉ một lệnh hoặc vài dòng JSON. Chất lượng code tăng rõ nếu file Figma của bạn gọn gàng: dùng component, biến số, đặt tên layer có nghĩa (ví dụ `CardContainer` thay vì `Group 5`) và auto layout.

**Giới hạn:** giới hạn lượt gọi với gói miễn phí rất chặt (6 lượt mỗi tháng). Một số tính năng như ghi lên canvas còn beta và sau này sẽ tính phí theo mức dùng. Tạo thiết kế từ trang web đang triển khai dần. README không ghi giấy phép của repo, và không nói gì về yêu cầu hệ điều hành. Kết quả cũng không tự hoàn hảo: bạn vẫn phải viết prompt rõ và kiểm tra lại với bản thiết kế.

**Khi nên chọn cách khác:** nếu bạn không có file Figma, hoặc đội chưa có thiết kế chuẩn (không component, không biến số), thì lợi ích sẽ nhỏ. Lúc đó có thể chụp ảnh màn hình đưa cho AI, dù độ chính xác thấp hơn. Còn nếu bạn đã dùng Figma hằng ngày và hay phải chuyển thiết kế thành code, đây là một bước thử rất đáng làm, nhất là khi bạn có ghế Dev hoặc Full.

## Câu hỏi thường gặp

### Figma MCP server có miễn phí không?

README không nói đây là dịch vụ trả phí hay miễn phí hoàn toàn, mà nói về giới hạn lượt gọi. Gói Starter hoặc ghế View/Collab trên gói trả phí bị giới hạn tối đa 6 lượt gọi công cụ mỗi tháng. Tính năng ghi lên canvas đang miễn phí trong giai đoạn beta và sau này sẽ tính phí theo mức dùng.

### Giới hạn lượt dùng khác nhau thế nào giữa các loại tài khoản?

Ghế Dev hoặc Full trên gói Professional, Organization, Enterprise có giới hạn theo phút, theo cùng mức Tier 1 của Figma REST API. Ghế Starter, View hoặc Collab chỉ có tối đa 6 lượt mỗi tháng. Figma có quyền thay đổi các giới hạn này.

### Có cần GPU hay máy cấu hình mạnh không?

Tư liệu không nhắc đến GPU hay yêu cầu phần cứng. Server chạy ở địa chỉ https://mcp.figma.com/mcp, bạn chỉ cấu hình công cụ AI để kết nối tới đó.

### Dùng được trên Windows không?

README không nêu yêu cầu hệ điều hành. Các phím tắt trong phần VS Code được ghi theo kiểu macOS, nên trên Windows bạn dùng phím tương đương của mình. Các lệnh như `claude mcp add` hay `gemini extensions install` là lệnh của công cụ dòng lệnh tương ứng.

### Dùng với VS Code có cần gì thêm không?

Có. README yêu cầu tài khoản phải bật GitHub Copilot thì mới dùng được MCP trong VS Code. Sau khi thêm server, bạn mở khung chat ở chế độ Agent và gõ `#get_design_context` để xem công cụ đã hiện chưa.

### Dữ liệu thiết kế của mình có an toàn không?

Tư liệu không có phần mô tả riêng về bảo mật hay cách lưu dữ liệu. README chỉ nói bạn đồng ý với Điều khoản nhà phát triển của Figma khi dùng server và các skill. Nếu thiết kế nhạy cảm, bạn nên đọc kỹ điều khoản và tài liệu chính thức của Figma.

### Khác gì việc chụp ảnh thiết kế rồi nhờ AI viết code?

Theo README, server cung cấp dữ liệu có cấu trúc như biến số, component và bố cục, kèm tích hợp Code Connect để tái dùng component của codebase. Cách đó giúp code bám token và component có sẵn thay vì đoán từ hình ảnh. README không so sánh số liệu cụ thể với cách chụp ảnh.
