Hướng dẫn sử dụng PM Hub

1PM Hub là gì

Một website để người dẫn dự án (PM) và cả đội theo dõi cùng một sự thật: ai đang làm việc gì, việc nào trễ, tiền đã chi bao nhiêu, rủi ro nào đang nóng.

2Bắt đầu trong 5 phút

1. Đăng nhập bằng GoogleMở trang PM Hub và bấm Đăng nhập bằng Google. Dùng email công ty. Email thuộc tên miền công ty được vào ngay, không cần ai mời; email ngoài tên miền cần admin thêm trước.
2. Tạo dự án đầu tiênỞ màn Bắt đầu bấm Tạo dự án mới. Chọn loại, điền tên, ngày bắt đầu, ngày kết thúc (với sự kiện là Ngày diễn ra) và mô tả. Bấm Lập kế hoạch với AI (tốn phí AI) hoặc Dùng khung mẫu (miễn phí). Xem bản nháp, sửa hoặc bỏ gợi ý rồi bấm Tạo dự án.
3. Mời độiVào Nhân sự & team, bấm Mời người rồi nhập email. Người được mời đăng nhập Google là thấy dự án.
4. Giao việc và theo dõiVào Danh sách việc hoặc Kanban / Gantt để giao việc và đổi trạng thái. Mỗi tuần mỗi người nộp Cập nhật tuần ở Việc của tôi (khoảng 3 phút).

3Vai trò và quyền

Quyền được kiểm tra ở máy chủ, không chỉ ẩn nút trên giao diện. Bảng dưới là cách hiểu nhanh.

PM mới đăng ký chỉ thấy dự án của chính mình. Các dự án của PM khác không hiện trong danh sách, không mở được bằng đường dẫn, và không đọc được qua MCP.

4Các trang và việc chúng làm

Menu bên trái chia thành năm nhóm. Có trang chỉ hiện khi dự án bật module tương ứng (Cài đặt → Dự án này).

Của tôi

Dự án

Công việc

Tài chính & rủi ro

Quản trị & khác

5AI dùng ở đâu

AI chỉ chạy khi bạn bấm, và nút nào tốn phí đều ghi "tốn phí" hoặc "(có phí)". Khoá OpenRouter do admin cài một lần ở Cài đặt → Toàn workspace; chưa có khoá thì các nút AI không chạy và PM Hub dùng khung mẫu hoặc báo rõ lý do.

6Phím tắt

Bấm ? trong app để xem bảng đầy đủ. Phím tắt không chạy khi bạn đang gõ trong ô nhập.

7MCP là gì

MCP (Model Context Protocol) là chuẩn để cắm một trợ lý AI như Claude hay Cursor vào một hệ thống khác. Nối PM Hub qua MCP nghĩa là bạn có thể nói với trợ lý bằng tiếng Việt thường ngày và nó thao tác trực tiếp trên dự án của bạn.

Ví dụ bạn gõ với trợ lý:

• "Liệt kê các việc quá hạn của dự án Ra mắt ví trả sau."
• "Đánh dấu việc 245 xong và ghi bình luận là đã gửi khách duyệt."
• "Tạo việc 'Chốt báo giá agency' cho Bình, hạn 20/11, ưu tiên cao."
• "Tạo dự án mới tên 'Hội nghị khách hàng 2027' từ mô tả này, cho tôi xem kế hoạch trước."

Dùng được với công cụ nào

PM Hub là máy chủ MCP từ xa theo chuẩn, nên dùng chung được với nhiều công cụ. Đã làm sẵn đăng nhập qua trình duyệt cho tất cả:

8Cách kết nối

Có hai cách. Cách 1 không cần token: công cụ AI mở trình duyệt, bạn đăng nhập PM Hub, bấm Cho phép, xong. Cách 2 là tạo token rồi dán tay, dành cho công cụ chưa hỗ trợ đăng nhập qua trình duyệt.

Cách 1 (khuyên dùng): đăng nhập bằng trình duyệt

1. Thêm máy chủ chỉ bằng địa chỉKhông cần token. Chọn công cụ của bạn:
   • Claude Code: chạy lệnh bên dưới, rồi trong Claude Code gõ /mcp, chọn pm-hub và Authenticate.
   • Claude Desktop / Claude.ai: Settings → Connectors → Add custom connector, dán địa chỉ /mcp (nếu gói của bạn có mục Connectors).
   • ChatGPT: bật Developer mode (Settings → Apps hoặc Connectors → Advanced), rồi Create một connector: dán địa chỉ /mcp, chọn xác thực OAuth. Tên mục khác nhau tuỳ bản ChatGPT và gói của bạn; chế độ này thường chỉ có ở gói trả phí. Khi dùng, ChatGPT sẽ hỏi lại trước các thao tác ghi dữ liệu.
   • Cursor: thêm vào mcp.json khối chỉ có url (bên dưới); Cursor sẽ hiện nút đăng nhập cho pm-hub.
2. Đăng nhập trong trình duyệtTrình duyệt tự mở trang đăng nhập PM Hub. Đăng nhập bằng Google như thường lệ. Nếu đã đăng nhập sẵn thì bỏ qua bước này.
3. Bấm Cho phépPM Hub hỏi bạn có cho công cụ đó làm việc bằng tên bạn không. Kiểm tra tên công cụ rồi bấm Cho phép.
4. Đóng trangTrang báo Đã kết nối PM Hub, bạn có thể đóng trang này. Công cụ tự nhận quyền truy cập, bạn không phải sao chép gì. Hỏi thử: "Liệt kê các dự án PM Hub của tôi".

claude mcp add --transport http pm-hub __ORIGIN__/mcp

{
  "mcpServers": {
    "pm-hub": { "url": "__ORIGIN__/mcp" }
  }
}

Cách 2: dán token bằng tay

1. Đăng nhập PM HubMở PM Hub bằng trình duyệt và đăng nhập Google như bình thường.
2. Tạo tokenVào Tài khoản, tìm thẻ Kết nối AI (MCP), đặt tên token (ví dụ "Claude Desktop – máy của An") rồi bấm Tạo token.
3. Sao chép ngayToken chỉ hiện một lần. Hộp thoại kèm sẵn cấu hình cho từng công cụ; bấm Sao chép ở khối bạn cần. Đóng hộp thoại là không xem lại được; mất thì thu hồi và tạo token khác.
4. Dán vào công cụ AIChọn công cụ bạn dùng ở bên dưới. Sau đó khởi động lại công cụ nếu nó yêu cầu.
5. ThửHỏi trợ lý: "Liệt kê các dự án PM Hub của tôi". Nếu thấy danh sách dự án là đã nối xong.

{
  "mcpServers": {
    "pm-hub": {
      "type": "http",
      "url": "__ORIGIN__/mcp",
      "headers": { "Authorization": "Bearer pmh_..." }
    }
  }
}

claude mcp add --transport http pm-hub __ORIGIN__/mcp --header "Authorization: Bearer pmh_..."

curl -s __ORIGIN__/mcp \
  -H "Authorization: Bearer pmh_..." \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

9Các tool và ví dụ

Trợ lý tự chọn tool khi bạn nói yêu cầu. Gần như mọi tool cần project_id: trợ lý lấy nó từ list_projects.

Ngày viết theo dạng YYYY-MM-DD. priority nhận low, medium, high, critical. Người làm (owner) là tên đăng nhập, ví dụ nghia.tran1.

Mẫu câu nên dùng

• Điểm danh buổi sáng: "Cho tôi tình hình dự án X: việc quá hạn và việc tới hạn trong 7 ngày."
• Dời hạn có lý do: "Dời hạn việc 245 sang 25/11 và bình luận: chờ khách duyệt thiết kế."
• Ghi họp nhanh: "Tạo ba việc từ ghi chú này, giao cho Bình, Dũng, Lan, hạn thứ Sáu."
• Ghi rủi ro: "Ghi rủi ro nhà cung cấp âm thanh trễ, xác suất 3, tác động 4, giảm thiểu: đặt bên dự phòng."
• Dự án mới an toàn: "Tạo dự án phần mềm ... và chỉ xem trước (dry run); khi tôi đồng ý mới tạo thật."

10An toàn và thu hồi

• Token được lưu ở PM Hub dưới dạng băm SHA-256; PM Hub không xem lại được token gốc, nên không thể nhắc lại cho bạn.
• Trang Tài khoản liệt kê các token của bạn với đuôi ký tự, ngày tạo và lần dùng gần nhất. Mất máy hoặc nghi lộ: bấm Thu hồi, công cụ AI đó mất kết nối ngay.
• Admin thu hồi được token của bất kỳ ai, và thấy ở Quản trị nền tảng số token đang hoạt động và dùng trong tuần.
• Mỗi người nên có token riêng cho mỗi máy hay công cụ, để thu hồi từng cái mà không ảnh hưởng cái khác.
• Token không có hạn dùng riêng; hãy thu hồi khi không cần nữa.

11Dành cho admin

• Quản trị nền tảng: bảng tổng, thẻ "Cần bạn xem" (dự án im lặng, quá hạn, chưa có trưởng dự án, AI lỗi), danh sách dự án, PM và người dùng, tải CSV.
• Cho ai tự đăng ký: mặc định email thuộc tên miền công ty vào thẳng và có thể tạo dự án riêng. Đổi danh sách tên miền bằng biến ALLOWED_EMAIL_DOMAINS ở Cloudflare.
• Khoá AI: Cài đặt → Toàn workspace → dán khoá OpenRouter; có nút kiểm tra khoá. Không cần khoá thì PM Hub vẫn chạy, chỉ các nút AI không dùng được.
• Gửi tin Chat và Gmail: Kết nối Google → dán khoá Composio (bắt đầu bằng ak_). PM Hub hỏi Composio trước khi lưu; khoá sai bị từ chối và khoá cũ được giữ.
• Nhắc việc tự động: trang Nhắc việc tự động, mặc định tắt từng loại, có bản xem trước tin sẽ gửi.
• Sao lưu: cuối tab Toàn workspace trong Cài đặt có tải bản sao lưu.
• Môi trường thử: có thể có một bản UAT riêng với dữ liệu thử để dùng thử vai trò; dữ liệu của bản thử không đi vào bản chính.