figma/mcp-server-guide: kết nối Figma với AI — hướng dẫn cài đặt và dùng
Bài này là một góc nhìn khác về figma/mcp-server-guide — repo từng đổi tên nên mình viết lại với cách tiếp cận khác. Bài hướng dẫn chính: figma/mcp-server-guide: nối Figma với AI viết code — hướng dẫn cài đặt và dùng →

Tóm tắt nhanh
figma/mcp-server-guide là repo hướng dẫn dùng Figma MCP Server, giúp AI đọc ngữ cảnh thiết kế Figma và hỗ trợ tạo code hoặc chỉnh sửa canvas. Repo chủ yếu dùng máy chủ từ xa nên không cần cài một gói Python riêng; cách kết nối phụ thuộc vào công cụ bạn đang dùng.
figma/mcp-server-guide là repo hướng dẫn kết nối Figma MCP Server với các công cụ AI lập trình. Khi kết nối xong, AI có thể đọc frame, layer, component, biến và bố cục trong Figma để hỗ trợ viết code sát với thiết kế hơn. Với máy chủ từ xa, AI còn có thể tạo hoặc chỉnh sửa nội dung native trực tiếp trên canvas khi tính năng và quyền truy cập phù hợp.
Repo phù hợp với designer, chủ sản phẩm, nhân viên văn phòng đang làm prototype, và lập trình viên muốn biến thiết kế thành giao diện thật nhanh hơn. Điểm đáng giá nhất là tài liệu không chỉ nói cách kết nối, mà còn hướng dẫn cách chọn frame, viết prompt, dùng Code Connect, tổ chức file Figma và giảm lỗi khi sinh code. Repo hiện có khoảng 2.181 sao và 215 fork.
Nếu muốn xem cách dùng trực quan, bạn có thể xem video ngắn bên dưới.
figma/mcp-server-guide
Hướng dẫn kết nối Figma MCP Server với VS Code, Cursor, Claude Code và Gemini CLI để chuyển thiết kế thành code.
I.Figma MCP Server làm được gì
A.Đọc thiết kế Figma để hỗ trợ viết code
Bạn chọn một frame hoặc layer trong Figma, sao chép liên kết rồi gửi cho AI client. Client không mở liên kết như một trình duyệt thông thường. Nó lấy node-id từ liên kết để yêu cầu Figma MCP Server trả về đúng đối tượng thiết kế.
Kết quả là AI có thêm thông tin có cấu trúc về bố cục, kích thước, màu sắc, typography và các thành phần liên quan. Nhờ vậy, bạn có thể bắt đầu từ thiết kế thật thay vì mô tả giao diện bằng lời.
B.Sinh code từ frame đã chọn
Công cụ get_design_context cung cấp biểu diễn React và Tailwind của vùng thiết kế được chọn. Đây là điểm bắt đầu để AI chuyển sang framework, cấu trúc thư mục hoặc hệ thống style của dự án.
Bạn có thể yêu cầu dùng Chakra UI, SwiftUI, component nội bộ hoặc một đường dẫn cụ thể như src/components/ui. Cách này hữu ích khi team muốn thử nhanh một màn hình nhưng vẫn giữ quy ước trong codebase.
C.Lấy biến, style và ngữ cảnh thiết kế
Công cụ get_variable_defs giúp lấy tên và giá trị các biến, chẳng hạn màu, khoảng cách, typography hoặc token khác được dùng trong vùng chọn. Điều này giúp AI dùng lại design token thay vì đoán và hardcode từng giá trị.
Nếu AI trả về code thô hoặc không dùng đúng token, bạn có thể gọi rõ công cụ này trong prompt để lấy danh sách biến và giá trị của frame.
D.Tái sử dụng component với Code Connect
Code Connect liên kết component trong Figma với component thật trong codebase. Khi có liên kết này, AI có cơ sở để tái sử dụng component của dự án thay vì tạo một nút, thẻ hoặc input mới có hành vi gần giống.
Lợi ích thực tế là code sinh ra dễ hòa vào hệ thống hiện có hơn. Designer vẫn làm việc trong Figma, còn developer giảm công sức sửa lại các component đã tồn tại.
E.Ghi nội dung trực tiếp lên canvas
Với máy chủ từ xa và kỹ năng phù hợp, agent có thể tạo hoặc chỉnh sửa frame, component, variable và auto layout trực tiếp trong file Figma. Tính năng này đang ở giai đoạn beta và tài liệu nói rằng hiện được cung cấp miễn phí trong giai đoạn beta.
Đây là tính năng phù hợp khi bạn muốn dựng nhanh một bảng điều khiển, cập nhật một flow hoặc thử một biến thể thiết kế từ yêu cầu bằng văn bản.
F.Tạo ảnh giữ chỗ khi thiếu asset
Khi ảnh gốc, ảnh chụp hoặc ảnh trong thư viện không có sẵn, agent có thể dùng generate_image sau khi xin phép và thông báo việc sử dụng tín dụng Figma AI. Ảnh được tạo sẽ được tải lên bằng upload_assets rồi áp dụng vào thiết kế.
Không nên coi ảnh tạo tự động là asset thương hiệu cuối cùng nếu chưa được duyệt. Nó phù hợp hơn cho prototype, bản trình bày nội bộ hoặc giai đoạn thử bố cục.
G.Chuyển web page thành thiết kế Figma
Repo có nêu tính năng capture, import hoặc chuyển một trang web thành thiết kế Figma trực tiếp từ AI coding agent. Tính năng này đang được triển khai dần, nên khả năng hiển thị hoặc quyền dùng có thể phụ thuộc vào tài khoản và công cụ của bạn.
H.Có thêm workflow skill độc lập
Ngoài các skill đi kèm Figma Plugin, repo còn có hai workflow skill độc lập. video-interaction-mapper biến bản ghi thao tác giao diện thành storyboard Figma có chú thích. generate-project-plan biến PRD, kèm tùy chọn ngữ cảnh codebase, thành một bảng kế hoạch dự án trên FigJam.
II.Cần chuẩn bị gì
Bạn cần một tài khoản và môi trường có thể dùng Figma MCP Server. Máy chủ được kết nối qua Streamable HTTP tại địa chỉ https://mcp.figma.com/mcp, nên hướng dẫn chính không yêu cầu bạn tự chạy một server local.
Bạn cũng cần một MCP client được repo hỗ trợ. Các lựa chọn được hướng dẫn cụ thể là VS Code, Cursor, Claude Code và Gemini CLI. Những editor hoặc công cụ khác cũng có thể dùng nếu hỗ trợ giao tiếp Streamable HTTP.
Nếu dùng VS Code, tài khoản của bạn phải bật GitHub Copilot để dùng MCP trong VS Code. Nếu dùng Gemini CLI, bạn cần cài Gemini CLI trước khi cài extension. Nếu dùng Cursor hoặc Claude Code, repo khuyến nghị cài Figma Plugin để có sẵn cấu hình MCP và skill liên quan.
Bạn nên có quyền truy cập file Figma cần đọc hoặc chỉnh sửa. Số lần gọi công cụ đọc dữ liệu phụ thuộc gói Figma và loại seat. Người dùng gói Starter hoặc seat View, Collab trên gói trả phí bị giới hạn tối đa 6 lần gọi công cụ mỗi tháng. Người dùng có seat Dev hoặc Full trên gói Professional, Organization hoặc Enterprise áp dụng giới hạn theo phút tương tự Tier 1 của Figma REST API.
README không yêu cầu cài Python, Node.js hay GPU để kết nối máy chủ từ xa. Repo có ngôn ngữ chính là Python nhưng phần hướng dẫn sử dụng MCP chủ yếu là cấu hình client và lệnh cài plugin, extension.
MCP server có thể đọc dữ liệu từ file Figma mà client được phép truy cập. Hãy kiểm tra file, quyền chia sẻ và prompt trước khi gửi thiết kế nội bộ. Tính năng viết lên canvas và tạo ảnh có thể liên quan đến giới hạn hoặc chi phí Figma theo chính sách hiện hành.
III.Cài đặt từng bước
- Chọn MCP clientXác định bạn dùng VS Code, Cursor, Claude Code, Gemini CLI hoặc editor khác
- Kết nối máy chủThêm https://mcp.figma.com/mcp bằng cách cấu hình phù hợp
- Xác thực và kiểm traĐăng nhập hoặc gọi công cụ kiểm tra MCP theo client
- Gửi frame cho AISao chép liên kết frame, viết prompt và yêu cầu tạo code
A.Chọn cách kết nối phù hợp
Bạn không cần clone repo để dùng máy chủ Figma MCP. Repo này chủ yếu là guide, plugin, extension và các file cấu hình cho nhiều client. Nếu muốn xem đầy đủ tài liệu hoặc các skill đi kèm, bạn có thể lấy repo về máy bằng lệnh phổ thông sau:
git clone https://github.com/figma/mcp-server-guide.git
cd mcp-server-guideLệnh đầu tiên tải repo về thư mục hiện tại. Lệnh thứ hai đi vào thư mục repo. Hãy mở terminal tại nơi bạn muốn lưu repo và bảo đảm máy đã có Git. Việc clone không thay thế bước kết nối MCP trong client.
B.Kết nối trong VS Code
Mở VS Code và dùng phím tắt ⌘ Shift P trên macOS để tìm MCP:Add Server. Chọn HTTP, dán địa chỉ server rồi nhấn Enter. Khi được hỏi server ID, nhập figma. Sau đó chọn thêm server ở phạm vi toàn cục hoặc chỉ workspace hiện tại.
Cấu hình tạo ra trong file mcp.json có dạng:
{
"servers": {
"figma": {
"type": "http",
"url": "https://mcp.figma.com/mcp"
}
}
}Mở thanh chat bằng ⌥⌘B hoặc ⌃⌘I, chuyển sang chế độ Agent, rồi nhập #get_design_context. Nếu không thấy tool nào, hãy khởi động lại VS Code. Người mới thường quên bật GitHub Copilot; README nêu đây là điều kiện để dùng MCP trong VS Code.
C.Kết nối trong Cursor bằng plugin
Cách được khuyến nghị là cài Figma Plugin từ Agent chat của Cursor. Nhập lệnh sau:
/add-plugin figmaPlugin bao gồm cấu hình MCP server, skill triển khai thiết kế, kết nối component bằng Code Connect, tạo design system rule và các rule xử lý asset từ Figma MCP Server.
Nếu muốn cấu hình thủ công, mở Cursor → Settings → Cursor Settings, vào tab MCP, chọn + Add new global MCP server, rồi nhập:
{
"mcpServers": {
"figma": {
"url": "https://mcp.figma.com/mcp"
}
}
}Lưu cấu hình rồi mở lại Agent. Nếu client chưa nhận server, kiểm tra đúng tab MCP và đúng URL. README không yêu cầu thêm package Python hoặc Node cho cách này.
D.Kết nối trong Claude Code
Cách khuyến nghị là cài Figma Plugin từ marketplace plugin chính thức của Anthropic bằng lệnh:
claude plugin install figma@claude-plugins-officialNếu muốn cấu hình thủ công, mở terminal và chạy:
claude mcp add --transport http figma https://mcp.figma.com/mcpBạn có thể xem danh sách server đã cấu hình bằng:
claude mcp listĐể xem chi tiết một server, README đưa ví dụ:
claude mcp get my-serverĐể xóa một server:
claude mcp remove my-serverKhi kiểm tra, hãy thay my-server bằng tên server thật nếu bạn muốn xem hoặc xóa Figma. Lỗi thường gặp là cài plugin nhưng vẫn thêm cấu hình thủ công trùng tên; hãy kiểm tra danh sách trước khi thêm lại.
E.Kết nối trong Gemini CLI
Cài extension Figma bằng lệnh:
gemini extensions install https://github.com/figma/mcp-server-guideSau khi cài xong, chạy gemini, rồi thực hiện lệnh sau bên trong CLI:
/mcp auth figmaLệnh này dùng để xác thực Figma cho extension. Nếu cần gỡ extension, chạy:
gemini extensions uninstall figmaBạn cần phân biệt lệnh cài extension chạy trong terminal với /mcp auth figma, vốn được thực hiện bên trong phiên Gemini CLI.
F.Kết nối editor khác
Nếu editor của bạn hỗ trợ Streamable HTTP, bạn có thể thêm cấu hình sau theo cơ chế MCP của editor:
{
"mcpServers": {
"figma": {
"url": "https://mcp.figma.com/mcp"
}
}
}README không đưa lệnh cài cụ thể cho từng editor khác. Vì vậy, hãy xem tài liệu MCP của chính editor đó để biết vị trí file cấu hình, tên trường và cách khởi động lại server.
IV.Kiểm tra đã chạy được chưa
Cách kiểm tra phụ thuộc vào client bạn dùng. Trong VS Code, mở Agent mode và nhập #get_design_context. Nếu tool của Figma MCP Server xuất hiện hoặc client trả về ngữ cảnh thiết kế, kết nối đã hoạt động. Nếu không có tool, README khuyên khởi động lại VS Code.
Trong Claude Code, chạy claude mcp list. Bạn cần thấy server figma trong danh sách đã cấu hình. Nếu vừa thêm thủ công, có thể dùng claude mcp get với tên server để xem chi tiết cấu hình.
Trong Gemini CLI, sau khi chạy /mcp auth figma, extension đã có bước xác thực theo hướng dẫn. Bạn có thể thử một prompt yêu cầu đọc frame Figma để xác nhận client truy cập được tool.
Với mọi client, hãy lấy một liên kết frame hoặc layer trong Figma và gửi prompt yêu cầu triển khai. Client không cần mở trang liên kết. Nó cần lấy node-id trong liên kết để server nhận diện đối tượng. Kết quả mong đợi là AI trả về ngữ cảnh thiết kế hoặc bắt đầu dùng tool liên quan.
V.Dùng vào việc thật
A.Lập trình viên chuyển màn hình đăng nhập thành giao diện web
Một developer có frame đăng nhập trong Figma. Bạn sao chép link frame rồi gửi prompt:
Implement this Figma frame in our existing app. Use React and Tailwind, reuse components from src/components/ui, and keep the current routing and data-fetch patterns.MCP cung cấp dữ liệu frame, còn prompt nói rõ framework, thư mục và quy ước cần giữ. Kết quả là AI có thể tạo phần giao diện dựa trên frame thay vì tự đoán từ ảnh.
B.Team sản phẩm kiểm tra design token
Một designer muốn biết frame đang dùng màu, khoảng cách và typography nào. Bạn yêu cầu:
Get the variable names and values used in this frame. Explain which variables control color, spacing, typography, and radius.Nếu client chọn đúng get_variable_defs, AI trả về danh sách biến và giá trị được dùng trong vùng chọn. Team có thể đối chiếu với design system trước khi giao việc cho developer.
C.Team frontend tái sử dụng component thật
Một công ty đã có component Button, Card và Stack trong codebase. Khi gửi frame cho AI, bạn thêm:
Use our existing Stack layout component and reuse the connected design-system components. Add the implementation to src/components/marketing/PricingCard.tsx.Code Connect và prompt cụ thể giúp AI biết nên dùng component nào, đặt code ở đâu và tránh tạo bản sao. Kết quả phù hợp hơn với dự án có quy ước rõ ràng.
D.Chủ sản phẩm biến PRD thành bảng kế hoạch FigJam
Một product manager có PRD và muốn dựng kế hoạch trực quan. Repo có workflow skill generate-project-plan, dùng PRD cùng tùy chọn ngữ cảnh codebase để tạo FigJam project plan board.
Bạn có thể đưa yêu cầu theo hướng:
Turn this PRD into a FigJam project plan board. Group the work by milestones, dependencies, and owners, using the existing codebase context where available.Kết quả dự kiến là bảng kế hoạch trên FigJam, phù hợp để trao đổi phạm vi và phụ thuộc giữa sản phẩm, thiết kế và kỹ thuật.
Khi prompt nói rõ framework, đường dẫn, component và quy ước, AI có nhiều cơ hội tạo ra code dùng được ngay hơn.
Ông T
VI.Lỗi hay gặp và cách xử lý
A.Không thấy tool sau khi thêm server
Trong VS Code, hãy kiểm tra bạn đã chuyển sang Agent mode chưa. Sau đó thử lại #get_design_context và khởi động lại VS Code nếu danh sách tool vẫn trống. Cũng cần kiểm tra tài khoản đã bật GitHub Copilot, vì README nêu đây là điều kiện để dùng MCP trong VS Code.
B.Dán sai cấu hình JSON
Các client dùng cấu trúc khác nhau. VS Code dùng khóa servers, còn Cursor và cấu hình generic trong README dùng mcpServers. Hãy chép đúng mẫu dành cho client của bạn, giữ đúng dấu ngoặc và URL https://mcp.figma.com/mcp.
C.Claude Code có server trùng hoặc sai tên
Chạy claude mcp list để xem server hiện có trước khi thêm lại. Khi dùng claude mcp get my-server hoặc claude mcp remove my-server, hãy thay bằng tên thật. Không xóa server nếu chưa xác định đúng tên và phạm vi cấu hình.
D.Gemini CLI chưa xác thực Figma
Cài extension trong terminal chưa hoàn tất bước xác thực. Hãy chạy gemini, sau đó thực hiện /mcp auth figma bên trong CLI. Nếu không cần extension nữa, dùng đúng lệnh uninstall trong README thay vì xóa thủ công file cấu hình.
E.Gọi công cụ quá nhiều hoặc chạm giới hạn
Các tool đọc dữ liệu Figma có rate limit. Người dùng Starter hoặc seat View, Collab có thể bị giới hạn tối đa 6 lần gọi mỗi tháng. Hãy chọn frame nhỏ hơn, chia màn hình thành các component và tránh yêu cầu AI đọc lại toàn bộ file nhiều lần.
F.Code sinh ra không sát thiết kế
Kiểm tra cách tổ chức file Figma trước: dùng component cho phần lặp lại, đặt tên layer có nghĩa, dùng variables và auto layout. Với vùng lớn, hãy chia thành Header, Card, Sidebar hoặc component nhỏ hơn. Bạn cũng có thể yêu cầu get_design_context trước, rồi get_screenshot để đối chiếu trực quan trước khi bắt đầu implementation.
VII.Có nên dùng không
Bạn nên dùng repo này nếu đang làm việc giữa Figma và code, đặc biệt khi team dùng VS Code, Cursor, Claude Code hoặc Gemini CLI. Cách kết nối máy chủ từ xa khá gọn, không cần tự dựng backend MCP, và repo có hướng dẫn riêng cho từng client. Các skill, Code Connect, biến thiết kế và rule dự án giúp kết quả có tính nhất quán hơn.
Giới hạn lớn nhất là chất lượng đầu ra vẫn phụ thuộc vào file Figma, prompt và codebase. Nếu layer đặt tên chung chung, không có component, không dùng token hoặc frame quá lớn, AI dễ sinh code khó tái sử dụng. Rate limit cũng khiến việc đọc dữ liệu lặp lại không phù hợp với thử nghiệm thiếu kiểm soát.
Bạn cũng cần cân nhắc quyền truy cập và điều khoản dành cho Figma Developer. Tính năng viết lên canvas đang là beta; tính năng này được ghi là miễn phí trong giai đoạn beta nhưng có thể trở thành tính năng tính phí theo mức sử dụng. Việc tạo ảnh có thể dùng tín dụng Figma AI.
Nếu editor của bạn không hỗ trợ Streamable HTTP, repo chưa ghi cách kết nối cụ thể. Khi đó, hãy chọn một client được hướng dẫn rõ hoặc kiểm tra tài liệu của editor trước. Với dự án cần kiểm soát tuyệt đối việc sinh code, bạn vẫn nên xem output, chạy kiểm thử và đối chiếu với Figma trước khi đưa vào sản phẩm.
Câu hỏi thường gặp
Repo này có phải là một gói Python cần cài local không?
Không theo phần hướng dẫn được cung cấp. Repo chủ yếu hướng dẫn kết nối tới Figma MCP Server từ xa qua Streamable HTTP, đồng thời chứa plugin, extension và workflow skill. README không yêu cầu cài Python hay một gói local riêng.
Có dùng được trên Windows không?
README không nêu riêng khả năng tương thích Windows. Các lệnh CLI được trình bày cho Claude Code và Gemini CLI, còn cấu hình MCP dùng URL HTTP nên phụ thuộc vào client bạn chọn. Với editor khác, README yêu cầu kiểm tra xem công cụ đó có hỗ trợ Streamable HTTP hay không.
Có cần GPU không?
README không yêu cầu GPU. Máy chủ được kết nối từ xa và tài liệu không nêu yêu cầu phần cứng đặc biệt.
Dùng Figma MCP Server có miễn phí không?
Tính năng viết lên canvas được ghi là hiện miễn phí trong giai đoạn beta, nhưng có thể trở thành tính năng tính phí theo mức sử dụng. Các tool đọc dữ liệu có rate limit; gói Starter hoặc seat View, Collab bị giới hạn tối đa 6 lần gọi mỗi tháng.
Tôi có cần GitHub Copilot để dùng không?
Chỉ phần hướng dẫn VS Code nêu yêu cầu tài khoản phải bật GitHub Copilot để dùng MCP trong VS Code. README không nói rằng Cursor, Claude Code hoặc Gemini CLI cũng cần GitHub Copilot.
AI có đọc được link Figma trực tiếp không?
Client không điều hướng tới URL như trình duyệt. Nó lấy `node-id` từ liên kết frame hoặc layer để MCP server xác định đối tượng cần trả về. Bạn vẫn cần có quyền truy cập phù hợp vào file Figma.
Dữ liệu Figma có an toàn không?
README nhắc rằng bạn đồng ý với Figma Developer Terms khi dùng Figma MCP Server và các tài nguyên liên quan. Tài liệu không cung cấp cam kết bảo mật chi tiết hơn, nên bạn cần kiểm tra quyền chia sẻ file và tránh gửi thiết kế nhạy cảm nếu chưa được phép.


