Cài đặt
Mọi thứ dưới đây cần bạn kết nối Lawgical trước. Kết nối chỉ qua OAuth — không API key, không token để dán vào đâu cả. Bạn thêm Lawgical làm connector trong app AI, bấm Connect, đăng nhập rồi cấp quyền.
https://legal.lawgical.vn/mcpHầu hết app tự đăng ký được (DCR, RFC 7591), nên cứ để trống ô OAuth Client ID. App nào không tự đăng ký được, hoặc báo lỗi đăng nhập, điền lawgical-mcp. Không app nào cần Client Secret — đây là public client dùng PKCE.
- Kết nối được: Claude.ai (web và di động), Claude Desktop, ChatGPT (web và di động, bật Developer mode), ChatGPT Desktop, Codex CLI.
- Chưa kết nối được: Gemini CLI, Cursor, VS Code.
Bắt đầu nhanh
Kết nối xong (mục trên), mở một đoạn chat mới và hỏi thẳng một câu luật. Video dưới đây (giống video ở trang chủ) cho thấy Lawgical hoạt động thật trong Claude.
Hoặc cứ thử ngay, hỏi ví dụ:
Luật Doanh nghiệp 2020 quy định gì về vốn điều lệ?
Nếu kết nối đúng, bạn sẽ thấy một dòng kiểu "Called tool" hoặc "Talked to lawgical" hiện ra phía trên câu trả lời — đó là trợ lý đang gọi search_legal_docs rồi đọc văn bản thật, thay vì trả lời theo trí nhớ. Câu trả lời nên trích tới số Điều cụ thể.
Không thấy dòng đó, hay câu trả lời không trích dẫn gì? Xem mục Các lỗi thường gặp bên dưới. Muốn xem thêm câu hỏi thật đã được trả lời, có trích dẫn đầy đủ, ghé trang ví dụ.
MCP Documentation
Lawgical đưa ra 6 endpoint tại https://legal.lawgical.vn/mcp. Bạn không cần gọi tên chúng — cứ hỏi bình thường, trợ lý AI tự chọn endpoint cần dùng.
Mỗi lần gọi thành công tính 1 lượt trong hạn mức ngày, trừ get_account_status() luôn miễn phí. Tìm không ra hay gọi bị lỗi thì không mất lượt.
search_legal_docs(keywords)1 lượtTìm theo từ khóa trên toàn bộ kho văn bản. Gọi cái này trước cho một câu hỏi mở.
keywordsTừ khóa, tiếng Việt hoặc tiếng Anh. Tiếng Việt khớp tốt hơn.
Danh sách tiêu đề đã xếp hạng kèm trích đoạn. Một kết quả trùng số ký hiệu thường là văn bản đang trích dẫn số đó, không phải chính nó, nên đọc tiêu đề trước khi chọn.
get_summary(query)1 lượtLấy mục lục của một văn bản (Chương, Mục, Điều) mà không tải toàn văn. Dùng trước với luật dài để tìm đúng Điều mà không phải tải cả văn bản.
queryMột số ký hiệu, hoặc một tiêu đề. Không gộp cả hai trong cùng một lần gọi.
Các đầu mục Chương, Mục, Điều của văn bản.
get_document(query)1 lượtLấy toàn văn một văn bản.
querySố ký hiệu (ví dụ "20/2023/QH15"), tiêu đề, hoặc doc id.
Toàn văn văn bản. Soi lại số ký hiệu ở đầu kết quả xem có khớp cái bạn hỏi không, và xem tình trạng hiệu lực, trước khi trích.
check_compliance(question)1 lượtĐưa vào một câu hỏi, nhận về các trích đoạn liên quan để tự đọc và kết luận. Không tự phán đúng sai.
questionViệc bạn định làm, viết thành câu, tiếng Việt hoặc tiếng Anh.
Trích đoạn thô từ các văn bản liên quan. Có thể lẫn kết quả lạc đề.
get_laws(tinh_trang, keyword, limit, offset)1 lượtDuyệt riêng các Luật do Quốc hội ban hành, không lẫn Nghị định hay Thông tư hướng dẫn.
tinh_trangLọc theo tình trạng hiệu lực. Mặc định "Còn hiệu lực"; để trống nếu muốn mọi tình trạng.keywordChuỗi con để lọc tiêu đề. Bỏ trống để xem tất cả.limitSố kết quả tối đa. Mặc định 50, trần 200.offsetVị trí bắt đầu, để lật trang. Mặc định 0.
Danh sách các Luật khớp bộ lọc.
get_account_status()Miễn phíXem gói, số lượt đã dùng và còn lại hôm nay, giờ đặt lại hạn mức, và ngày gia hạn hoặc hết hạn.
Không có.
Gói hiện tại kèm ngày gia hạn hoặc ngày hết hạn. Nếu đang dùng hạn mức ngày của gói Miễn phí: số lượt đã dùng và còn lại hôm nay, đặt lại lúc 00:00 giờ Việt Nam. Nếu bạn thuộc một tổ chức: tổ chức có chi trả cho bạn không, và admin tổ chức có cần cấp account cho bạn hay gia hạn gói trong trang quản trị tổ chức không.
Xác thực
Lawgical có hai hệ xác thực tách biệt, dùng chung một bảng User: phiên đăng nhập website (NextAuth, JWT session cookie) và kết nối MCP cho ứng dụng AI (OAuth 2.1 Authorization Code + PKCE). Không hệ nào để lộ mật khẩu của bạn cho ứng dụng bên thứ ba.
Đăng nhập vào Lawgical
Kết nối ứng dụng AI (OAuth 2.1 + PKCE)
- 1Ứng dụng AI Trình duyệt của bạnBấm “Connect” — ứng dụng gọi /authorize; trình duyệt được chuyển tới lawgical.vn kèm một request id ngắn hạn (PKCE challenge giữ phía máy chủ)
- 2Trình duyệt của bạnĐăng nhập bằng Google OIDC hoặc email + mật khẩu — phiên là JWT cookie first-party; thông tin đăng nhập không bao giờ đi qua ứng dụng AI
- 3Lawgical Trình duyệt của bạnClient đăng ký động (DCR)? Màn hình consent hiện tên client và redirect host. Client đăng ký sẵn (Claude/ChatGPT — redirect URI khóa theo host) được duyệt tự động
- 4Trình duyệt của bạn LawgicalBạn bấm Cho phép — phát hành một authorization code dùng-một-lần, TTL ngắn, gắn với PKCE challenge
- 5Lawgical Ứng dụng AIỨng dụng đổi code tại /token kèm PKCE verifier → access token (30 ngày) + refresh token (90 ngày)
- 6Ứng dụng AIToken lưu dạng hash phía máy chủ; mỗi lần refresh xoay cả cặp token (RFC 9700), phạm vi theo từng lần cấp quyền — thiết bị này không làm hết hạn thiết bị khác
Thuộc tính bảo mật
- Google OIDC luôn gửi
prompt=select_account, nên một phiên Google có sẵn trong trình duyệt không bao giờ bị âm thầm dùng lại cho nhầm tài khoản. - Đăng nhập mật khẩu bị rate-limit theo IP và theo email trước cả khi so khớp mật khẩu; mật khẩu chỉ lưu dạng bcrypt hash.
- Authorization code dùng một lần và gắn PKCE; token là bearer ngẫu nhiên, không phải mật khẩu — thu hồi kết nối của một ứng dụng không ảnh hưởng ứng dụng khác.
Dành cho nhà tích hợp
Chỉ một cách: OAuth với PKCE, không có client secret. Máy chủ hỗ trợ đăng ký client tự động (DCR), nên phần lớn app không cần điền gì thêm ngoài Server URL. App không hỗ trợ DCR dùng Client ID cố định lawgical-mcp. Không có API key nào được cấp, kể cả cho gói Trả phí.
Thanh toán
20 lượt tra cứu mỗi ngày, không cần thẻ. Đặt lại lúc 00:00 giờ Việt Nam.
99.000đ một người mỗi tháng, tra cứu không giới hạn.
Thanh toán xử lý qua PayOS (VietQR), tự động gia hạn theo chu kỳ trừ khi bạn hủy. Hủy bất kỳ lúc nào từ bảng điều khiển — quyền lợi vẫn còn đến hết chu kỳ đã trả, chưa hỗ trợ hoàn tiền cho thời gian chưa dùng. Gọi get_account_status() giữa lúc chat để xem số lượt còn lại, việc này không tốn lượt nào.
Các lỗi thường gặp
Your session has expired. You can reconnect to re-authorize.Kết nối lại connector Lawgical trong app AI của bạn. Nếu lỗi này lặp lại chỉ sau vài giờ, hãy báo cho chúng tôi — bình thường một phiên đăng nhập không hết hạn nhanh vậy.
Authorization with Lawgical failedCũng gồm trường hợp connector kết nối được nhưng không thấy công cụ nào. Nguyên nhân thường là connector đang trỏ vào một Server URL Lawgical cũ. Xóa connector đó đi và thêm lại từ đầu — kết nối lại cái cũ sẽ không bao giờ chạy, vì token nó giữ gắn chết với URL đã cấu hình ban đầu.
Không thể tra cứu: đã dùng hết 20/20 lượt tra cứu hôm nay.Đã hết hạn mức ngày của gói Miễn phí. Hạn mức đặt lại lúc 00:00 giờ Việt Nam, hoặc nâng cấp gói Trả phí để bỏ giới hạn. Gọi get_account_status() để xem số chính xác — lệnh này luôn miễn phí.
Không thấy công cụ nào sau khi kết nốiKiểm tra lại Server URL đã điền đúng https://legal.lawgical.vn/mcp chưa. Sai một ký tự trong URL cũng khiến connector "kết nối" nhưng không có công cụ nào để dùng.
Câu hỏi hay gặp
Có cần API key không?
Không. Lawgical chỉ xác thực qua OAuth. Không có khóa API, không có bearer token tĩnh, không có gì để bạn dán vào file cấu hình.
Lawgical có lưu câu hỏi của tôi không?
Có. Máy chủ lưu từ khóa, số hiệu văn bản và câu hỏi bạn gửi qua công cụ, kèm mã tài khoản, để tìm văn bản còn thiếu và sửa lỗi tìm kiếm. Quản trị viên tổ chức không xem được. Chi tiết ở trang Chính sách quyền riêng tư.
Tôi có thể hủy gói Trả phí không?
Được, hủy bất kỳ lúc nào từ bảng điều khiển. Quyền lợi vẫn còn đến hết chu kỳ đã thanh toán; chúng tôi chưa hỗ trợ hoàn tiền cho thời gian chưa dùng.
Vì sao không nhận được email xác minh?
Kiểm tra thư mục spam trước. Nếu sau vài phút vẫn không thấy, viết email cho chúng tôi kèm địa chỉ đã đăng ký.
Câu trả lời của Lawgical có dùng thay tư vấn pháp lý được không?
Không. Lawgical là công cụ hỗ trợ tra cứu, không phải luật sư. Luôn đối chiếu văn bản gốc và hỏi người có chứng chỉ hành nghề trước khi ra quyết định pháp lý.
Dùng được với Gemini CLI, Cursor hay VS Code không?
Chưa. Những công cụ đó xác thực bằng header credential, thứ Lawgical đã bỏ khi chuyển hẳn sang OAuth. Lúc này kết nối được Claude và ChatGPT (web, desktop, di động), cùng Codex CLI — Codex tự đăng nhập qua OAuth bằng lệnh codex mcp add.
Không thấy câu hỏi của bạn ở đây? Viết email cho chúng tôi, hoặc xem thêm ở trang Hỗ trợ.