Macro: một nơi gom email, chat, task, CRM 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ề macro-inc/macro — 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: macro-inc/macro: không gian làm việc gộp email, chat, task, CRM — hướng dẫn cài đặt và dùng →

Tóm tắt nhanh
Macro là một ứng dụng làm việc nhóm all-in-one, viết bằng Rust và SolidJS. Nó gộp email, chat, tài liệu, task, cuộc gọi, lịch và CRM vào một nơi, các thứ được @liên kết với nhau để AI agent hiểu bối cảnh. Dùng bản web thì chỉ cần đăng ký tài khoản, còn kết nối Claude Code qua MCP chỉ mất một dòng lệnh.
Macro là một không gian làm việc hợp nhất cho nhóm: email, tin nhắn, tài liệu, task, cuộc gọi, lịch, CRM và cơ sở dữ liệu nằm chung trong một giao diện. Mọi thứ trong đó đều có thể @liên kết với nhau và tìm kiếm được, nên cả người lẫn AI agent không phải nhảy qua lại giữa nhiều ứng dụng.
Hãy hình dung bạn đang dùng Slack để chat, Linear để quản lý việc, Notion để viết tài liệu, HubSpot để theo dõi khách hàng và Superhuman để đọc mail. Mỗi công cụ tốt, nhưng chúng không nói chuyện với nhau. Nhóm tác giả từng gặp đúng chuyện này khi công ty lên khoảng 20 người, nên họ thiết kế lại phần mềm làm việc thành một hệ thống duy nhất. Theo README, đội khoảng 15 người của họ đã tự dùng sản phẩm này hai năm.
Repo hiện có khoảng 6289 sao và 590 fork, giấy phép AGPL-3.0, vẫn được cập nhật trong 3 tháng gần đây. Điểm đáng giá nhất với người mới: bạn có thể dùng Macro như một ứng dụng bình thường, và cho phép Claude Code, Codex hay bất kỳ MCP client nào đọc và thao tác trên không gian làm việc đó. Xem video ngắn bên dưới để thấy giao diện trước khi bắt tay vào.
macro-inc/macro
Macro là không gian làm việc gộp email, chat, tài liệu, task, cuộc gọi, CRM và AI agent vào một giao diện, dùng chung "bộ nhớ" của cả nhóm.
I.Macro làm được gì
Macro chia thành các "khối" (block) hoạt động như mảnh Lego. Mỗi khối được làm riêng cho đúng việc của nó, nhưng tất cả dùng chung một backend. Các liên kết giữa tài liệu với task, hay giữa tin nhắn với email, được lưu thành một đồ thị hai chiều. Từ một task bạn lần ngược lại được email hay tin nhắn đã sinh ra nó.
- Email nhiều tài khoản. Gom nhiều hộp thư vào một inbox, có phím tắt kiểu Superhuman (
j,k,eđể di chuyển), hộp thư dùng chung. Inbox còn trộn cả tin nhắn, @mention và việc cần làm vào cùng một danh sách, nên bạn chỉ xử lý một hàng đợi. - Chat gọn hơn. Vài câu trả lời đầu hiện thẳng, phần còn lại thu vào thread, nên kênh đông người vẫn đọc được. Bạn có thể thêm người ngoài nhóm vào chat. README cũng nói bạn kết nối được WhatsApp để đọc, trả lời và chia sẻ các cuộc trò chuyện được chọn ngay trong Macro.
- Task gắn với chat. Tạo task từ email, từ phím tắt
crồit, từ lệnh/tasktrong tài liệu, từ một dòng- [ ], hoặc gọi@Macrotrong kênh. Task có dự án, danh sách, bảng và view đã lưu. Bạn còn giao task cho agent. - Tài liệu markdown cộng tác thời gian thực. Dùng CRDT nên nhiều người sửa cùng lúc không bị xung đột, có lịch sử phiên bản, sửa offline rồi tự đồng bộ. Bạn @liên kết tới email, task, liên hệ, công ty ngay trong bài viết.
- CRM tự cập nhật. Hồ sơ công ty và liên hệ nằm cạnh chat và email. Khi ai đó @mention một công ty trong tin nhắn, hồ sơ đó tự có liên kết ngược về cuộc trò chuyện. Có pipeline, giai đoạn deal, bảng và danh sách.
- Cuộc gọi và lịch. Gọi video, chia sẻ màn hình, tự ghi hình, phiên âm, gán nhãn người nói và tóm tắt bằng AI. Lịch Google và Outlook gộp một chỗ, có link đặt lịch mà khách không cần tài khoản Macro.
- Cơ sở dữ liệu và canvas. Tự dựng bảng cho tuyển dụng, yêu cầu khách hàng hay lịch nội dung, có cột có kiểu, quan hệ và view đã lưu. Canvas là bảng 2D để thả link tới task, file và email.
- Agent và bộ nhớ chung. Bạn nhắn riêng cho agent, @mention nó trong kênh hoặc giao task cho nó. Agent có thể dùng mô hình Macro cung cấp, kết nối Cursor bằng key của bạn, hoặc đưa agent chạy trên máy bạn vào Macro qua macrod. Có routine chạy theo lịch hoặc theo sự kiện, và skill để lưu quy trình dùng lại.
II.Cần chuẩn bị gì
Tư liệu README mình có không liệt kê yêu cầu hệ thống cho người dùng cuối, nên mình chỉ nêu những gì có ghi:
- Tài khoản Macro. README có nút "Sign up", tức bạn đăng ký để dùng bản đã host sẵn.
- Nền tảng. Có bản web, ứng dụng iOS và ứng dụng Android.
- Nếu muốn nối Claude Code: cần đã cài Claude Code, vì lệnh kết nối là lệnh của Claude Code.
- Nếu muốn nối Cursor: README nói dùng API key của chính bạn.
- Nếu muốn đọc hoặc chạy mã nguồn: repo viết chủ yếu bằng Rust, có
rust-toolchain.toml,Cargo.toml,package.json,bun.lock,flake.nixvàjustfile. README phần mình có chưa nêu phiên bản cụ thể hay phần cứng yêu cầu.
Macro đọc email, tin nhắn, file và hồ sơ khách hàng. Khi cấp quyền cho một agent hay MCP client, bạn đang cho nó thấy những dữ liệu đó. Hãy thử trước trên không gian làm việc thử nghiệm, và đừng dán API key vào kênh chat chung.
III.Cài đặt từng bước
Macro khác nhiều repo khác: cách dùng chính là đăng ký tài khoản, không phải chạy một lệnh cài. Phần README mình có không ghi cách tự host. Vì vậy các bước dưới đây đi theo đường chắc chắn nhất.
- Đăng ký tài khoảnVào trang chủ macro.com và bấm Sign up
- Thử các khối cơ bảnKết nối email, tạo kênh, tạo task đầu tiên
- Nối Claude CodeChạy một lệnh claude mcp add để agent đọc workspace
- Làm theo hướng dẫn MCPXem trang MCP setup trong docs để biết quyền và công cụ
- Tải mã nguồn (tuỳ chọn)Clone repo nếu bạn muốn đọc code hoặc đóng góp
A.Đăng ký và vào Macro
Mở macro.com, bấm Sign up và tạo tài khoản. Bạn dùng được trên web, hoặc cài app iOS và Android từ cửa hàng ứng dụng. README không mô tả từng màn hình đăng ký, nên chi tiết đó bạn xem ở trang docs.macro.com.
B.Làm quen vài thao tác đầu
Sau khi vào, mình gợi ý thử đúng các thao tác README nhắc tới:
- Trong inbox, dùng
jvàkđể lên xuống,eđể xử lý một mục. - Bấm
crồitđể tạo task từ bất kỳ đâu. - Dùng
cmd+kđể nhảy tới một liên hệ hoặc công ty.
Phím cmd là của Mac. README không nói rõ phím tương ứng trên Windows, nên nếu không thấy hiệu quả, bạn xem phần phím tắt trong docs.
C.Nối Claude Code (hoặc MCP client khác) vào Macro
Mở terminal (trên Windows là PowerShell hoặc Terminal, trên Mac là Terminal) rồi chạy đúng lệnh trong README:
claude mcp add --transport http macro https://mcp-server.macro.com/mcpLệnh này đăng ký một MCP server tên macro vào Claude Code, kết nối qua HTTP. Chỗ người mới hay vấp: lệnh phải chạy ở terminal đã cài Claude Code, nếu không máy sẽ báo không tìm thấy lệnh claude. README cũng nói Codex hoặc MCP client khác dùng được, nhưng lệnh cho chúng không có trong tư liệu. Bạn xem trang "MCP setup" trong docs.macro.com.
D.Tải mã nguồn về xem (tuỳ chọn)
Nếu chỉ muốn đọc code hoặc đóng góp, bạn clone repo:
git clone https://github.com/macro-inc/macro.git
cd macroLệnh đầu tải toàn bộ repo về máy, lệnh thứ hai đi vào thư mục vừa tải. Phần README mình có chưa ghi lệnh build hay chạy cục bộ. Muốn biết, bạn mở CONTRIBUTING.md, thư mục docs/, justfile và flake.nix trong repo. Mình không đoán lệnh ở đây để tránh bạn gõ sai rồi mất công.
IV.Kiểm tra đã chạy được chưa
Với bản web hoặc app: đăng nhập được, thấy giao diện inbox, kênh và task là xong.
Với MCP: sau khi chạy lệnh claude mcp add, mở Claude Code và nhờ nó làm một việc đọc đơn giản, ví dụ "liệt kê các task đang mở của tôi trong Macro". Nếu agent trả về dữ liệu thật từ workspace của bạn thì kết nối đã thông. README không ghi một dòng đầu ra cụ thể để đối chiếu, nên đây chỉ là cách thử hợp lý của mình. Nếu agent báo chưa có quyền, quay lại trang MCP setup trong docs để xem bước xác thực.
V.Dùng vào việc thật
A.Chủ shop xử lý email khách và theo dõi đơn
Bạn bán hàng, mail khách đổ về hai ba hộp thư. Hãy gom các hộp thư vào một inbox, rồi dùng j, k, e để lướt qua. Gặp mail khiếu nại cần xử lý, bấm "task" ngay trên email để tạo task liên kết với nó. Bạn giao task cho nhân viên, hoặc cho agent soạn sẵn bản nháp trả lời để bạn đọc và sửa trước khi gửi. Kết quả: mail, việc cần làm và người phụ trách nằm chung một chỗ, không phải chụp màn hình gửi Zalo.
Công ty không "tính toán được" khi mỗi bộ phận giữ một công cụ riêng. Gộp chúng lại, AI mới có đủ bối cảnh để làm việc đàng hoàng.
Ông T
B.Nhân viên kinh doanh nhớ lịch sử từng khách
Bạn cần biết nhóm đã trao đổi gì với công ty Acme. Bấm cmd+k, gõ tên liên hệ hoặc công ty, và Macro hiện toàn bộ email, file và cuộc trò chuyện liên quan. Khi bàn về khách trong kênh, hãy @mention hồ sơ công ty để tin nhắn tự gắn vào hồ sơ. Sau này sếp hỏi "deal đó đến đâu rồi", bạn mở hồ sơ là thấy, khỏi hỏi lại từng người. Bạn cũng có thể nhờ agent: "Tóm tắt các trao đổi gần đây với Acme và đề xuất bước tiếp theo".
C.Nhân viên văn phòng chốt việc sau cuộc họp
Bạn bắt đầu cuộc gọi ngay trong kênh. Macro ghi hình, phiên âm, gán nhãn người nói và tóm tắt. Sau họp, giao cho agent: "Dựa vào cuộc gọi hôm nay, viết email follow-up và tạo task cho từng người". Agent dùng ngữ cảnh cuộc gọi để làm, rồi bạn duyệt lại. Còn nếu có việc lặp lại, như cập nhật bảng theo dõi mỗi sáng, bạn tạo routine để nó chạy theo lịch. README kể chính đội Macro dùng routine hằng ngày để cập nhật một tài liệu markdown trong văn phòng.
D.Lập trình viên để Claude Code đọc ngữ cảnh khách hàng
Bạn đã chạy lệnh MCP ở trên. Giờ khi nhận một ticket, bạn nhờ Claude Code: "Đọc task này trong Macro và email khách đã gắn với nó, rồi đề xuất cách sửa". Nhờ liên kết hai chiều, bạn lần được chuỗi từ lý do làm việc này, đến task, đến agent, đến pull request. README nói pull request cũng được liên kết với task và agent dùng được. Với dev, đây là cách đưa bối cảnh thật của khách vào trình soạn code thay vì copy dán thủ công.
VI.Lỗi hay gặp và cách xử lý
- Báo không có lệnh
claude. Claude Code chưa cài, hoặc bạn mở terminal khác. Cài Claude Code trước rồi mở lại terminal. Nếu vẫn lỗi, kiểm tra lại bằng cách gõclaudexem có chạy không. - Kết nối MCP xong nhưng agent không thấy dữ liệu. Thường là chưa xác thực hoặc chưa cấp quyền. Làm lại theo trang MCP setup trong docs.macro.com, đừng tự thêm cờ lệnh mà README không ghi.
- Phím tắt không chạy. Hướng một trang tin tức cho Mac (
cmd+k). Trên Windows, thửctrlthaycmd, hoặc tra danh sách phím tắt trong docs. Mình chưa có xác nhận từ README về phím tương ứng. - Clone về nhưng không biết chạy thế nào. Đây là bình thường: README bản mình có chưa ghi cách tự host. Mở
CONTRIBUTING.md,docs/,justfiletrước. Repo lớn, nhiều dịch vụ, có thể cần nhiều công cụ, nên đừng kỳ vọng chạy được trong năm phút. - Agent làm sai hoặc gửi nhầm. Hãy để agent soạn bản nháp để bạn duyệt rồi mới gửi, đúng như cách README mô tả với email hàng loạt. Với dữ liệu khách hàng, nên thử trên tài khoản thử nghiệm trước.
VII.Có nên dùng không
Điểm mạnh. Macro giải quyết đúng nỗi đau thật: công cụ rời rạc, thông tin lệch nhau. Liên kết hai chiều và bộ nhớ chung giúp agent có đủ ngữ cảnh. Có MCP nên bạn nối được Claude Code, Codex hoặc agent khác. Mã nguồn mở, viết bằng Rust và SolidJS nên đáng tin về tốc độ, ít nhất theo mục tiêu tác giả đặt ra.
Giới hạn. Đây không phải thư viện nhỏ cài một lệnh là xong. Đây là cả một nền tảng, và bạn phải chuyển thói quen làm việc sang nó. Giấy phép AGPL-3.0 có yêu cầu riêng nếu bạn sửa và cung cấp dịch vụ cho người khác, nên doanh nghiệp cần đọc kỹ. Tư liệu mình có chưa nêu giá, chưa nói rõ chi phí dùng mô hình AI đi kèm, và chưa có hướng dẫn tự host.
Khi nào chọn cách khác. Nếu nhóm bạn chỉ cần một thứ, ví dụ chỉ chat hoặc chỉ quản lý task, và đã hài lòng với công cụ hiện tại, việc chuyển cả hệ thống có thể không đáng. Nếu bạn cần tự host ngay, hãy đọc kỹ docs trong repo trước khi quyết định. Còn nếu bạn đang loay hoay vì dữ liệu nằm rải rác và muốn AI hiểu cả bức tranh, Macro rất đáng thử, bắt đầu từ bản web.
Câu hỏi thường gặp
Macro là gì và khác gì Slack hay Notion?
Macro gộp email, chat, tài liệu, task, cuộc gọi, lịch, CRM và cơ sở dữ liệu vào một giao diện. Khác với việc dùng riêng từng công cụ, mọi thứ trong Macro được @liên kết hai chiều và dùng chung bộ nhớ cho AI agent. Tác giả nói họ xây Macro vì các công cụ như Slack, Linear, Notion, HubSpot, Superhuman không làm việc cùng nhau như một hệ thống.
Macro có miễn phí không?
Tư liệu mình có chưa nêu giá hay gói dùng thử. Mã nguồn công khai theo giấy phép AGPL-3.0. Bạn xem trang chủ macro.com để biết chi phí của bản đã host sẵn.
Tôi có tự cài Macro trên máy hoặc server của mình được không?
Phần README mình có chưa ghi cách tự host. Repo có thư mục docs, file CONTRIBUTING.md, justfile và flake.nix, nên bạn có thể tìm hướng dẫn ở đó. Mình không có đủ thông tin để đưa lệnh cụ thể.
Dùng Macro với Claude Code hoặc Codex như thế nào?
README hướng dẫn kết nối Claude Code bằng lệnh claude mcp add --transport http macro https://mcp-server.macro.com/mcp. Codex hoặc MCP client khác cũng được nhắc là dùng được. Chi tiết quyền và công cụ có trong trang MCP setup của docs.macro.com.
Có cần GPU hay máy mạnh không?
Nếu dùng bản web hoặc app trên điện thoại thì tư liệu không nêu yêu cầu phần cứng riêng. Các mô hình AI do Macro cung cấp hoặc do agent bạn kết nối chạy. Với việc tự build mã nguồn, README phần mình có chưa nói yêu cầu cấu hình.
Dữ liệu email và chat của tôi có an toàn không?
Tư liệu mình có chưa mô tả chi tiết về bảo mật hay nơi lưu dữ liệu. Macro cho agent truy cập email, tin nhắn, file và hồ sơ khách hàng, nên bạn cần cân nhắc quyền cấp cho từng agent. Hãy đọc docs và chính sách của dịch vụ trước khi đưa dữ liệu nhạy cảm vào.
Dùng được trên Windows và điện thoại không?
README nhắc có bản web, ứng dụng iOS và ứng dụng Android. Vì có bản web nên bạn dùng được trên Windows qua trình duyệt. Tư liệu chưa nói về ứng dụng desktop riêng.


