Bỏ qua tới nội dung
Ông T.vn

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

12 phút đọcCập nhật
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 không gian làm việc tất cả-trong-một cho nhóm: email, tin nhắn, tài liệu, task, cuộc gọi, CRM và agent AI nằm chung một chỗ, liên kết với nhau bằng @. Bạn đăng ký dùng bản chạy sẵn trên web hoặc app điện thoại, rồi có thể nối Claude Code qua MCP bằng đúng một lệnh. README chưa ghi rõ cách tự dựng máy chủ, nên bài này tập trung vào cách dùng thực tế.

Macro là một không gian làm việc tất cả-trong-một cho nhóm: email, tin nhắn, tài liệu, task, cuộc gọi, lịch, CRM và AI agent nằm chung một giao diện. Mọi thứ liên kết với nhau bằng dấu @, và cả nhóm lẫn agent dùng chung một "bộ nhớ" về công việc đang diễn ra. Repo hiện có khoảng 6277 sao và 589 fork, viết chủ yếu bằng Rust, giấy phép AGPL-3.0.

Nếu công ty bạn đang dùng mỗi việc một app (chat một nơi, task một nơi, khách hàng một nơi, email một nơi) và thấy thông tin cứ rơi rụng giữa các app, thì Macro đáng để xem. Nhóm tác giả kể họ tự dùng nội bộ khoảng hai năm, với đội khoảng 15 người, trước khi mở ra cho người khác.

Điểm đáng giá nhất là cách lưu dữ liệu. Một email, một tin nhắn, một task, một hồ sơ khách hàng được nối với nhau trong một đồ thị hai chiều. Từ task, bạn lần ngược ra được email khách hàng đã sinh ra nó. Điều này giúp agent AI hiểu bối cảnh, thay vì bạn phải dán lại thông tin vào từng cuộc trò chuyện. Bạn có thể xem video ngắn bên dưới để thấy giao diện trước khi đọc tiếp.

Ứng dụng

macro-inc/macro

Macro gộp email, chat, tài liệu, task, cuộc gọi, CRM và AI agent vào một giao diện, có bộ nhớ chung cho cả nhóm. Viết bằng Rust và SolidJS.

★ 6.3kRustAGPL-3.0
Xem repo trên GitHub
Video giới thiệu macroXem trên YouTubeXem trên Facebook

I.Macro làm được gì

Macro chia thành các "khối" (block) như mảnh ghép Lego, nhưng tất cả dùng chung một backend. Dưới đây là những khối bạn sẽ dùng nhiều nhất.

A.Email nhiều tài khoản

Bạn gom nhiều hộp thư vào một hộp thư chung và dùng phím tắt kiểu Superhuman: j, k để di chuyển, e để xử lý. Hộp thư hợp nhất còn hiện cả tin nhắn, @mention và task cần làm, nên bạn chỉ phải xem một danh sách. Bạn cũng soạn, sửa và gửi email ngay trong khung chat AI mà không cần mở hộp thư.

Macro có cửa sổ chia đôi, chia ba (số lượng tuỳ cỡ màn hình), nên bạn vừa soạn thư vừa xem các thư cũ. Bạn có thể bấm "Share" để chia sẻ một email cho kênh hoặc người khác, khỏi 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 ngay, phần còn lại gập vào luồng thảo luận. 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ẻ một số cuộc trò chuyện ngay trong Macro.

C.Task nằm ngay trong cuộc trò chuyện

Task được tạo từ nhiều nơi: từ email, phím c rồi t, lệnh /task trong tài liệu, bôi đen một dòng - [ ] rồi bấm "Task", hoặc @Macro trong kênh. Task có nhóm dự án, danh sách, bảng kanban và các "saved view". Bạn giao task cho người hoặc cho agent. Agent dùng bối cảnh gắn với task để làm và cập nhật trạng thái.

D.Tài liệu markdown làm việc chung

Tài liệu viết theo markdown, cộng tác thời gian thực dựa trên CRDT, có lịch sử phiên bản, chỉnh sửa offline rồi tự hợp nhất. Bạn @ tới email, task, tin nhắn, công ty, liên hệ ngay trong tài liệu, và nhúng cả khung nhìn cơ sở dữ liệu vào. Agent cũng sửa tài liệu như một cộng tác viên, kể cả khi tài liệu đang đóng.

E.Cơ sở dữ liệu, Canvas, Lịch, Cuộc gọi

  • Databasestự 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à saved view.
  • Canvasbảng 2D, nhúng link tới task, file, email.
  • Calendargộp nhiều lịch Google và Outlook, có link đặt lịch để khách không cần tài khoản Macro.
  • Callsgọ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.

F.CRM tự cập nhật

CRM nằm cùng chỗ với chat và email. Khi @ một công ty hay liên hệ trong tin nhắn, giữa tin nhắn và hồ sơ có liên kết hai chiều. Bạn có thể xem lại mọi email, file, task, cuộc gọi liên quan tới công ty đó. Có sẵn pipeline và các giai đoạn deal dạng bảng hoặc danh sách.

G.Agent và bộ nhớ chung

Bạn nhắn riêng cho agent, @ agent trong kênh, hoặc giao task cho nó. Bạn dùng mô hình do Macro cung cấp, nối Cursor bằng API key của bạn, hoặc đưa agent chạy trên máy mình vào Macro qua macrod. Ngoài ra còn có "routines" (việc chạy theo lịch hoặc theo sự kiện) và "skills" (hướng dẫn dùng lại được). Macro cũng tự xây bộ nhớ từ email, chat, task, tài liệu.

II.Cần chuẩn bị gì

Tư liệu README nói khá ít về yêu cầu kỹ thuật, nên mình chỉ nêu những gì có:

  • Một tài khoản Macro: README có nút "Sign up", và Macro cũng có ứng dụng iOS, Android và bản web.
  • Claude Code (hoặc Codex, hoặc client MCP nào đó), nếu bạn muốn nối agent lập trình vào không gian làm việc.
  • API key riêng: chỉ khi bạn muốn nối Cursor bằng key của mình.
  • Tài khoản email, lịch, WhatsApp của bạn, nếu muốn kết nối chúng vào Macro.
  • Terminal: PowerShell, Terminal macOS hoặc bash đều được, để chạy lệnh nối MCP.

README phần được cung cấp chưa nêu phiên bản Node, Rust hay yêu cầu phần cứng. Nếu bạn định tự biên dịch mã nguồn, hãy xem CONTRIBUTING.md, justfile và thư mục docs/ trong repo. Các file rust-toolchain.toml, flake.nix và bun.lock ở gốc repo cho thấy dự án dùng Rust, Nix và Bun.

Macro đọc email, chat, lịch và có thể cả WhatsApp của bạn. Trước khi kết nối, hãy hỏi người quản trị bên bạn xem nhóm cho phép gì. Khi nối agent hoặc MCP, bạn cũng đang cho công cụ đó quyền truy cập vào không gian làm việc, nên chỉ nối công cụ bạn tin tưởng.

III.Cài đặt từng bước

Với người dùng thông thường, "cài" Macro nghĩa là đăng ký tài khoản rồi nối thêm công cụ. README chưa ghi cách tự dựng máy chủ riêng, nên mình không đoán lệnh nào cho phần đó.

  1. Đăng kýTạo tài khoản Macro trên web hoặc app điện thoại
  2. Kết nối dữ liệuThêm email, lịch hoặc WhatsApp nếu cần
  3. Nối Claude CodeChạy một lệnh để thêm MCP server của Macro
  4. Thử agentNhắn cho agent hoặc ra lệnh từ Claude Code
  5. (Tuỳ chọn) Lấy mã nguồnClone repo để đọc hoặc đóng góp

A.Đăng ký tài khoản

Vào trang chủ macro.com và bấm Sign up. Bạn cũng tải được ứng dụng Macro trên iOS hoặc Android, hoặc dùng bản web. Không có lệnh nào cần chạy ở bước này. Nếu cả nhóm cùng dùng, hãy để một người tạo không gian làm việc trước rồi mời mọi người vào.

B.Kết nối email, lịch, WhatsApp

Trong Macro, bạn thêm tài khoản email (hợp nhất nhiều hộp thư), lịch Google hoặc Outlook, và tuỳ chọn WhatsApp. Các thao tác này làm bằng giao diện, không cần dòng lệnh. Chỗ người mới hay vấp là kết nối nhầm tài khoản (ví dụ dùng email cá nhân thay vì email công việc). Hãy kiểm tra kỹ trước khi cho phép.

C.Nối Claude Code vào Macro bằng MCP

Đây là lệnh duy nhất có trong README. Mở terminal bất kỳ (nơi lệnh claude đã chạy được) và dán:

Terminal
claude mcp add --transport http macro https://mcp-server.macro.com/mcp

Lệnh này đăng ký một MCP server tên macro với Claude Code qua giao thức HTTP. Sau đó Claude Code có thể dùng các công cụ của Macro. Tên macro là tên bạn đặt cho kết nối, bạn không cần cài thêm gì. Với Codex hay client MCP khác, README chỉ nói "point ... at your workspace" và chưa ghi lệnh cụ thể. Hãy xem trang hướng dẫn MCP trên docs.macro.com.

Bạn có thể phải đăng nhập hoặc cấp quyền lần đầu dùng. README chưa mô tả bước này, nên nếu thấy cửa sổ xin quyền, hãy đọc kỹ rồi hãy đồng ý.

D.(Tuỳ chọn) Lấy mã nguồn về xem

Nếu bạn là lập trình viên muốn đọc code hoặc đóng góp:

Terminal
git clone https://github.com/macro-inc/macro.git
cd macro

Lệnh đầu tải repo về máy, lệnh thứ hai đi vào thư mục vừa tải. Để biết cách build và chạy thử, hãy mở CONTRIBUTING.md, justfile, CODING.md và thư mục docs/. README phần mình có chưa ghi các lệnh này. Repo có gói npm tên @macro-inc/macro, nhưng README chưa nói cách dùng nó, nên mình không đưa lệnh cài.

IV.Kiểm tra đã chạy được chưa

Vì README không đưa lệnh kiểm tra chính thức, đây là cách kiểm tra hợp lý dựa trên những gì Macro làm:

  1. Bản web hoặc app: đăng nhập được, thấy hộp thư hợp nhất, kênh chat, tab task. Gửi thử một tin nhắn và tạo thử một task bằng c rồi t.
  2. Liên kết: gõ @ trong một tài liệu và thấy danh sách email, task, công ty để chọn. Nếu thấy, nghĩa là đồ thị liên kết đang chạy.
  3. MCP: sau khi chạy lệnh claude mcp add, mở Claude Code và nhờ nó liệt kê task hoặc tìm một email trong Macro. Nếu trả về dữ liệu thật từ không gian làm việc của bạn, kết nối đã thành công.
  4. Agent: DM một agent và nhờ tóm tắt một kênh. Có kết quả bám sát nội dung kênh là ổn.

Nếu bước 3 không ra gì, xem mục lỗi ở dưới.

V.Dùng vào việc thật

Việc khó nhất của công ty nhỏ không phải thiếu công cụ, mà là thông tin nằm rải rác. Macro thử gom tất cả vào một chỗ.

Ông T

A.Chủ shop xử lý email khách và giao việc cho nhân viên

Bối cảnh: bạn có một shop online, nhận email hỏi hàng và khiếu nại từ hai hộp thư (một chung, một riêng).

Cách làm: thêm cả hai hộp thư vào Macro để xem chung một danh sách. Mở email khiếu nại, bấm "task" để tạo task có liên kết ngược tới email. Giao cho nhân viên và Share email vào kênh hỗ trợ.

Kết quả: nhân viên mở task là thấy ngay email gốc, bạn không phải chuyển tiếp hay chụp màn hình. Sau này tìm lại "vì sao có task này" chỉ mất vài giây.

B.Nhân viên kinh doanh theo dõi khách hàng

Bối cảnh: bạn quản vài chục khách, thông tin deal nằm trong email và tin nhắn nhóm.

Cách làm: tạo hồ sơ công ty và liên hệ trong CRM, đặt pipeline theo các giai đoạn bạn dùng. Khi trao đổi trong kênh, gõ @ tên công ty. Muốn xem lại, nhấn cmd+k rồi gõ tên liên hệ hoặc tên miền công ty để thấy mọi email liên quan.

Kết quả: hồ sơ khách tự dồn các email, file, task, cuộc gọi liên quan, bạn không phải cập nhật tay. Đến buổi họp deal, bạn chỉ cần mở một hồ sơ.

C.Dev dùng Claude Code đọc task và email

Bối cảnh: bạn là lập trình viên, muốn Claude Code lấy bối cảnh từ yêu cầu của khách trước khi sửa lỗi.

Cách làm: chạy lệnh MCP ở trên, rồi nhắn thử cho Claude Code:

text
Tìm các task đang mở liên quan đến lỗi đăng nhập và tóm tắt email khách hàng gắn với từng task.

Kết quả: agent lấy được task kèm email, chat gắn với nó, thay vì bạn phải copy từng thứ. README cũng nói agent có thể đi tiếp từ task tới pull request. Hãy luôn xem lại kết quả trước khi merge.

D.Quản lý nhóm dùng agent soạn báo cáo định kỳ

Bối cảnh: mỗi tuần bạn phải tổng hợp tiến độ từ nhiều kênh chat vào một tài liệu.

Cách làm: tạo một tài liệu markdown cho bản tổng hợp, rồi tạo một "routine" cho agent chạy theo lịch. README kể nhóm tác giả dùng routine hằng ngày để cập nhật tài liệu "Pool Games" bằng cách quét các kênh. Nếu người khác đã sửa, agent biết và bỏ qua. Bạn viết yêu cầu bằng ngôn ngữ thường, ví dụ "quét các kênh dự án, ghi các việc đã xong vào mục Tuần này".

Kết quả: tài liệu luôn có bản cập nhật, còn mâu thuẫn khi nhiều người cùng sửa do CRDT xử lý.

VI.Lỗi hay gặp và cách xử lý

A.Lệnh claude không được nhận ra

Báo "command not found" nghĩa là Claude Code chưa được cài hoặc terminal chưa nhận. Mở terminal mới sau khi cài, kiểm tra Claude Code chạy được rồi mới dán lại lệnh MCP. Mình không đưa lệnh cài Claude Code vì nó không nằm trong tư liệu repo này.

B.Thêm MCP rồi nhưng agent không thấy dữ liệu

Có thể bạn chưa đăng nhập hoặc chưa cấp quyền cho kết nối. Mở lại Claude Code, kiểm tra danh sách MCP server đang có, và xem lại trang hướng dẫn MCP trên docs.macro.com. Nếu cần gỡ rồi thêm lại, hãy làm theo hướng dẫn của Claude Code. Đừng dán token hay key lên chat công khai để nhờ hỗ trợ.

C.Kết nối nhầm tài khoản email hoặc lịch

Nếu bạn thấy thư công việc lẫn thư cá nhân, hãy ngắt kết nối tài khoản nhầm trong phần cài đặt rồi thêm lại đúng tài khoản. Lưu ý trước khi chia sẻ email vào kênh có người ngoài nhóm: người trong kênh đó sẽ thấy nội dung.

D.Tự dựng thử từ mã nguồn mà không biết bắt đầu từ đâu

README phần được đưa chưa có hướng dẫn tự host. Repo khá lớn (Rust, Bun, Nix, nhiều thư mục services/, infra/). Hãy đọc CONTRIBUTING.md, justfile và docs/ trước, và đừng chạy lệnh nào mình chưa hiểu, nhất là script hạ tầng. Hãy thử trên máy riêng, không phải máy chủ đang chạy thật.

E.Agent làm sai hoặc làm quá tay

Agent có thể soạn email, sửa tài liệu, đổi trạng thái task. Hãy bắt đầu bằng việc nhỏ, và duyệt bản nháp email trước khi gửi. README cũng mô tả luồng "bản nháp để bạn xem, sửa, rồi gửi", nên hãy dùng đúng luồng đó.

VII.Có nên dùng không

Điểm mạnh:

  • Gộp email, chat, task, tài liệu, CRM, lịch, cuộc gọi vào một nơi, giảm việc chuyển qua lại giữa nhiều app.
  • Liên kết hai chiều giúp lần ngược "vì sao làm việc này" rất nhanh.
  • Agent có bối cảnh thật của công ty, và nối được Claude Code hay client MCP bằng một lệnh.
  • Mã nguồn công khai, viết bằng Rust và SolidJS, repo còn cập nhật trong vài tháng gần đây.

Giới hạn:

  • Đây là nền tảng lớn, không phải công cụ nhỏ để thử trong năm phút. Chuyển cả nhóm sang là một quyết định về quy trình.
  • Giấy phép AGPL-3.0: nếu bạn định chỉnh sửa rồi cung cấp dịch vụ cho người khác, hãy đọc kỹ điều khoản trước.
  • Phần README mình có chưa nói rõ cách tự host, giá hay giới hạn gói dùng. Muốn biết, hãy xem trang chủ và docs.
  • Macro cần quyền vào email, lịch, chat của bạn, nên bạn cần cân nhắc về dữ liệu nhạy cảm.

Khi nào nên chọn cách khác: nếu bạn chỉ cần một thứ (ví dụ chỉ task, hoặc chỉ chat) và nhóm đã quen công cụ hiện tại, đổi sang Macro chưa chắc đáng. Nếu bạn chỉ muốn cho Claude Code đọc dữ liệu công việc, hãy thử lệnh MCP ở trên trước. Còn nếu nhóm đang khổ vì thông tin nằm rải rác ở 4-5 app, Macro đáng để dùng thử với một dự án nhỏ trước.

5.0/5 · Ông T chấm

Chưa có độc giả chấm

Bài này có ích với bạn không?

Câu hỏi thường gặp

Macro có miễn phí không?

Tư liệu README mình có chưa nói gì về giá hay gói dùng. Repo là mã nguồn mở theo giấy phép AGPL-3.0, còn bản dịch vụ trên web có tính phí hay không bạn nên xem trên trang chủ macro.com.

Macro có chạy trên điện thoại và Windows không?

README ghi Macro có ứng dụng iOS, ứng dụng Android và bản web, nên bạn dùng được trên trình duyệt ở Windows. README chưa có thông tin về app riêng cho máy tính hay hệ điều hành cần thiết khi tự build.

Làm sao nối Claude Code với Macro?

Chạy lệnh `claude mcp add --transport http macro https://mcp-server.macro.com/mcp` trong terminal. README cũng nói Codex hoặc client MCP bất kỳ đều nối được, nhưng không ghi lệnh cụ thể cho các client đó.

Dữ liệu của tôi có an toàn không?

Tư liệu chưa có phần mô tả về bảo mật hay nơi lưu dữ liệu. Macro truy cập email, chat, lịch và có thể cả WhatsApp, nên bạn nên đọc tài liệu trên docs.macro.com và hỏi quản trị bên bạn trước khi kết nối dữ liệu nhạy cảm.

Macro khác gì Slack, Notion, Linear hay HubSpot?

Các công cụ đó mỗi cái làm một việc, còn Macro gộp chat, tài liệu, task, CRM và email trong một hệ thống liên kết hai chiều. Nhóm tác giả nói họ từng dùng Slack, Linear, Notion, HubSpot, Superhuman và thấy chúng không phối hợp thành một hệ thống.

Có cần GPU hoặc cấu hình mạnh không?

README không nhắc yêu cầu phần cứng. Khi dùng bản web hay app, phần xử lý AI do dịch vụ đảm nhiệm. Nếu bạn tự build từ mã nguồn, hãy xem CONTRIBUTING.md trong repo.

Tôi có tự cài Macro trên máy chủ riêng được không?

Mã nguồn công khai, repo có các thư mục services, infra, docker. Nhưng phần README mình có chưa ghi cách tự host, nên bạn cần đọc CONTRIBUTING.md, justfile và docs trong repo.

Chuyển nhanh tới mục

  1. I.Macro làm được gì
    1. A.Email nhiều tài khoản
    2. B.Chat gắn với công việc
    3. C.Task nằm ngay trong cuộc trò chuyện
    4. D.Tài liệu markdown làm việc chung
    5. E.Cơ sở dữ liệu, Canvas, Lịch, Cuộc gọi
    6. F.CRM tự cập nhật
    7. G.Agent và bộ nhớ chung
  2. II.Cần chuẩn bị gì
  3. III.Cài đặt từng bước
    1. A.Đăng ký tài khoản
    2. B.Kết nối email, lịch, WhatsApp
    3. C.Nối Claude Code vào Macro bằng MCP
    4. D.(Tuỳ chọn) Lấy mã nguồn về xem
  4. IV.Kiểm tra đã chạy được chưa
  5. V.Dùng vào việc thật
    1. A.Chủ shop xử lý email khách và giao việc cho nhân viên
    2. B.Nhân viên kinh doanh theo dõi khách hàng
    3. C.Dev dùng Claude Code đọc task và email
    4. D.Quản lý nhóm dùng agent soạn báo cáo định kỳ
  6. VI.Lỗi hay gặp và cách xử lý
    1. A.Lệnh claude không được nhận ra
    2. B.Thêm MCP rồi nhưng agent không thấy dữ liệu
    3. C.Kết nối nhầm tài khoản email hoặc lịch
    4. D.Tự dựng thử từ mã nguồn mà không biết bắt đầu từ đâu
    5. E.Agent làm sai hoặc làm quá tay
  7. VII.Có nên dùng không

Repo & Skill · 13/11/2026 · 11 phút đọc

Garden Skills: bộ skill thiết kế web, tạo ảnh, làm video cho AI — hướng dẫn cài đặt và dùng

Garden Skills là bộ sưu tập Agent Skills (kỹ năng cho AI) của tác giả ConardLi, dùng được với Claude Code, Cursor, Codex và các AI coding agent khác. Mỗi skill dạy agent làm tốt một việc như thiết kế trang web, tạo ảnh, làm video bằng code, biến tài liệu thành bài viết đẹp. Cài không khó, nhưng README có nhiều cách cài nên bạn cần chọn một cách hợp với công cụ đang dùng.

Repo & Skill · 13/11/2026 · 15 phút đọc

thesysdev/openui: xây giao diện AI dạng streaming — hướng dẫn cài đặt và dùng

OpenUI là framework full-stack, độc lập framework, giúp mô hình AI sinh giao diện có cấu trúc và hiển thị dần khi dữ liệu streaming về. Bạn có thể dựng nhanh một ứng dụng chat bằng CLI hoặc cài từng gói cho React, Vue, Svelte, Angular và LangChain. Việc bắt đầu khá đơn giản nếu máy có đúng phiên bản Node; README chưa ghi đầy đủ lệnh chạy ứng dụng sau khi scaffold.

Repo & Skill · 13/11/2026 · 11 phút đọc

Ruflo: điều phối nhóm agent AI cho Claude Code và Codex — hướng dẫn cài đặt và dùng

Ruflo (trước đây là Claude Flow) là một agent harness: lớp công cụ bao quanh Claude Code và Codex, bổ sung nhiều agent chuyên biệt, bộ nhớ qua các phiên và khả năng chia việc cho nhóm agent. Cài bằng một lệnh `npx ruflo@latest init` trong thư mục dự án, cần Node 20 trở lên. Cài khá dễ, nhưng hệ thống rất rộng nên bạn nên bắt đầu từ một tác vụ nhỏ.