Doop: bảng thiết kế nhiều người cho người và AI agent — hướng dẫn cài đặt và dùng
Bài này là một góc nhìn khác về kgoedecke/doop — 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: Doop: canvas thiết kế để người và AI agent cùng vẽ — hướng dẫn cài đặt và dùng →

Tóm tắt nhanh
Doop là một canvas thiết kế mã nguồn mở, nhiều người cùng chỉnh sửa theo thời gian thực. AI agent như Claude Code, Codex, ChatGPT hay Cursor kết nối qua MCP có sẵn để vẽ giao diện ngay trên canvas. Chạy thử trên máy bằng ba lệnh với bun, không cần cấu hình thêm.
Doop là một canvas thiết kế mã nguồn mở, cho phép nhiều người và nhiều AI agent cùng làm việc trên một bản thiết kế, nhìn thấy nhau trực tiếp. Tác giả định vị nó là bản mã nguồn mở thay thế cho Paper.design. Mỗi thiết kế nằm trong một Canvas có đường dẫn chia sẻ được, bên trong là các Frame (khung, giống artboard) hiển thị HTML thật.
Vấn đề Doop giải quyết khá rõ. Khi nhờ AI làm giao diện, bạn thường phải nhắn một câu lệnh, chờ kết quả, rồi tải lại trang để xem. Với Doop, bạn kết nối agent đang dùng (Claude Code, Codex, ChatGPT, Cursor, OpenCode hoặc bất kỳ ứng dụng nào hỗ trợ MCP) vào canvas. Sau đó bạn xem agent vẽ và chỉnh thiết kế ngay cạnh con trỏ chuột của mình.
Điểm đáng giá nhất là bạn không bị khoá vào một hãng AI nào. Doop còn có sẵn một agent riêng (Doop Agent) chạy trên tài khoản mô hình bạn tự kết nối. Repo hiện có khoảng 1995 sao và 246 fork, viết bằng TypeScript, giấy phép AGPL-3.0. Xem video ngắn bên dưới để thấy nó chạy thực tế.
kgoedecke/doop
Doop là bản mã nguồn mở thay thế Paper.design: canvas thiết kế nhiều người, nơi bạn và AI agent (Claude Code, Codex, Cursor…) cùng thiết kế trực tiếp qua MCP.
I.Doop làm được gì
- Canvas nhiều người cùng dùng. Bạn thấy con trỏ, trạng thái có mặt, ai đang sửa khung nào, trạng thái của agent và một bảng hoạt động. Có hoàn tác/làm lại, bình luận theo luồng trên từng phần tử hoặc trên cả canvas. Cả nhóm góp ý ngay trên bản thiết kế, không cần gửi ảnh chụp qua chat.
- Kết nối AI agent bằng MCP có sẵn. Doop có máy chủ MCP tích hợp. Agent làm việc với quyền đúng bằng người đã kết nối nó, và hiện lên canvas với con trỏ, trạng thái, nhiệm vụ riêng. Bạn kiểm soát được agent đang làm gì.
- Doop Agent có sẵn. Bạn xếp một thẻ việc hoặc gõ
@nhắc một vai trò, agent sẽ tự thiết kế. Nó chạy trên tài khoản mô hình bạn kết nối: gói ChatGPT, hoặc key của OpenAI, Claude, Gemini, DeepSeek, Kimi, OpenRouter. - Nhiều trang trong một canvas. Bạn chia khung thành các trang có tên trong bảng Layers, kéo để đổi thứ tự, mỗi trang có thể có màu nền riêng như trong Figma.
- Prototype bấm được. Bạn nối phần tử với khung khác (bấm, rê chuột, phím, hoặc trì hoãn), chọn kiểu chuyển cảnh, rồi bấm Play. Cũng có thể chia sẻ đường dẫn
/c/<id>/protođể người khác bấm thử luồng. - Trình chỉnh sửa canvas đầy đủ. Bạn vẽ khung, hình chữ nhật, hình tròn, đường pen (Bézier) và văn bản. Bạn chỉnh màu nền, chữ, bố cục flex, bo góc, xoay, dùng thước và đường gióng. Thu phóng từ 8% đến 1600%. Mỗi công cụ có một phím tắt (V chọn, H kéo canvas, F khung, R chữ nhật, O hình tròn, P pen, T chữ, C bình luận).
- Bộ nhớ thiết kế. Bạn ghim khung mẫu, ghi lại các quyết định, để hệ thống đề xuất quy tắc phong cách mà mọi agent đều theo. Nhờ vậy sản phẩm đồng nhất dù do nhiều agent làm.
- Riêng tư mặc định. Bạn mời người khác qua email hoặc chia sẻ link với quyền xem, bình luận hoặc sửa.
- Nhập và xuất. Nhập từ website hoặc từ một repo GitHub (Doop đọc màn hình, thành phần rồi tạo thẻ việc cho agent). Xuất PNG, JPG hoặc PDF vector. Mỗi khung còn có ảnh công khai dạng
/i/<frameId>.png?scale=2, cập nhật khi thiết kế đổi. - Duyệt màn hình để giao dev. Bạn đánh dấu khung là đã duyệt. Nếu HTML hoặc kích thước đổi, khung chuyển sang “Cần xem lại”.
Lưu ý: nhập/xuất Figma, Canva và Photoshop (PSD) hiện chỉ có ở bản Doop Cloud, không nằm trong bản mã nguồn mở.
II.Cần chuẩn bị gì
Theo README, bạn cần:
- bun: Doop cài và build bằng bun (
bun.locklà file khoá duy nhất). Bạn cài bun từ trang bun.sh. - Node: máy chủ chạy trên Node. Lệnh
bun run devvàbun run buildcòn đóng gói tiện ích Claude Desktop bằng một script Node, nên Node phải nằm trongPATH. README không ghi số phiên bản cụ thể. - Git, để tải mã nguồn về.
- Docker, chỉ khi bạn muốn tự chạy bản production bằng Docker.
- Không cần key để chạy thử. Mọi thứ chạy không cần cấu hình, dữ liệu lưu vào Postgres nhúng (PGlite) trong thư mục
data/pg. Agent bạn tự kết nối qua MCP không cần key riêng. - Tài khoản mô hình, chỉ khi muốn dùng Doop Agent có sẵn. Bạn kết nối trong phần Settings, bằng gói ChatGPT hoặc key của các nhà cung cấp kể trên.
- README không nêu yêu cầu GPU hay cấu hình máy tối thiểu.
Nếu chưa muốn cài gì, README nói có bản chạy sẵn tại doop.design.
III.Cài đặt từng bước
- Cài bun và NodeChuẩn bị công cụ để cài và chạy Doop
- Tải mã nguồnDùng git clone rồi vào thư mục doop
- Cài thư việnChạy bun install
- Chạy thửChạy bun run dev, mở localhost:4300
- Kết nối agentDùng Connect AI trên thanh trên cùng
- Tự host bằng DockerTuỳ chọn, cho bản production
A.Cài bun và Node
Cài bun theo hướng dẫn ở trang bun.sh. Bạn cũng cần Node có sẵn trong PATH. README chưa ghi lệnh cài bun, nên hãy làm theo trang chủ của bun. Vấp thường gặp là cài xong mà terminal vẫn báo không tìm thấy lệnh. Khi đó bạn đóng terminal rồi mở lại.
B.Tải mã nguồn
Mở terminal (PowerShell hoặc Terminal) ở thư mục bạn muốn đặt dự án, rồi chạy:
git clone https://github.com/kgoedecke/doop && cd doopLệnh này tải mã nguồn về và đi vào thư mục doop. Các lệnh ở các bước sau đều phải chạy trong thư mục này.
C.Cài thư viện
bun installBun sẽ tải các thư viện dự án cần. Lần đầu có thể mất một lúc tuỳ đường truyền.
D.Chạy thử
bun run devSau khi chạy, mở hai địa chỉ theo README:
- Ứng dụng web:
http://localhost:4300 - API, WebSocket và máy chủ MCP:
http://localhost:4400(cổng web tự chuyển các đường dẫn như/api,/ws,/mcpsang đây)
Để cửa sổ terminal mở trong lúc dùng. Tắt nó là Doop dừng.
E.Kết nối agent
Trong Doop, bấm Connect AI ở thanh trên cùng. Mục này hướng dẫn từng agent. Theo README, Claude Code kết nối bằng lệnh claude mcp add rồi đăng nhập OAuth trong trình duyệt. Codex dùng codex mcp add. Claude web/desktop và Cursor có nút Add to Claude và Add to Cursor. ChatGPT dùng một máy chủ MCP tuỳ chọn. README trong tư liệu này không ghi đầy đủ đối số cho hai lệnh trên, nên hãy làm đúng theo hướng dẫn hiển thị trong Connect AI, đừng tự đoán.
F.Tự host bằng Docker (tuỳ chọn)
Để chạy bản production, README đưa lệnh sau (ứng dụng và Postgres chạy ở cổng 4400):
BETTER_AUTH_SECRET=$(openssl rand -hex 32) docker compose up -dLệnh này tạo một chuỗi bí mật ngẫu nhiên cho đăng nhập rồi khởi động bằng Docker Compose. Cú pháp này dành cho terminal kiểu bash. Trên PowerShell thuần bạn nên chạy trong Git Bash hoặc WSL. Cách khác không dùng Docker:
bun run build && bun run startLệnh này chạy một máy chủ duy nhất ở cổng 4400 phục vụ mọi thứ. Muốn dùng Postgres thật, đặt biến DATABASE_URL.
IV.Kiểm tra đã chạy được chưa
- Terminal chạy
bun run devkhông báo lỗi đỏ và vẫn đang chạy. - Mở
http://localhost:4300thấy giao diện Doop. Sau khi đăng nhập, bạn vào trang Home. Tại đây bạn mô tả thứ muốn làm, Doop tạo canvas và xếp sẵn các bản nháp cho Doop Agent. - Với canvas đầu tiên, README nói phần chào mừng là một màn trình diễn có kịch bản, chạy không cần tài khoản mô hình nào. Nếu thấy nó chạy, bản cài của bạn đã ổn.
- Thư mục
data/pgxuất hiện trong dự án, nghĩa là dữ liệu đang được lưu. - Với agent: sau khi kết nối trong Connect AI, agent hiện trên canvas với con trỏ và trạng thái riêng.
V.Dùng vào việc thật
A.Chủ shop dựng trang bán hàng nhanh
Bạn là chủ một shop nhỏ, cần bản nháp trang giới thiệu sản phẩm. Vào Home, mô tả bằng lời thứ bạn muốn. Doop tạo canvas và xếp thẻ việc cho Doop Agent (cần đã kết nối một tài khoản mô hình trong Settings). Bạn xem các khung hiện dần ra, rồi tự chỉnh chữ, màu, khoảng cách bằng tab Design. Kết quả là vài khung HTML thật, xuất được ra PNG hoặc PDF để gửi người khác duyệt.
Agent không còn làm trong bóng tối: bạn thấy nó vẽ, bạn chỉnh tay ngay cạnh nó.
Ông T
B.Lập trình viên dùng Claude Code vẽ giao diện
Bạn đang dùng Claude Code. Kết nối nó với Doop qua Connect AI. Sau đó nhờ nó thiết kế màn hình đăng nhập trên canvas của bạn. Bạn theo dõi trực tiếp, bình luận vào phần tử chưa ưng bằng cách @mention một vai trò (ví dụ @doop) để xếp thẻ việc sửa tiếp. Khi ưng ý, bạn đánh dấu khung là “Mark ready for dev”. Mỗi phần tử có “Copy link”, gồm selector CSS, để agent hoặc đồng nghiệp tìm đúng chỗ trong HTML.
C.Nhóm văn phòng góp ý và duyệt thiết kế
Bạn là nhân viên marketing cần thống nhất bản thiết kế với sếp và đối tác. Chia sẻ link canvas với quyền bình luận. Mọi người ghim góp ý lên đúng phần tử, tab Comments gom các luồng đang mở hoặc đã xử lý. Ai bỏ lỡ bình luận sẽ nhận email tóm tắt. Bạn cũng nối các khung thành prototype để sếp bấm thử luồng qua /c/<id>/proto, không cần cài gì.
D.Kết nối Slack hoặc Linear (tuỳ chọn)
README ghi mục Integrations hỗ trợ Slack: nhắc @Doop kèm một bản mô tả, Doop thiết kế một canvas rồi đăng kết quả vào luồng trò chuyện. Với Linear, bạn giao một issue cho Doop, nó thiết kế và báo kết quả về Linear. Cách thiết lập chi tiết nằm trong tài liệu của repo (thư mục docs/).
Không dán key API vào canvas, bình luận hay prompt. Key mô hình chỉ nhập ở phần Settings. Nếu tự host cho cả nhóm, hãy đặt BETTER_AUTH_SECRET riêng và giữ kín. Dùng Doop Agent hoặc agent bên ngoài có thể tốn phí theo tài khoản mô hình bạn kết nối, nên hãy theo dõi chi phí.
VI.Lỗi hay gặp và cách xử lý
- Lệnh
bunkhông nhận. Bạn chưa cài bun hoặc terminal chưa nhận. Cài bun theo trang chủ rồi mở lại terminal. bun run devbáo lỗi liên quan Node. README nói Node phải có trongPATHvì bước đóng gói tiện ích Claude Desktop dùng script Node. Kiểm tra bằngnode --version. README không ghi số phiên bản cụ thể, nên nếu lỗi vẫn còn, hãy xempackage.jsonvà tài liệu trong repo.- Không mở được trang. Kiểm tra terminal còn đang chạy và bạn mở đúng
http://localhost:4300. Nếu cổng bị chiếm bởi ứng dụng khác, hãy tắt ứng dụng đó rồi chạy lại. - Doop Agent không chạy. Doop Agent chỉ hoạt động sau khi bạn kết nối một tài khoản mô hình trong Settings. Nếu thiếu, hãy kiểm tra lại phần này trước.
- Lệnh Docker báo lỗi trên Windows. Cú pháp
BETTER_AUTH_SECRET=$(openssl rand -hex 32) docker compose up -ddành cho shell kiểu bash. Chạy trong Git Bash hoặc WSL. Đảm bảo Docker đang mở và máy cóopenssl.
VII.Có nên dùng không
Điểm mạnh: mã nguồn mở, chạy thử được chỉ bằng ba lệnh, không cần cấu hình. Làm việc với nhiều agent khác nhau thay vì một hãng. Nhiều người cùng thấy nhau trên canvas, kèm bình luận, prototype, xuất PDF/PNG và bộ nhớ thiết kế. Bạn có thể tự host để giữ dữ liệu trong tay.
Giới hạn: đây là công cụ cần chút kiến thức kỹ thuật để cài, nhất là phần kết nối agent và Docker. Figma, Canva, PSD chưa có trong bản mã nguồn mở. Giấy phép AGPL-3.0 có ràng buộc riêng nếu bạn định dùng cho dịch vụ của công ty, nên hãy đọc kỹ trước khi triển khai rộng. Chất lượng thiết kế còn phụ thuộc agent và mô hình bạn chọn.
Khi nên chọn cách khác: nếu bạn chỉ cần vẽ giao diện một mình, chưa dùng AI agent hay MCP, thì công cụ thiết kế quen thuộc là đủ. Nếu ngại cài đặt, README nói có bản chạy sẵn tại doop.design để bạn thử trước.
Câu hỏi thường gặp
Doop có miễn phí không?
Mã nguồn mở theo giấy phép AGPL-3.0, bạn tự cài và chạy trên máy mình. Bản chạy sẵn tại doop.design là bản Doop Cloud, README không nêu giá. Dùng Doop Agent hoặc agent bên ngoài có thể phát sinh chi phí tuỳ tài khoản mô hình bạn kết nối.
Doop có chạy được trên Windows không?
README không nêu riêng hệ điều hành. Các lệnh cài đặt dùng bun và Node. Lệnh Docker trong README có cú pháp kiểu bash, nên trên Windows bạn nên chạy trong Git Bash hoặc WSL.
Cần GPU hoặc key API để chạy thử không?
README không nhắc yêu cầu GPU. Chạy thử bằng bun run dev không cần cấu hình hay key. Key hoặc tài khoản mô hình chỉ cần khi muốn dùng Doop Agent có sẵn. Agent bạn tự kết nối qua MCP không cần key riêng.
Doop dùng được với những AI agent nào?
Theo README: Claude Code, Claude web và desktop, Codex, ChatGPT, Cursor, OpenCode, VS Code Copilot, OpenClaw và mọi ứng dụng hỗ trợ MCP. Agent chạy không giao diện như n8n, Mastra hay CI kết nối bằng agent key. Doop Agent có sẵn chạy trên GPT, Claude, Gemini, DeepSeek, Kimi hoặc Qwen.
Dữ liệu thiết kế lưu ở đâu, có an toàn không?
Khi chạy thử, dữ liệu lưu vào Postgres nhúng (PGlite) trong thư mục data/pg trên máy bạn. Bạn có thể đặt DATABASE_URL để dùng Postgres thật. Canvas riêng tư mặc định, agent chỉ có quyền đúng bằng người đã kết nối nó. README trong tư liệu này không nói về chứng nhận bảo mật.
Doop khác gì Paper.design?
Tác giả giới thiệu Doop là bản mã nguồn mở thay thế Paper.design, và bạn có thể tự host. README không đưa bảng so sánh chi tiết tính năng giữa hai bên.
Doop có nhập hoặc xuất Figma được không?
Nhập/xuất Figma, Canva và Photoshop hiện chỉ có ở Doop Cloud, không nằm trong bản mã nguồn mở. Bản tự host có nhập từ website hoặc repo GitHub và xuất PNG, JPG, PDF.


