Connect Theo Luật to your AI assistant
Theo Luật is an MCP (Model Context Protocol) server, the standard most AI assistants support. You need one address:
https://mcp.theoluat.vn/mcp
Two ways to sign in:
- Account sign-in (OAuth). The app opens Theo Luật, you sign in with Google and click Allow. For Claude.ai, ChatGPT, Gemini and other apps with a screen.
- API key. Create a key at app.theoluat.vn and send it as
Authorization: Bearer <key>. For developer tools and your own programs.
Both count against your account's daily lookups.
At a glance
| App | Plan needed | How |
|---|---|---|
| Claude (web, desktop, mobile) | Any plan, including Free (one custom connector) | Account sign-in |
| Claude Code | Claude Code | API key or sign-in |
| ChatGPT | Pro, Business, Enterprise, Edu | Account sign-in, web only |
| Codex | Codex | API key or sign-in |
| Gemini | Gemini app: US personal accounts only. Antigravity, Gemini CLI: anyone | Sign-in or API key |
| DeepSeek | The DeepSeek app has no MCP; use Cherry Studio or Chatbox | API key |
| Cursor, VS Code, Windsurf / Devin | The tool's own plan | API key or sign-in |
| OpenClaw, Hermes Agent, Pi | Open source | API key or sign-in |
| Perplexity, Le Chat, Grok, Copilot Studio | The app's own plan | Sign-in or API key |
Claude (claude.ai, Claude Desktop, mobile apps)
- On claude.ai or Claude Desktop, open Plugins in the left sidebar, click Add, then Add custom connector.
- Name it
Theo Luật, pastehttps://mcp.theoluat.vn/mcpand click Continue. - Claude detects the sign-in method; keep the defaults and click Add.
- Theo Luật's page opens: sign in with Google and click Allow (Cho phép).
- In a chat, check Theo Luật is on under + → Plugins. Try: “How does the 2024 Land Law classify land, and is that article still in force?”
Team and Enterprise: an owner adds it under Organization settings → Connectors, then each member clicks Connect. Connectors added on the web appear in the Claude mobile apps.
Claude Code
claude mcp add --transport http theoluat https://mcp.theoluat.vn/mcp \ --header "Authorization: Bearer <your key>"
Or without a key: leave out --header and run /mcp in Claude Code to sign in through the browser. Add --scope user to use it in every project.
ChatGPT
ChatGPT connects custom MCP servers on Pro (read and search only, which is all Theo Luật needs) and Business, Enterprise, Edu. Free, Go and Plus do not have it yet. Setup is on the web only.
- Open chatgpt.com/plugins, click +, then Add custom MCP server.
- Name it
Theo Luật, pastehttps://mcp.theoluat.vn/mcp, choose OAuth. - Accept the warning, click Create as a plugin, sign in to Theo Luật and click Allow.
Business and Enterprise admins can add it for the whole workspace under Workspace settings → Apps.
Codex (CLI, ChatGPT desktop app, IDE extension)
Add to ~/.codex/config.toml and set THEOLUAT_API_KEY to your key:
[mcp_servers.theoluat] url = "https://mcp.theoluat.vn/mcp" bearer_token_env_var = "THEOLUAT_API_KEY"
Or sign in instead of a key: codex mcp add theoluat --url https://mcp.theoluat.vn/mcp, then codex mcp login theoluat.
Gemini
The Gemini app (gemini.google.com) accepts custom MCP apps only for personal Google accounts in the US, aged 18+, in English. If that is you: Settings → Connected Apps → Add a custom app, paste the address and sign in.
Antigravity (Google's CLI and IDE) works everywhere. Add to ~/.gemini/config/mcp_config.json:
{
"mcpServers": {
"theoluat": {
"serverUrl": "https://mcp.theoluat.vn/mcp",
"headers": { "Authorization": "Bearer <your key>" }
}
}
}
Gemini CLI (if you still use it): gemini mcp add --transport http --header "Authorization: Bearer <key>" theoluat https://mcp.theoluat.vn/mcp.
DeepSeek
DeepSeek's own app and chat site do not support MCP. To let a DeepSeek model look things up with Theo Luật, use a chat app that supports MCP and pick a DeepSeek model in it (you need a DeepSeek API key):
- Cherry Studio: Settings → MCP → Add, type Streamable HTTP, address
https://mcp.theoluat.vn/mcp, headerAuthorization: Bearer <your key>. - Chatbox: Settings → MCP → Add Server, add a remote server with the address above.
Cursor
Add to ~/.cursor/mcp.json (all projects) or .cursor/mcp.json (one project):
{
"mcpServers": {
"theoluat": {
"url": "https://mcp.theoluat.vn/mcp",
"headers": { "Authorization": "Bearer <your key>" }
}
}
}
Leave out headers to sign in with your account instead.
VS Code (GitHub Copilot)
Create .vscode/mcp.json; VS Code asks for the key once and stores it securely:
{
"inputs": [{ "type": "promptString", "id": "theoluat-key", "description": "Theo Luật API key", "password": true }],
"servers": {
"theoluat": {
"type": "http",
"url": "https://mcp.theoluat.vn/mcp",
"headers": { "Authorization": "Bearer ${input:theoluat-key}" }
}
}
}
Windsurf / Devin Desktop
Add a remote server with https://mcp.theoluat.vn/mcp in Cascade's MCP settings (~/.config/devin/mcp_config.json). Sign in with your account or send the key in a header.
OpenClaw
openclaw mcp add theoluat --url https://mcp.theoluat.vn/mcp --transport streamable-http --auth oauth openclaw mcp login theoluat
Check it with openclaw mcp doctor theoluat --probe.
Hermes Agent (Nous Research)
Add to ~/.hermes/config.yaml, then type /reload-mcp:
mcp_servers:
theoluat:
url: "https://mcp.theoluat.vn/mcp"
headers:
Authorization: "Bearer ${THEOLUAT_API_KEY}"
Or replace headers with auth: oauth and run hermes mcp login theoluat.
Pi
Pi supports MCP from version 0.99:
pi mcp add theoluat --url https://mcp.theoluat.vn/mcp --bearer-token-env-var THEOLUAT_API_KEY
Or sign in: pi mcp login theoluat.
Other apps
- Perplexity: Plugins → Add custom → Add MCP connector → Remote, paste the address, choose OAuth.
- Mistral Le Chat: Connectors → Add Connector → Custom MCP Connector, paste the address; Le Chat detects the sign-in method.
- Grok: grok.com/connectors → New Connector → Custom, paste the address.
- Microsoft Copilot Studio: in an agent, Tools → Add a tool → New tool → Model Context Protocol; choose API key (
Authorizationheader) or OAuth 2.0. - Your own program: use the REST API, e.g.
GET https://mcp.theoluat.vn/v1/search?q=…with your key in the header.
What the assistant does with it
When you ask, the assistant calls Theo Luật's tools: find the articles in force on the date in question, read the exact text, see the amendment history, find official guidance letters, and check citations. Every tool only reads; none changes anything in your account. Each tool call is one lookup.