MCP_SETUP_INSTRUCTIONS.md

Hướng dẫn Setup Figma MCP cho Project

Bước 1: Tạo thư mục và file cấu hình

Chạy các lệnh sau trong terminal (tại thư mục root của project):

mkdir -p .cursor

Bước 2: Tạo file .cursor/mcp.json

Tạo file .cursor/mcp.json với nội dung sau:

{
  "mcpServers": {
    "Figma": {
      "url": "https://mcp.figma.com/mcp",
      "headers": {}
    }
  }
}

Hoặc copy/paste lệnh này vào terminal:

cat > .cursor/mcp.json << 'EOF'
{
  "mcpServers": {
    "Figma": {
      "url": "https://mcp.figma.com/mcp",
      "headers": {}
    }
  }
}
EOF

Bước 3: Restart Cursor IDE

1. Đóng hoàn toàn Cursor IDE (Cmd+Q trên Mac, hoặc đóng cửa sổ)
2. Mở lại Cursor
3. Mở project upbase.vn

Bước 4: Kiểm tra MCP đã kích hoạt

1. Vào Cursor Settings (Cmd/Ctrl + ,)
2. Chọn MCP & Integrations
3. Tìm "Figma" trong danh sách
4. Xác nhận:
   • Có dấu xanh (green dot) = Connected
   • Hiển thị "Project Managed" = Đã kích hoạt cho project này

Bước 5: Test Figma MCP

Sau khi restart, paste link Figma vào chat:

https://www.figma.com/design/sC8GCHqw0wOFYVWvHwruCv/UpBase.vn-2026?node-id=1-319

AI sẽ có thể truy cập và đọc design từ Figma.

Troubleshooting

• File không tạo được: Kiểm tra quyền write trong thư mục project
• MCP không hiển thị: Đảm bảo đã restart Cursor hoàn toàn
• Lỗi kết nối: Kiểm tra internet connection và URL https://mcp.figma.com/mcp

Thông tin Figma File

• File Key: sC8GCHqw0wOFYVWvHwruCv
• Node ID: 1:319
• URL: https://www.figma.com/design/sC8GCHqw0wOFYVWvHwruCv/UpBase.vn-2026?node-id=1-319