Hướng dẫn › Kết nối

Dùng Clario trong Claude, ChatGPT, Codex

Ngoài app Clario, anh chị có thể hỏi số liệu công ty ngay trong Claude, ChatGPT hoặc Codex, nếu đã quen dùng các trợ lý này hằng ngày. Làm một lần, sau đó chỉ cần hỏi như bình thường.

Kết nối này là gì, làm được gì

Kết nối này cho phép trợ lý AI anh chị chọn hỏi Clario về số liệu NineERP của công ty. Trợ lý hỏi Clario, Clario trả số liệu, trợ lý diễn đạt lại cho anh chị.

• Tổng quan: doanh thu, lãi gộp, phải thu, phải trả, tiền, tồn kho và số phiếu chờ duyệt.
• Cần duyệt: các phiếu đang chờ anh chị duyệt, xếp theo mức ưu tiên, kèm đường dẫn mở trong NineERP.
• Số liệu: hỏi một chỉ số theo thời gian, theo khách hàng, nhà cung cấp hay sản phẩm; xem chỉ số đó được tính thế nào.
• Dự báo: ước tính cuối tháng này và tháng sau, nếu tài khoản đã bật dự báo.

Trước khi bắt đầu

• Có sẵn tên đăng nhập và mật khẩu Clario (tài khoản giám đốc).
• Có tài khoản ở trợ lý định dùng. Điều kiện về gói tùy từng trợ lý:
  • Claude: kết nối tùy chỉnh phụ thuộc gói Claude đang dùng. Với gói Team hoặc Enterprise, người quản trị có thể phải cho phép trước.
  • ChatGPT: xem khung “Điều kiện về gói” ở phần ChatGPT.
  • Codex: đăng nhập bằng tài khoản ChatGPT hoặc bằng API key.
• Địa chỉ kết nối của Clario: https://clario.quangyendn.workers.dev/mcp. Phải có đủ phần /mcp ở cuối.
• Chỉ nhập mật khẩu trên trang đăng nhập của Clario. Không đưa mật khẩu cho Claude, ChatGPT hay ai khác.

Claude

Trên claude.ai và ứng dụng Claude cho máy tính

1. Mở Claude, vào Customize, chọn Connectors, bấm thêm kết nối tùy chỉnh (Add custom connector).
2. Đặt tên “Clario”, dán địa chỉ kết nối ở trên, rồi bấm thêm.
3. Bấm Connect. Trình duyệt mở trang của Clario, làm theo phần Trang xin quyền bên dưới.
4. Quay lại cuộc trò chuyện, bật Clario trong danh sách kết nối rồi hỏi, ví dụ: “Doanh thu tháng này của công ty thế nào?”

Trên điện thoại

Nên thêm kết nối trên bản web trước. Sau đó đăng nhập cùng tài khoản Claude trên điện thoại, có thể dùng được ngay mà không phải thêm lại. Nếu chưa thấy Clario, hãy thêm lại trên bản web.

Claude Code

Dành cho người dùng Claude Code. Chạy một lệnh, rồi gõ /mcp trong Claude Code để đăng nhập:

claude mcp add --transport http clario https://clario.quangyendn.workers.dev/mcp

ChatGPT

1. Mở chatgpt.com, vào mục Plugins, bấm dấu “+” rồi chọn Add custom MCP server.
2. Dán địa chỉ kết nối, chọn cách xác thực OAuth, đọc cảnh báo rủi ro rồi đồng ý.
3. Hộp thoại có ô biểu tượng: tải lên ảnh biểu tượng Clario (PNG, nhỏ hơn 10 KB). Có sẵn tại clario.quangyendn.workers.dev/icons/icon-192.png: mở link, lưu ảnh về máy rồi tải lên.
4. Bấm Create as a plugin. Trình duyệt mở trang của Clario, làm theo phần Trang xin quyền.
5. Trong cuộc trò chuyện, gõ @ rồi chọn Clario, sau đó hỏi như bình thường.

Khi Clario thêm hoặc đổi công cụ, vào phần cài đặt của plugin Clario trong ChatGPT và bấm Refresh để cập nhật.

Codex

Dành cho người dùng Codex của OpenAI (dòng lệnh, tiện ích trong trình soạn code, hoặc ứng dụng máy tính). Bước thêm kết nối vẫn làm một lần bằng lệnh codex mcp add trên dòng lệnh (hoặc ghi vào ~/.codex/config.toml); sau đó tiện ích và ứng dụng máy tính chỉ cần bấm nút Authenticate. Cần Codex từ phiên bản 0.147 trở lên, kiểm tra bằng codex --version.

1. Chạy: codex mcp add clario --url https://clario.quangyendn.workers.dev/mcp
2. Chạy: codex mcp login clario. Trình duyệt mở trang của Clario.
3. Đăng nhập và bấm Cho phép (xem phần dưới). Trang ghi “Ứng dụng trên máy bạn muốn kết nối với Clario”: đó là Codex, bình thường.

Tiện ích trong trình soạn code và ứng dụng máy tính dùng chung cấu hình với dòng lệnh (~/.codex/config.toml), nên thêm một lần là dùng được ở cả ba. Nếu tiện ích hoặc ứng dụng máy tính chưa đăng nhập qua codex mcp login, bấm nút Authenticate của Clario trong đó để đăng nhập.

Trang xin quyền và khi nào bấm “Cho phép”

Sau khi bấm kết nối, sẽ hiện một trang của Clario với tiêu đề dạng “Claude muốn kết nối với Clario” (hoặc ChatGPT, hoặc “Ứng dụng trên máy bạn” với Codex). Trang cho biết ứng dụng nào xin quyền, nhắc rằng chỉ đọc số liệu công ty, và có ô tên đăng nhập, mật khẩu Clario.

• Bấm Cho phép khi chính anh chị vừa bấm kết nối trong Claude, ChatGPT hay Codex, và tên ứng dụng trên trang đúng với ứng dụng đó.
• Bấm Từ chối (hoặc đóng trang) nếu anh chị không vừa làm gì, hoặc trang mở ra từ link ai đó gửi.

Hỏi thử

• “Doanh thu tháng này của công ty so với tháng trước?”
• “Phiếu nào đang chờ duyệt lâu nhất?”
• “Top 5 khách hàng theo doanh thu quý này?”

Số liệu khớp với màn hình Tổng quan và Cần duyệt trong app Clario, và có ghi nguồn.

Ngắt kết nối

1. Trong Clario, mở Cài đặt và bấm Đăng xuất trên các thiết bị khác. Từ lúc đó mọi kết nối đã cấp đều dừng; nếu không thấy nút này (nút chỉ hiện với tài khoản nối dữ liệu NineERP thật), hãy đổi mật khẩu Clario, kết quả tương tự. Lưu ý: thao tác này cũng đăng xuất app Clario trên mọi điện thoại, máy tính khác, không chỉ các kết nối, nên cần đăng nhập lại ở đó.
2. Rồi xóa kết nối trong Claude, ChatGPT hay Codex (codex mcp remove clario) cho gọn danh sách.

Chỉ xóa trong Claude, ChatGPT hay Codex là chưa đủ: việc đó gỡ kết nối khỏi ứng dụng, còn quyền đã cấp vẫn còn hiệu lực cho tới khi làm bước 1.

Giới hạn

• Mỗi người dùng tối đa 30 lượt gọi mỗi phút và 300 lượt mỗi ngày, tính chung cho mọi trợ lý.
• Kết quả mỗi lần trả về có giới hạn độ dài (tối đa 50 dòng), nên với danh sách dài, hãy hỏi lọc theo khách hàng hoặc kỳ.
• Chỉ tài khoản giám đốc dùng được. Mỗi tài khoản chỉ thấy dữ liệu công ty mình.
• Quyền kết nối hết hạn sau 30 ngày không dùng. Khi đó chỉ cần kết nối lại.

Dữ liệu đi đâu

Câu hỏi và số liệu Clario trả về đi qua nhà cung cấp trợ lý đã chọn: Anthropic với Claude, OpenAI với ChatGPT và Codex. Số liệu gồm số tổng hợp, tên đối tác, người đề nghị và nhân viên kinh doanh. Vì vậy:

• Nếu dùng gói cá nhân, hãy tắt việc dùng cuộc trò chuyện để huấn luyện mô hình. Với ChatGPT: Settings, Data controls, tắt Improve the model for everyone. Với Claude: vào phần quyền riêng tư trong cài đặt tài khoản và tắt tùy chọn cho phép dùng cuộc trò chuyện để cải thiện Claude (tên và vị trí mục này có thể đổi theo phiên bản). Codex dùng cùng cài đặt với tài khoản ChatGPT; nếu Codex chạy bằng API key thì tùy chọn này không áp dụng.
• Gói dành cho doanh nghiệp thường có chính sách riêng về dữ liệu; hỏi quản trị viên của công ty.
• Clario chỉ đọc, không ghi gì vào NineERP, và luôn ghi lại các lượt truy cập để kiểm tra khi cần.

Lỗi thường gặp

Viết theo Clario phiên bản 0.8.0. Thay đổi mới xem ở Có gì mới.