Kết nối Theo Luật với trợ lý AI
Theo Luật là một máy chủ MCP (Model Context Protocol), chuẩn kết nối mà phần lớn trợ lý AI đã hỗ trợ. Bạn chỉ cần một địa chỉ:
https://mcp.theoluat.vn/mcp
Có hai cách đăng nhập:
- Đăng nhập tài khoản (OAuth). Ứng dụng mở trang Theo Luật, bạn đăng nhập bằng Google và bấm Cho phép. Dùng cho Claude.ai, ChatGPT, Gemini và các ứng dụng có giao diện.
- Khóa API. Tạo khóa ở app.theoluat.vn, rồi gửi kèm trong header
Authorization: Bearer <khóa>. Dùng cho công cụ lập trình và chương trình tự viết.
Cả hai cách dùng chung hạn mức lượt tra cứu của tài khoản.
Tóm tắt
| Ứng dụng | Gói cần có | Cách kết nối |
|---|---|---|
| Claude (web, máy tính, điện thoại) | Mọi gói, kể cả Miễn phí (1 kết nối tùy chỉnh) | Đăng nhập tài khoản |
| Claude Code | Có Claude Code | Khóa API hoặc đăng nhập |
| ChatGPT | Pro, Business, Enterprise, Edu | Đăng nhập tài khoản, chỉ trên web |
| Codex | Có Codex | Khóa API hoặc đăng nhập |
| Gemini | Ứng dụng Gemini: chỉ tài khoản cá nhân ở Mỹ. Antigravity, Gemini CLI: mọi người | Đăng nhập hoặc khóa API |
| DeepSeek | Ứng dụng DeepSeek chưa hỗ trợ MCP; dùng qua Cherry Studio hoặc Chatbox | Khóa API |
| Cursor, VS Code, Windsurf / Devin | Theo gói của công cụ | Khóa API hoặc đăng nhập |
| OpenClaw, Hermes Agent, Pi | Mã nguồn mở | Khóa API hoặc đăng nhập |
| Perplexity, Le Chat, Grok, Copilot Studio | Theo gói của ứng dụng | Đăng nhập hoặc khóa API |
Claude (claude.ai, Claude Desktop, ứng dụng điện thoại)
- Trên claude.ai hoặc Claude Desktop, mở Plugins ở thanh bên trái, bấm Add rồi Add custom connector.
- Đặt tên
Theo Luật, dán địa chỉhttps://mcp.theoluat.vn/mcpvà bấm Continue. - Claude tự nhận ra cách đăng nhập; giữ nguyên các lựa chọn và bấm Add.
- Trang Theo Luật mở ra: đăng nhập bằng Google và bấm Cho phép.
- Trong cuộc trò chuyện, kiểm tra Theo Luật đang bật ở nút + → Plugins. Hỏi thử: “Theo Luật Đất đai 2024, đất được phân loại thế nào? Còn hiệu lực không?”
Gói Team và Enterprise: chủ tổ chức thêm kết nối ở Organization settings → Connectors, sau đó từng người bấm Connect. Kết nối đã thêm trên web sẽ có sẵn trong ứng dụng Claude trên điện thoại.
Claude Code
claude mcp add --transport http theoluat https://mcp.theoluat.vn/mcp \ --header "Authorization: Bearer <khóa của bạn>"
Hoặc không dùng khóa: bỏ dòng --header, rồi gõ /mcp trong Claude Code để đăng nhập qua trình duyệt. Thêm --scope user để dùng ở mọi dự án.
ChatGPT
ChatGPT cho kết nối máy chủ MCP tùy chỉnh trên gói Pro (chỉ đọc và tra cứu, đủ cho Theo Luật) và Business, Enterprise, Edu. Gói Free, Go và Plus hiện chưa có tính năng này. Chỉ thiết lập được trên web.
- Mở chatgpt.com/plugins, bấm + rồi Add custom MCP server.
- Đặt tên
Theo Luật, dánhttps://mcp.theoluat.vn/mcp, chọn xác thực OAuth. - Đồng ý cảnh báo, bấm Create as a plugin, đăng nhập Theo Luật và bấm Cho phép.
Gói Business và Enterprise: quản trị viên có thể thêm ở Workspace settings → Apps cho cả tổ chức.
Codex (CLI, ứng dụng ChatGPT trên máy tính, tiện ích IDE)
Thêm vào ~/.codex/config.toml, rồi đặt biến môi trường THEOLUAT_API_KEY bằng khóa của bạn:
[mcp_servers.theoluat] url = "https://mcp.theoluat.vn/mcp" bearer_token_env_var = "THEOLUAT_API_KEY"
Hoặc đăng nhập thay cho khóa: codex mcp add theoluat --url https://mcp.theoluat.vn/mcp rồi codex mcp login theoluat.
Gemini
Ứng dụng Gemini (gemini.google.com) hiện chỉ cho thêm ứng dụng MCP tùy chỉnh với tài khoản Google cá nhân ở Mỹ, từ 18 tuổi, giao diện tiếng Anh. Nếu bạn đủ điều kiện: Settings → Connected Apps → Add a custom app, dán địa chỉ và đăng nhập.
Antigravity (CLI và IDE của Google) dùng được ở mọi nơi. Thêm vào ~/.gemini/config/mcp_config.json:
{
"mcpServers": {
"theoluat": {
"serverUrl": "https://mcp.theoluat.vn/mcp",
"headers": { "Authorization": "Bearer <khóa của bạn>" }
}
}
}
Gemini CLI (nếu bạn vẫn dùng): gemini mcp add --transport http --header "Authorization: Bearer <khóa>" theoluat https://mcp.theoluat.vn/mcp.
DeepSeek
Ứng dụng và trang chat của DeepSeek chưa hỗ trợ MCP. Để mô hình DeepSeek tra cứu bằng Theo Luật, dùng một ứng dụng chat hỗ trợ MCP và chọn mô hình DeepSeek trong đó (cần khóa API của DeepSeek):
- Cherry Studio: Settings → MCP → Add, loại Streamable HTTP, địa chỉ
https://mcp.theoluat.vn/mcp, headerAuthorization: Bearer <khóa của bạn>. - Chatbox: Settings → MCP → Add Server, thêm máy chủ từ xa với địa chỉ trên.
Cursor
Thêm vào ~/.cursor/mcp.json (mọi dự án) hoặc .cursor/mcp.json (một dự án):
{
"mcpServers": {
"theoluat": {
"url": "https://mcp.theoluat.vn/mcp",
"headers": { "Authorization": "Bearer <khóa của bạn>" }
}
}
}
Bỏ headers để đăng nhập bằng tài khoản thay cho khóa.
VS Code (GitHub Copilot)
Tạo .vscode/mcp.json; VS Code sẽ hỏi khóa một lần và lưu an toàn:
{
"inputs": [{ "type": "promptString", "id": "theoluat-key", "description": "Khóa API Theo Luật", "password": true }],
"servers": {
"theoluat": {
"type": "http",
"url": "https://mcp.theoluat.vn/mcp",
"headers": { "Authorization": "Bearer ${input:theoluat-key}" }
}
}
}
Windsurf / Devin Desktop
Thêm máy chủ từ xa với địa chỉ https://mcp.theoluat.vn/mcp trong phần MCP của Cascade (tệp ~/.config/devin/mcp_config.json). Có thể đăng nhập bằng tài khoản hoặc gửi khóa trong header.
OpenClaw
openclaw mcp add theoluat --url https://mcp.theoluat.vn/mcp --transport streamable-http --auth oauth openclaw mcp login theoluat
Kiểm tra bằng openclaw mcp doctor theoluat --probe.
Hermes Agent (Nous Research)
Thêm vào ~/.hermes/config.yaml, rồi gõ /reload-mcp:
mcp_servers:
theoluat:
url: "https://mcp.theoluat.vn/mcp"
headers:
Authorization: "Bearer ${THEOLUAT_API_KEY}"
Hoặc thay headers bằng auth: oauth và chạy hermes mcp login theoluat.
Pi
Pi hỗ trợ MCP từ phiên bản 0.99:
pi mcp add theoluat --url https://mcp.theoluat.vn/mcp --bearer-token-env-var THEOLUAT_API_KEY
Hoặc đăng nhập: pi mcp login theoluat.
Ứng dụng khác
- Perplexity: Plugins → Add custom → Add MCP connector → Remote, dán địa chỉ, chọn OAuth.
- Mistral Le Chat: Connectors → Add Connector → Custom MCP Connector, dán địa chỉ; Le Chat tự nhận cách đăng nhập.
- Grok: grok.com/connectors → New Connector → Custom, dán địa chỉ.
- Microsoft Copilot Studio: trong agent, Tools → Add a tool → New tool → Model Context Protocol, chọn API key (header
Authorization) hoặc OAuth 2.0. - Chương trình tự viết: dùng API REST, ví dụ
GET https://mcp.theoluat.vn/v1/search?q=…với header khóa API.
Trợ lý AI tra cứu thế nào
Khi bạn hỏi, trợ lý gọi các công cụ của Theo Luật: tìm điều luật còn hiệu lực vào ngày cần hỏi, đọc nguyên văn điều khoản, xem lịch sử sửa đổi, tìm công văn hướng dẫn và kiểm tra trích dẫn. Mọi công cụ chỉ đọc dữ liệu, không thay đổi gì trong tài khoản của bạn. Mỗi lần gọi công cụ là một lượt tra cứu.