Máy chủ MCP chính thức

Hỏi CTAS bằng trợ lý AI bạn đang dùng.

Thêm một địa chỉ vào Claude, ChatGPT, Cursor, VS Code hay Gemini CLI, đăng nhập tài khoản CTAS, rồi hỏi về lịch làm, đơn từ, bảng công, nhóm chia tiền hay ngày âm lịch. Trợ lý làm việc với đúng quyền của bạn.

Chia Chia (chia tiền nhóm) và Lịch Âm: hỏi số dư, thêm khoản chi, đổi ngày âm dương, xem ngày tốt.

https://api.ctas.vn/mcp/life

Điều kiện: Tài khoản CTAS Life có Premium đang hoạt động.

Nhân sự, lịch làm, chấm công, đơn từ, lương và quy trình — với đúng vai trò và quyền của bạn trong tổ chức.

https://api.ctas.vn/mcp/work

Điều kiện: Thành viên đang hoạt động của một tổ chức đã mua gói CTAS Work (gói nào cũng được). Tổ chức đang dùng thử chưa dùng được.

Hai máy chủ

CTAS có một máy chủ MCP cho mỗi ứng dụng. Bạn thêm địa chỉ vào trợ lý AI, đăng nhập bằng tài khoản CTAS, rồi hỏi bằng lời thường. Trợ lý làm việc với đúng vai trò và quyền của bạn: cái gì bạn không thấy trong app thì trợ lý cũng không thấy.

Ứng dụngĐịa chỉDành cho
CTAS Lifehttps://api.ctas.vn/mcp/lifeChia Chia, Lịch Âm
CTAS Workhttps://api.ctas.vn/mcp/workLịch làm, chấm công, đơn từ, lương, nhân sự, quy trình

Cả hai dùng giao thức Model Context Protocol qua HTTPS (Streamable HTTP), đăng nhập OAuth 2.1 với PKCE. Không có khoá API nào để chép và không cần cài phần mềm: trợ lý mở trang đăng nhập CTAS, bạn bấm đồng ý, thế là xong.

Nhà phát triển: CTA Solution, chủ sở hữu hệ sinh thái CTAS.

Điều kiện

  • CTAS Life: tài khoản có Premium đang hoạt động. Không có Premium thì vẫn đăng nhập và xem được danh sách công cụ, nhưng mỗi lần gọi đều được trả lời là cần Premium.
  • CTAS Work: bạn là thành viên đang hoạt động của một tổ chức đã mua gói CTAS Work — gói nào cũng được, kể cả gói hợp đồng. Tổ chức đang dùng thử hoặc gói đã hết hạn chưa dùng được kết nối AI; khi gói được gia hạn, kết nối chạy lại ngay ở lần hỏi kế tiếp, không cần kết nối lại.
  • Quản trị viên tổ chức có thể tắt kết nối AI cho cả tổ chức trong phần cài đặt tổ chức. Khi tắt, mọi kết nối của thành viên tới tổ chức đó ngừng trả dữ liệu.
  • Việc mua gói và Premium làm trên website hoặc trong app CTAS, không làm qua trợ lý AI.

Cài đặt

Mọi trợ lý dưới đây đều làm theo cùng một nhịp: thêm địa chỉ máy chủ → trợ lý mở trang đăng nhập CTAS → bạn chọn quyền truy cập (và tổ chức, với CTAS Work) → bấm Cho phép. Ví dụ dùng CTAS Work; với CTAS Life thay địa chỉ thành https://api.ctas.vn/mcp/life.

Claude trên web và Claude Desktop

  1. Mở Cài đặt › Connectors (Trình kết nối) và chọn Add custom connector.
  2. Đặt tên CTAS Work, dán địa chỉ https://api.ctas.vn/mcp/work, bấm Add.
  3. Bấm Connect, đăng nhập tài khoản CTAS và cho phép.
  4. Trong một cuộc trò chuyện, bật CTAS Work ở nút công cụ rồi hỏi.

Với gói Claude Team hoặc Enterprise, chủ sở hữu tổ chức Claude thêm trình kết nối một lần trong phần cài đặt tổ chức; từng thành viên tự bấm Connect để đăng nhập tài khoản CTAS của chính mình. Trình kết nối đã thêm trên web dùng được cả trên Claude Desktop và ứng dụng di động.

Claude Code

claude mcp add --transport http ctas-work https://api.ctas.vn/mcp/work

Sau đó gõ /mcp trong Claude Code, chọn ctas-work và Authenticate để mở trang đăng nhập.

ChatGPT

  1. Mở Cài đặt › Ứng dụng (Apps), vào Nâng cao và bật chế độ nhà phát triển (Developer mode).
  2. Chọn Tạo (Create), đặt tên CTAS Work, dán địa chỉ https://api.ctas.vn/mcp/work, xác thực chọn OAuth.
  3. Đăng nhập tài khoản CTAS và cho phép, rồi chọn CTAS Work trong cuộc trò chuyện.

Khi CTAS có mặt trong danh mục ứng dụng của ChatGPT, bạn chỉ cần tìm "CTAS" và bấm kết nối.

Cursor

Thêm vào ~/.cursor/mcp.json (cho mọi dự án) hoặc .cursor/mcp.json (một dự án):

{
  "mcpServers": {
    "ctas-work": { "url": "https://api.ctas.vn/mcp/work" }
  }
}

Mở Cursor Settings › MCP, bấm Connect cạnh ctas-work để đăng nhập.

VS Code (GitHub Copilot)

Chạy lệnh MCP: Add Server, chọn HTTP, dán địa chỉ; hoặc thêm vào .vscode/mcp.json:

{
  "servers": {
    "ctas-work": { "type": "http", "url": "https://api.ctas.vn/mcp/work" }
  }
}

VS Code hỏi đăng nhập ở lần đầu khởi động máy chủ. Dùng trong khung chat ở chế độ Agent.

Gemini CLI

gemini mcp add --transport http ctas-work https://api.ctas.vn/mcp/work

Hoặc thêm vào ~/.gemini/settings.json:

{
  "mcpServers": {
    "ctas-work": { "httpUrl": "https://api.ctas.vn/mcp/work" }
  }
}

Trong Gemini CLI gõ /mcp auth ctas-work để đăng nhập.

Trợ lý khác

Trợ lý nào hỗ trợ máy chủ MCP từ xa (Streamable HTTP) có đăng nhập OAuth đều dùng được: chỉ cần địa chỉ ở trên. Trợ lý chỉ hỗ trợ máy chủ chạy trên máy (stdio) hoặc chỉ nhận khoá API cố định thì chưa dùng được — CTAS không cấp khoá tĩnh cho kết nối AI.

Đăng nhập và quyền truy cập

Lúc đăng nhập, trang đồng ý của CTAS cho bạn thấy tên ứng dụng AI, địa chỉ nó sẽ quay về, và những quyền truy cập nó xin:

Ứng dụngQuyền truy cậpMãCho phépMặc định
CTAS LifeXem dữ liệulife:readNhóm, khoản chi, số dư, báo cáo, ngày riêng và sổ ngày của bạn; tính lịch âm.Luôn bật
CTAS LifeThêm và sửalife:writeTạo nhóm, thêm/sửa/xoá khoản chi, thêm thành viên, lưu ngày riêng.Bật, bỏ chọn được
CTAS WorkXem dữ liệuwork:readMọi thứ bạn xem được trong app: lịch, công, đơn, phiếu lương, nhân sự (theo quyền).Luôn bật
CTAS WorkThao tác thông thườngwork:writeXin nghỉ, duyệt đơn, xếp ca, gửi phiếu quy trình, sửa danh mục.Bật, bỏ chọn được
CTAS WorkThao tác nhạy cảmwork:sensitiveChốt và duyệt lương, sửa điều khoản lương, vai trò, cài đặt nghiệp vụ, gửi thông báo. Mỗi lần đều xem trước và xác nhận.Tắt, chọn riêng

Quyền truy cập không bao giờ rộng hơn quyền của bạn trong app. Một nhân viên cho phép Thao tác thông thường vẫn không duyệt được đơn của người khác, vì vai trò của họ không có quyền đó. Khi quản trị viên đổi vai trò của bạn, kết nối theo vai trò mới ngay ở lần hỏi kế tiếp.

Với CTAS Work, bạn chọn những tổ chức kết nối được dùng; tổ chức chưa mua gói hiện mờ. Kết nối có nhiều tổ chức thì trợ lý hỏi bạn đang nói về tổ chức nào.

Mỗi lần cho phép tạo một kết nối riêng. Phiên đăng nhập của kết nối tự gia hạn khi bạn dùng, và hết hẳn sau 90 ngày — khi đó trợ lý mời bạn đăng nhập lại. Kết nối không dùng 90 ngày cũng tự hết hạn.

Trợ lý làm được gì

Danh sách đầy đủ, sinh từ chính máy chủ: công cụ CTAS Life · công cụ CTAS Work. Mỗi công cụ ghi rõ là đọc, ghi hay nhạy cảm, và quyền CTAS Work cần có để thấy nó.

Có những việc cố ý không làm qua trợ lý AI, dù app làm được:

  • Chấm công vào/ra ca: cần vị trí, Wi-Fi và thiết bị thật của người đi làm; để AI chấm hộ là phá cơ chế chống gian lận.
  • Thanh toán: mua gói, Premium, chuyển tiền. Trợ lý không chuyển tiền cho ai.
  • Mã bí mật và định danh: mã kích hoạt, mã mời, mật khẩu, mã xác thực, số giấy tờ tuỳ thân.
  • Tải tệp lên: ảnh, hoá đơn, logo, hợp đồng, nhập Excel.
  • Việc không hoàn tác được: xoá kỳ lương, xoá nhóm, chuyển quyền quản trị viên, xoá tài khoản.
  • Quét hoá đơn bằng AI trong Chia Chia: chính trợ lý của bạn đã đọc được ảnh, nó gửi khoản chi đã có cấu trúc cho CTAS.

Câu lệnh mẫu

Hỏi như hỏi một đồng nghiệp; không cần nhớ tên công cụ.

CTAS Life

  • “Nhóm "Đà Lạt tháng 11" ai đang nợ ai, và nên trả nhau thế nào cho ít lượt chuyển nhất?”
  • “Thêm vào nhóm "Nhà chung" khoản tiền điện 1.240.000đ, Minh trả, chia đều cho 4 người.”
  • “Rằm tháng Giêng năm sau là ngày dương lịch nào? Ngày đó có phải ngày hoàng đạo không?”
  • “Tìm giúp tôi 3 ngày tốt để khai trương trong tháng 12, tôi sinh năm 1990.”
  • “Tháng này nhóm "Văn phòng" chi nhiều nhất cho danh mục nào?”

CTAS Work

  • “Tuần sau tôi có những ca nào? Ca nào trùng ngày nghỉ lễ không?”
  • “Tạo đơn xin nghỉ phép ngày 20/11, lý do việc gia đình, và cho tôi biết tôi còn bao nhiêu ngày phép.”
  • “Hôm nay ở cửa hàng Quận 1 ai đi trễ, ai chưa chấm công?”
  • “Liệt kê các đơn đang chờ tôi duyệt, gom theo loại.”
  • “Kỳ lương tháng 10 còn vướng gì trước khi chốt?”

Xác nhận trước khi ghi

  • Công cụ chỉ đọc được đánh dấu là chỉ đọc; công cụ xoá được đánh dấu là phá huỷ, để trợ lý hỏi bạn trước khi gọi.
  • Công cụ nhạy cảm (chốt lương, sửa điều khoản lương, đổi vai trò, gửi thông báo…) chạy hai bước: lần gọi đầu chỉ trả bản xem trước — ai, bao nhiêu người, bao nhiêu tiền — kèm một mã xác nhận có hiệu lực 5 phút. Chỉ khi bạn đồng ý, trợ lý gọi lại với mã đó thì việc mới được thực hiện.
  • Gọi lặp cùng một thao tác ghi không tạo bản ghi thứ hai.
  • Bản ghi tạo qua trợ lý mang dấu "qua kết nối AI" trong lịch sử của app, để người duyệt biết nguồn.
  • Trợ lý chịu trách nhiệm hỏi bạn; bạn chịu trách nhiệm với thao tác đã cho phép dưới tài khoản của mình — xem Điều khoản sử dụng.

Giới hạn sử dụng

Giới hạn giữ máy chủ ổn định cho mọi người, giống nhau ở mọi gói. Mỗi lần gọi tốn một đơn vị; công cụ nặng tốn nhiều hơn và ghi rõ trong danh sách công cụ.

Phạm viGiới hạn
Một kết nối30 đơn vị/phút · 600/giờ · 3.000/ngày · tối đa 3 lời gọi cùng lúc
Một người (mọi kết nối)60/phút · 5.000/ngày
Một tổ chức CTAS Work300/phút · 20.000/ngày
Thao tác ghi60 lần/giờ mỗi kết nối · tối đa 50 mục mỗi lệnh hàng loạt
Xuất báo cáo20 lần/ngày mỗi tổ chức

Vượt giới hạn, công cụ trả lỗi kèm số giây cần chờ; trợ lý được dặn chờ đủ rồi mới thử lại. Danh sách trả tối đa 50 dòng mỗi trang, mặc định 20; kết quả quá dài được cắt kèm gợi ý thu hẹp bộ lọc. Khoảng ngày có trần: chấm công và lịch tổ chức 31 ngày, lịch cá nhân 62 ngày, tìm ngày tốt 90 ngày.

Bảo mật và quyền riêng tư

  • Dữ liệu đi đâu: chỉ kết quả của công cụ trợ lý gọi, theo câu bạn hỏi, được gửi tới nhà cung cấp trợ lý AI bạn chọn (Anthropic, OpenAI, Google…). Nhà cung cấp đó xử lý theo chính sách của họ. CTAS không nhận nội dung cuộc trò chuyện của bạn với trợ lý, chỉ nhận lời gọi công cụ.
  • Nhật ký: CTAS ghi mỗi lời gọi — thời điểm, ứng dụng AI, công cụ, kết quả, thời gian chạy. Tham số của lệnh đọc chỉ lưu dạng băm; lệnh ghi lưu bản đã che. Nhật ký đọc giữ 180 ngày, nhật ký ghi 2 năm.
  • Che dữ liệu: số tài khoản ngân hàng chỉ hiện 4 số cuối; không trả số giấy tờ tuỳ thân, mật khẩu, mã bí mật hay đường dẫn tệp thô; mức lương chỉ hiện khi vai trò của bạn được xem lương.
  • Token: token truy cập sống 1 giờ, chỉ dùng được cho đúng máy chủ đã cấp (token CTAS Life không mở được CTAS Work), không dùng được cho app CTAS. Token làm mới xoay sau mỗi lần dùng; một token cũ bị dùng lại thì cả kết nối bị thu hồi và bạn nhận email cảnh báo.
  • Văn bản do người dùng viết (tên, ghi chú, lý do, nội dung thông báo) được trả trong trường riêng, và trợ lý được dặn coi đó là dữ liệu, không phải chỉ dẫn. Không công cụ nào gửi dữ liệu ra ngoài CTAS.
  • Mỗi khi một ứng dụng AI mới được kết nối, CTAS gửi email cho bạn.

Chi tiết pháp lý: Chính sách bảo mật, mục "Kết nối trợ lý AI"; dữ liệu riêng của từng ứng dụng: CTAS Work, CTAS Life.

Thu hồi kết nối

  • Vào account.ctas.vn › Bảo mật › Ứng dụng AI đã kết nối: mỗi kết nối hiện ứng dụng, sản phẩm, tổ chức, quyền truy cập, lần dùng cuối. Bấm Thu hồi, kết nối ngừng trong tối đa 60 giây.
  • Đổi mật khẩu, đăng xuất mọi thiết bị, xoá tài khoản hoặc bị khoá tài khoản đều thu hồi mọi kết nối AI.
  • Rời tổ chức hoặc bị cho nghỉ thì kết nối mất quyền với tổ chức đó ngay.
  • Gỡ trình kết nối trong trợ lý AI chỉ xoá nó khỏi trợ lý; muốn chắc chắn, thu hồi cả ở account.ctas.vn.

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

Có mất phí riêng không?

Không. Kết nối AI nằm trong gói CTAS Work của tổ chức và Premium của CTAS Life. Phí dùng trợ lý AI (Claude, ChatGPT…) là của nhà cung cấp đó.

Quản trị viên có phải duyệt từng người kết nối không?

Không. Mỗi người tự kết nối bằng tài khoản của mình và chỉ thấy đúng phần mình được thấy. Quản trị viên có công tắc tắt kết nối AI cho cả tổ chức nếu cần.

Trợ lý có tự làm việc khi tôi không hỏi không?

Không. Trợ lý chỉ gọi công cụ khi bạn đang trò chuyện với nó. CTAS không gửi gì cho trợ lý theo lịch.

Vì sao trợ lý không chấm công giúp tôi được?

Chấm công cần vị trí, Wi-Fi và thiết bị thật để chống chấm hộ. Hãy chấm công trong app CTAS Work; trợ lý vẫn xem và giải thích được bảng công cho bạn.

Trợ lý trả lời sai thì sao?

Trợ lý AI có thể hiểu nhầm câu hỏi. Số liệu trong CTAS là nguồn đúng; với thao tác ghi, hãy đọc bản tóm tắt trợ lý đưa ra trước khi đồng ý. Thao tác nhạy cảm luôn có bước xem trước.

Trợ lý báo "cần gói" dù tổ chức tôi đã mua?

Kiểm tra gói còn hạn và tổ chức không ở chế độ dùng thử; kết nối có nhiều tổ chức thì hỏi rõ tên tổ chức. Trạng thái gói được kiểm lại mỗi phút.

Tôi dùng được bằng tiếng Anh không?

Được. Trợ lý trả lời theo ngôn ngữ bạn hỏi; thông báo lỗi của CTAS theo ngôn ngữ của tài khoản.

Dữ liệu của tôi có được dùng để huấn luyện AI không?

CTAS không dùng dữ liệu qua kết nối AI để huấn luyện mô hình. Việc nhà cung cấp trợ lý có dùng cuộc trò chuyện của bạn hay không tuỳ cài đặt tài khoản của bạn ở nhà cung cấp đó.

Hỗ trợ

  • Hỗ trợ: support@ctas.vn — ghi rõ ứng dụng AI, sản phẩm CTAS và thời điểm gặp lỗi.
  • Báo lỗ hổng bảo mật: security@ctas.vn. Xin đừng công bố trước khi chúng tôi kịp vá.
  • Trong app CTAS Work và CTAS Life: mục Trung tâm hỗ trợ — câu hỏi thường gặp và gửi yêu cầu hỗ trợ.

Nhật ký thay đổi

NgàyThay đổi
04/11/2026Bản đầu tiên của tài liệu kết nối trợ lý AI cho CTAS Work và CTAS Life.

Nhà phát triển: Công ty TNHH CTA Solution (CTA Solution) · Chính sách bảo mật · Điều khoản sử dụng · support@ctas.vn