Macro: gom email, chat, task, CRM và AI agent vào một chỗ — 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à không gian làm việc tất-cả-trong-một cho nhóm: email, chat, tài liệu, task, cuộc gọi, lịch và CRM nằm chung một giao diện, có AI agent dùng chung bộ nhớ. Bạn có thể đăng ký dùng bản chạy sẵn, hoặc nối Claude Code, Codex hay bất kỳ MCP client nào vào workspace chỉ bằng một dòng lệnh. Việc nối MCP khá dễ; tự dựng cả hệ thống từ mã nguồn thì phức tạp hơn nhiều.
Macro là một không gian làm việc tất-cả-trong-một dành cho nhóm. Nó gom email, tin nhắn, 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 duy nhất. Mọi thứ liên kết với nhau bằng dấu @ và có chung một “bộ nhớ” để AI agent hiểu bối cảnh công việc của cả nhóm.
Nếu nhóm bạn đang dùng Slack để chat, Notion để ghi chú, Linear để quản lý việc, HubSpot để lưu khách hàng và một app riêng cho email, bạn sẽ quen cảnh này: thông tin nằm rải rác, phải copy qua lại, và task nhanh chóng lỗi thời. Macro thử giải quyết bằng cách đặt tất cả vào một hệ thống. Một email của khách có thể thành task, task giao cho agent, agent làm xong thì ra một bản cập nhật tài liệu hoặc pull request, và cả chuỗi đó đều truy ngược được.
Hiện repo có khoảng 6.289 sao và 590 fork, viết chủ yếu bằng Rust, giấy phép AGPL-3.0, và vẫn được cập nhật trong vài tháng gần đây. Điểm đáng giá nhất với người làm việc với AI là Macro mở một cổng MCP: bạn nối Claude Code, Codex hay công cụ MCP khác vào workspace chỉ bằng một dòng lệnh. Bạn có thể xem video ngắn bên dưới để thấy giao diện trước khi đọc tiếp.
macro-inc/macro
Macro gom email, chat, tài liệu, task, cuộc gọi, CRM và AI agent vào một không gian làm việc, liên kết bằng @ và có bộ nhớ AI chung cho cả nhóm.
I.Macro làm được gì
Macro chia công việc thành các “khối” (block) hoạt động như các mảnh Lego. Tất cả dùng chung một backend, nên tham chiếu giữa các khối được lưu thành một đồ thị hai chiều. Nói đơn giản: từ task bạn thấy được tin nhắn đã sinh ra nó, và từ tin nhắn bạn thấy task nào đã phát sinh.
A.Email nhiều tài khoản
Bạn gộp nhiều hộp thư vào một inbox, có chung hệ thống gắn thẻ và chia sẻ. Giao diện ưu tiên bàn phím: dùng j, k, e để duyệt. Trong cùng một danh sách có cả email, tin nhắn, @mention và việc cần làm. Muốn gửi một email cho đồng nghiệp, bạn bấm Share thay vì chụp màn hình.
B.Chat gắn với công việc
Kênh và tin nhắn riêng được thiết kế để dễ đọc hơn: vài trả lời đầu hiện thẳng, phần còn lại gập vào thread. README cũng nói bạn có thể thêm người ngoài nhóm vào chat, và kết nối WhatsApp để đọc, trả lời, chia sẻ các cuộc trò chuyện chọn lọc ngay trong Macro.
C.Task sinh ra ngay nơi đang trao đổi
Task kiểu Linear, nhưng tạo được từ nhiều chỗ: từ email, phím tắt c t, lệnh /task trong tài liệu, từ một dòng - [ ], bằng cách @Macro trong kênh, hoặc qua MCP, API, SDK. Bạn gom task vào dự án, giao cho người hoặc agent, theo dõi bằng danh sách, bảng và các view đã lưu.
D.Tài liệu markdown cộng tác thời gian thực
Tài liệu dùng markdown gốc, sửa chung theo thời gian thực (công nghệ CRDT), có lịch sử phiên bản, sửa offline rồi tự đồng bộ. Bạn @ được tới email, task, tin nhắn, công ty, liên hệ. Bạn cũng nhúng được một view cơ sở dữ liệu vào tài liệu và nó tự cập nhật.
E.CRM tự cập nhật theo công việc
Bản ghi công ty và liên hệ có thảo luận riêng. Khi bạn @mention một khách hàng trong tin nhắn hay task, hệ thống tạo liên kết hai chiều, nên sau này mở hồ sơ khách là thấy các cuộc trao đổi liên quan. Có pipeline và giai đoạn deal tuỳ chỉnh, xem dạng bảng hoặc danh sách.
F.Cơ sở dữ liệu, cuộc gọi, lịch
Bạn tự tạo bảng (tuyển dụng, yêu cầu khách hàng, lịch nội dung…) với cột có kiểu, quan hệ và view đã lưu. Cuộc gọi có video, chia sẻ màn hình, tự ghi âm, phiên âm có nhãn người nói và tóm tắt bằng AI. Lịch nối được nhiều tài khoản Google và Outlook, có link đặt lịch mà khách không cần tài khoản Macro.
G.Agent và bộ nhớ chung
Bạn nhắn riêng cho agent, @mention trong kênh, hoặc giao task cho nó. Agent có thể nghiên cứu khách hàng, soạn thư trả lời, cập nhật tài liệu, duy trì cơ sở dữ liệu, hoặc làm một task kỹ thuật tới tận pull request. Bạn dùng model do Macro cung cấp, nối Cursor bằng API key của riêng bạn, hoặc đưa agent chạy trên máy mình vào Macro qua macrod. Ngoài ra có “routine” để chạy theo lịch, và “skill” để lưu quy trình dùng lại.
II.Cần chuẩn bị gì
Tư liệu README chỉ rõ vài thứ sau:
- Một tài khoản Macro. README có nút đăng ký (Sign up) và trang chủ macro.com.
- Có ứng dụng iOS và Android, hoặc dùng trên web.
- Nếu muốn nối Claude Code: bạn cần đã có Claude Code và dùng được lệnh
claudetrong terminal. Codex hay MCP client khác cũng nối được. - Muốn dùng Cursor làm agent thì cần API key của bạn.
README phần được cung cấp không ghi yêu cầu hệ điều hành, phiên bản Node/Python hay phần cứng cho người dùng cuối. Nếu bạn định tự build mã nguồn thì repo có các tệp như Cargo.toml, rust-toolchain.toml, package.json, justfile, flake.nix; đọc các tệp này và CONTRIBUTING.md để biết chính xác phiên bản công cụ cần có.
Macro đọc email, chat, tài liệu và hồ sơ khách hàng của bạn. Khi nối agent hoặc MCP client vào workspace, bạn đang cho nó quyền xem và thao tác trên dữ liệu đó. Hãy thử trước với workspace nhỏ hoặc dữ liệu không nhạy cảm, và chỉ nối công cụ bạn tin tưởng.
III.Cài đặt từng bước
Có hai hướng. Hướng thứ nhất là dùng Macro đã chạy sẵn (đăng ký rồi nối agent qua MCP), đây là hướng dễ nhất. Hướng thứ hai là tải mã nguồn về xem hoặc đóng góp.
- Đăng ký tài khoảnVào trang Macro, bấm Sign up và tạo workspace
- Nối Claude Code vào MacroChạy một lệnh claude mcp add để thêm máy chủ MCP của Macro
- Đọc hướng dẫn MCPXem docs để biết agent làm được gì sau khi kết nối
- Tải mã nguồn (tuỳ chọn)git clone repo về nếu bạn muốn đọc code hoặc đóng góp
A.Đăng ký và tạo workspace
Vào trang chủ macro.com và bấm Sign up (README có nút này ở đầu trang). Sau khi có tài khoản, bạn tạo workspace và mời đồng đội. README không mô tả chi tiết từng màn hình đăng ký trong phần được cung cấp, nên bạn xem thêm phần docs của Macro nếu cần.
B.Nối Claude Code (hoặc Codex, MCP client khác) vào Macro
Mở terminal (Terminal trên macOS/Linux, PowerShell trên Windows), và chạy đúng lệnh trong README:
claude mcp add --transport http macro https://mcp-server.macro.com/mcpLệnh này nói với Claude Code: thêm một máy chủ MCP tên macro, nói chuyện qua giao thức HTTP, tại địa chỉ https://mcp-server.macro.com/mcp. Chỗ người mới hay vấp: lệnh claude phải có sẵn, tức bạn đã cài Claude Code trước. Với Codex hoặc client MCP khác, README chỉ nói chung là “bất kỳ MCP client nào”, nên bạn xem cách thêm máy chủ MCP của công cụ đó rồi dùng cùng địa chỉ trên.
Lần đầu dùng, công cụ có thể yêu cầu bạn đăng nhập hoặc cấp quyền cho workspace. README không mô tả bước này, vì vậy hãy làm theo hướng dẫn hiện ra trên màn hình.
C.Xem hướng dẫn MCP chi tiết
Sau khi nối, bạn xem trang “MCP setup” trong tài liệu của Macro (docs.macro.com, mục AI → MCP → overview) để biết các công cụ agent có thể gọi.
D.Tải mã nguồn (tuỳ chọn)
Nếu bạn là lập trình viên muốn đọc code hoặc đóng góp, dùng lệnh git phổ thông:
git clone https://github.com/macro-inc/macro.git
cd macroLệnh đầu tải toàn bộ mã nguồn về máy, lệnh sau đi vào thư mục vừa tải. README phần được cung cấp chưa ghi cách tự cài đặt hay tự host toàn bộ hệ thống. Repo là một dự án khá lớn (Rust, bun, hạ tầng, dịch vụ…), nên đừng đoán lệnh. Hãy mở CONTRIBUTING.md, justfile, flake.nix và thư mục docs/ để xem quy trình chính thức.
IV.Kiểm tra đã chạy được chưa
Với hướng dùng Macro có sẵn: đăng nhập vào ứng dụng web hoặc app di động và thấy workspace của bạn, gồm inbox, kênh chat, task. Đó là dấu hiệu tài khoản đã sẵn sàng.
Với phần MCP: trong terminal chạy lệnh liệt kê máy chủ MCP của Claude Code.
claude mcp listBạn nên thấy một mục tên macro trong danh sách. Rồi mở Claude Code và thử hỏi một câu đơn giản về workspace, ví dụ “liệt kê các task đang mở của tôi”. Nếu agent trả về dữ liệu thật từ Macro thì kết nối đã ổn. README không nêu sẵn đầu ra mẫu, nên đây là cách kiểm tra thực tế chứ không phải kết quả được tài liệu đảm bảo từng chữ.
V.Dùng vào việc thật
A.Chủ shop: biến email khiếu nại thành việc có người chịu trách nhiệm
Bạn là chủ một shop nhỏ, mỗi ngày nhận vài email của khách về đổi trả. Trước đây bạn chuyển tiếp email cho nhân viên rồi quên theo dõi. Với Macro, bạn mở email, bấm “task” để tạo task liên kết với email đó, giao cho nhân viên phụ trách. Nếu khách là một công ty, bạn @mention hồ sơ công ty của họ trong task.
Kết quả: sau này mở hồ sơ khách là thấy toàn bộ email, task và thảo luận liên quan, không cần lục lại hộp thư.
B.Nhân viên sale: biết deal đang ở đâu mà không phải hỏi ai
Bạn quản lý vài chục khách hàng tiềm năng. Bạn tạo pipeline với các giai đoạn deal, xem ở dạng bảng. Mỗi lần trao đổi trong kênh chat về một khách, bạn @mention công ty đó. Khi cần báo cáo, bạn mở hồ sơ công ty để xem email, file, task và cuộc gọi liên quan, hoặc nhờ agent tổng hợp.
Prompt mẫu cho agent: “Tóm tắt tình hình khách hàng Acme từ email và tin nhắn gần đây, rồi soạn một email theo dõi để tôi duyệt.”
Kết quả: một bản nháp email dựa trên bối cảnh thật. README nói agent chuẩn bị thư dưới dạng nháp để bạn xem, sửa và gửi, chứ không tự gửi.
Công việc thật diễn ra trong cuộc trò chuyện, nên task và hồ sơ khách phải nằm ngay cạnh cuộc trò chuyện đó.
Ông T
C.Lập trình viên: cho Claude Code đọc ngữ cảnh công việc
Bạn là dev trong nhóm nhỏ. Task kỹ thuật nằm trong Macro, kèm email khách và thảo luận. Bạn nối Claude Code bằng lệnh MCP ở trên, rồi yêu cầu: “Đọc task đang giao cho tôi, xem email và tin nhắn liên quan, rồi đề xuất cách làm.” README cũng nói Macro hướng tới chuỗi “vì sao làm → task → agent → pull request”, và pull request được liên kết với task.
Kết quả: agent có đủ ngữ cảnh mà bạn không phải dán từng đoạn chat vào prompt.
D.Nhân viên văn phòng: giữ tài liệu chung luôn mới bằng routine
Nhóm bạn có một tài liệu tổng hợp (ví dụ danh sách việc tuần, bảng theo dõi nội bộ). README kể ví dụ của chính đội Macro: một routine chạy hằng ngày quét các kênh rồi cập nhật tài liệu trò chơi bi-a của văn phòng, và nếu đã có người sửa tay thì nó nhận biết để tránh ghi đè. Bạn áp dụng cùng ý tưởng: tạo routine để agent quét các kênh và cập nhật tài liệu theo lịch.
Kết quả: một tài liệu luôn được cập nhật mà không ai phải nhớ làm. Cách tạo routine cụ thể bạn xem trong docs của Macro, vì README phần được cung cấp không ghi từng bước.
VI.Lỗi hay gặp và cách xử lý
A.Lệnh claude không được nhận ra
Terminal báo không tìm thấy lệnh claude. Nguyên nhân thường là bạn chưa cài Claude Code, hoặc cài rồi nhưng chưa mở lại terminal. Hãy cài Claude Code theo hướng dẫn chính thức của nó, mở terminal mới rồi chạy lại lệnh.
B.Đã thêm MCP nhưng agent không thấy dữ liệu
Hay xảy ra khi chưa đăng nhập hoặc chưa cấp quyền cho workspace. Chạy claude mcp list để chắc mục macro đã có, rồi làm theo bước xác thực hiện ra khi bạn gọi một công cụ của Macro. Nếu vẫn lỗi, xem trang MCP setup trong docs của Macro.
C.Agent đọc được hơn bạn tưởng
Đây không phải lỗi mà là rủi ro. Agent truy cập email, chat, tài liệu và CRM, nên có thể đưa thông tin nhạy cảm vào câu trả lời hoặc bản nháp. Hãy luôn đọc lại bản nháp trước khi gửi, và cân nhắc phạm vi dữ liệu trước khi cho một công cụ bên ngoài kết nối.
D.Clone về nhưng không biết chạy thế nào
Đúng như phần cài đặt đã nói, README chưa ghi cách tự host. Đừng chạy lệnh đoán mò hay thử lung tung trên máy làm việc. Hãy đọc CONTRIBUTING.md, justfile, flake.nix, thư mục docs/ và infra/. Nếu chỉ muốn dùng thì quay lại bản có sẵn.
E.Hiểu nhầm về giấy phép
Repo dùng AGPL-3.0. Nếu bạn định sửa mã rồi cung cấp thành dịch vụ cho người khác, hãy đọc kỹ giấy phép (tệp LICENSE.txt) hoặc hỏi người am hiểu pháp lý trước khi triển khai.
VII.Có nên dùng không
Điểm mạnh. Macro giải quyết đúng nỗi đau “công cụ rời rạc”. Việc liên kết hai chiều giữa email, chat, task, CRM và tài liệu giúp bạn truy ngược bối cảnh nhanh. Agent có cùng ngữ cảnh với người dùng, và cổng MCP một dòng lệnh làm việc nối Claude Code hay Codex rất gọn. Tác giả cũng nói đã dùng nội bộ với nhóm khoảng 15 người trong hai năm.
Giới hạn. Đây là một nền tảng rất rộng, nên có thể quá nặng nếu bạn chỉ cần một công cụ ghi chú hay một CRM đơn giản. Muốn đổi toàn bộ nhóm sang một hệ thống mới thì chi phí chuyển đổi và thói quen là có thật. README phần được cung cấp chưa nói gì về giá, gói miễn phí hay cách tự host, nên bạn nên kiểm tra trên trang chủ trước khi cam kết. Dữ liệu công việc nhạy cảm cũng đòi hỏi bạn cân nhắc quyền truy cập cho agent.
Khi nào nên chọn cách khác. Nếu nhóm bạn hài lòng với bộ công cụ hiện tại và chỉ cần thêm AI, hãy thử riêng phần MCP trước. Nếu bạn cần tự host hoàn chỉnh mà chưa có tài liệu rõ, hãy đọc kỹ mã nguồn và tài liệu đóng góp trước khi quyết định. Còn nếu bạn muốn thử cho biết, cứ đăng ký một workspace nhỏ với dữ liệu không quan trọng và dùng một tuần.
Câu hỏi thường gặp
Macro là gì, thay thế được những công cụ nào?
Macro là không gian làm việc gom email, chat, tài liệu, task, cuộc gọi, lịch, CRM và cơ sở dữ liệu vào một chỗ. Tác giả so sánh với bộ công cụ như Slack, Linear, Notion, HubSpot và Superhuman, và muốn thay chúng bằng một hệ thống liền mạch. Bạn có thể dùng toàn bộ hoặc chỉ một vài khối.
Macro có miễn phí không?
Mã nguồn có trên GitHub với giấy phép AGPL-3.0. Phần README được cung cấp không nói gì về giá hay gói miễn phí của dịch vụ có sẵn, nên chưa có thông tin chắc chắn. Bạn xem trang chủ macro.com để biết gói hiện tại.
Làm sao nối Claude Code với Macro?
README ghi một lệnh: claude mcp add --transport http macro https://mcp-server.macro.com/mcp. Chạy lệnh này trong terminal, sau đó làm theo bước đăng nhập nếu có. README cũng nói Codex và bất kỳ MCP client nào đều có thể nối vào workspace.
Có cần GPU hay máy cấu hình mạnh không?
Tư liệu không nhắc yêu cầu GPU hay phần cứng cho người dùng. Macro cung cấp sẵn các model AI và cũng cho phép nối Cursor bằng API key riêng của bạn, nên việc nặng không nằm trên máy bạn khi dùng bản có sẵn.
Dùng được trên Windows và điện thoại không?
README nói Macro có ứng dụng iOS, ứng dụng Android và bản web, nên dùng được từ trình duyệt trên Windows. Lệnh nối MCP chạy trong terminal; phần README được cung cấp không nêu yêu cầu hệ điều hành cụ thể cho lệnh đó.
Dữ liệu của tôi có an toàn không?
Tư liệu không có phần mô tả chi tiết về bảo mật hay mã hoá. Điều chắc chắn là agent và MCP client có quyền truy cập dữ liệu trong workspace, nên bạn chỉ nên kết nối công cụ tin cậy. Muốn biết chính sách bảo mật, hãy xem tài liệu và trang chủ của Macro.
Tôi có tự cài Macro trên máy chủ của mình được không?
Phần README được cung cấp chưa ghi cách tự cài hay tự host. Repo có các tệp như CONTRIBUTING.md, justfile, flake.nix và các thư mục infra, docker, docs, bạn nên xem ở đó. Chưa có thông tin chính thức trong tư liệu về độ khó của việc tự host.


