Kết nối dữ liệu nhãn hiệu VietnamTrademark với Claude hoặc công cụ lập trình AI: câu hỏi mẫu và các bước cài đặt.
Minh họa tương tác thực tế với AI
Chọn câu hỏi bên trái để xem cách AI truy vấn dữ liệu thời gian thực
Tình huống tra cứu
Tôi muốn đăng ký nhãn hiệu 'CAFE AN NHIÊN' cho sản phẩm cà phê rang xay (nhóm 30). Hãy kiểm tra xem tên này đã có ai đăng ký chưa, có bị trùng hoặc tương tự gây nhầm lẫn không?
Phản hồi từ Claude với công cụ VietnamTrademark MCP
Kết quả tra cứu cho nhãn hiệu "CAFE AN NHIÊN" (Nhóm 30):
Nhãn hiệu đối chứng: AN NHIÊN COFFEE
Số đơn: 4-2021-12345 | Trạng thái: Cấp bằng (Văn bằng số 389210) | Chủ đơn: Công ty TNHH Cà phê An Nhiên Việt Nam
Đánh giá sơ bộ: Dấu hiệu chữ tương tự về ngữ âm và ý nghĩa, cùng bảo hộ sản phẩm nhóm 30 (cà phê). Khả năng phát sinh xung đột cao khi thẩm định nội dung. Cần cân nhắc bổ sung phần hình hoặc từ ngữ phân biệt.
Hướng dẫn cài đặt
Chọn ứng dụng bạn đang sử dụng để xem các bước kết nối phù hợp.
Người dùng phổ thông
Claude (Web & Ứng dụng)
Kết nối trực tiếp qua tính năng Connectors trên claude.ai. Đăng nhập bằng tài khoản VietnamTrademark.net, không cần cấu hình mã lệnh.
Lập trình viên & Kỹ thuật
Cursor, Claude Code, Antigravity
Cài đặt tự động bằng prompt trong terminal hoặc IDE. Sử dụng API Key tạo tại trang Cài đặt để xác thực quyền gọi MCP.
1
Thêm Connector
Trên claude.ai hoặc ứng dụng Claude, vào Settings > Connectors. Chọn Add custom connector, đặt tên VietnamTrademark.net và dán URL máy chủ sau:
URL máy chủ VietnamTrademark MCPhttps://mcp.vietnamtrademark.net/mcp
2
Đăng nhập tài khoản
Bấm Connect. Trình duyệt mở trang xác thực VietnamTrademark.net; đăng nhập và bấm Đồng ý để cấp quyền tra cứu chỉ đọc cho tài khoản.
3
Đặt câu hỏi cho AI
Mở một cuộc trò chuyện trên Claude và đặt câu hỏi về nhãn hiệu. Trợ lý AI sẽ tự động kích hoạt các công cụ tra cứu của VietnamTrademark MCP và phản hồi kèm link hồ sơ chi tiết.
Tài khoản Claude Team và Enterprise: Quản trị viên (Owner) thêm connector một lần trong Organization settings > Connectors. Sau đó mỗi thành viên trong tổ chức đăng nhập bằng tài khoản VietnamTrademark.net của riêng mình; hạn mức tính theo từng tài khoản độc lập.
Dán câu lệnh dưới đây vào khung chat hoặc terminal của trợ lý AI để tự động tải kỹ năng và thiết lập kết nối:
Lệnh tự động tải kỹ năng và cấu hình MCPDành cho Claude Code, Cursor, Antigravity
Hãy tự động cài đặt MCP server và bộ kỹ năng (skill) tra cứu nhãn hiệu Việt Nam (VietnamTrademark) cho workspace này theo các bước sau:
1. Tải danh sách file của skill từ URL: https://vietnamtrademark.net/mcp-skill/vntm-search/files (văn bản thuần; mỗi dòng gồm đường dẫn tương đối và URL tải của một file Markdown UTF-8: SKILL.md và các file trong references/).
2. Xác định công cụ đang chạy, tải từng file trong danh sách và lưu giữ nguyên đường dẫn tương đối dưới thư mục kỹ năng (ví dụ references/similarity-search.md → <thư mục kỹ năng>/references/similarity-search.md):
- Claude Code: .claude/skills/vntm-search/
- Antigravity 2.0 hoặc Codex: .agents/skills/vntm-search/
- Antigravity 1.0 hoặc Windsurf: .agent/skills/vntm-search/
- Cursor: SKILL.md lưu thành .cursor/rules/vntm-search.mdc (thêm frontmatter alwaysApply: true), các file references/ lưu vào .cursor/rules/references/
- Nếu không chắc công cụ nào, hãy lưu vào cả .claude/skills/vntm-search/ và .agents/skills/vntm-search/.
3. Thêm vào cuối file AGENTS.md (tạo mới nếu chưa có) và file CLAUDE.md (nếu đã có) nội dung sau; nếu đã có mục "VietnamTrademark MCP" từ lần cài trước thì thay thế mục đó, không thêm trùng:
## VietnamTrademark MCP Tra cứu Nhãn hiệu
- Khi người dùng hỏi về bất kỳ nhãn hiệu, thương hiệu, số đơn, số văn bằng hoặc công báo sở hữu công nghiệp tại Việt Nam: luôn đọc skill vntm-search và gọi các tool MCP của vntm (search_trademarks, get_trademark_detail, search_gazettes, get_gazette_detail) để tra cứu dữ liệu thực tế trước khi trả lời. Tuyệt đối không trả lời từ kiến thức huấn luyện.
- Nếu chưa cài được skill vntm-search: trước khi tìm nhãn trùng/tương tự hoặc kiểm tra tên trước khi nộp đơn, gọi tool get_search_guide('similarity') của vntm (miễn phí) và làm đúng quy trình trong đó.
4. Để cấu hình máy chủ MCP "vntm", HÃY DỪNG LẠI VÀ HỎI TÔI CUNG CẤP API KEY:
Nhắc tôi: "Vui lòng sao chép mã API Key của bạn tại trang https://vietnamtrademark.net/mcp-settings và dán vào đây để tôi tiếp tục thiết lập kết nối."
Sau khi tôi cung cấp API Key, hãy thêm cấu hình sau vào file cấu hình MCP của công cụ (ví dụ .mcp.json, antigravity.json, ~/.claude.json, hoặc cấu hình IDE):
{
"mcpServers": {
"vntm": {
"type": "http",
"url": "https://mcp.vietnamtrademark.net/mcp",
"headers": {
"Authorization": "Bearer YOUR_API_KEY_HERE"
}
}
}
}
(thay YOUR_API_KEY_HERE bằng mã API Key tôi vừa cung cấp).
5. Sau khi hoàn tất, hãy thông báo ngắn gọn cho tôi và gợi ý 1 câu hỏi mẫu để tôi có thể thử nghiệm tra cứu nhãn hiệu ngay lập tức.
Yêu cầu API Key: Để AI có thể gọi dữ liệu từ công cụ lập trình, bạn cần có mã khóa API Key từ tài khoản của mình.
Tài khoản VietnamTrademark.net cần có gói MCP còn hiệu lực. Mỗi lượt tra cứu hoặc xem chi tiết thành công trừ 1 lượt hạn mức; tra danh mục Nice/trạng thái và tài liệu tra cứu là miễn phí. Chi tiết xem tại Bảng giá dịch vụ.
Quyền riêng tư và bảo mật dữ liệu+
Hệ thống chỉ tiếp nhận các tham số tìm kiếm được gửi khi gọi công cụ (như từ khóa, số đơn, số bằng), không thu thập hay lưu trữ nội dung các đoạn hội thoại của bạn. Mọi công cụ đều ở chế độ chỉ đọc (Read-only).
Chính sách bảo mật
Danh sách 6 công cụ MCP (Chỉ đọc)+
search_trademarks — tìm kiếm nhãn hiệu theo tên, chủ đơn, nhóm Nice, trạng thái, ngày nộp, sản phẩm/dịch vụ.
get_trademark_detail — hồ sơ đầy đủ theo số đơn hoặc số văn bằng.
search_gazettes — tra công báo sở hữu công nghiệp Tập A/B.
get_gazette_detail — chi tiết một bản ghi công bố trong công báo.
get_search_guide — cú pháp và phương pháp tra cứu tương tự.
Ngắt kết nối và hỗ trợ kỹ thuật+
Để hủy kết nối, chọn Disconnect trong Settings > Connectors của Claude hoặc thu hồi tại trang Ứng dụng kết nối (OAuth). Khi cần hỗ trợ kỹ thuật, liên hệ qua email: [email protected].
Thông báo bảo vệ dữ liệu & Quyền riêng tư
Hệ thống sử dụng cookie và thông số kỹ thuật thiết bị vô hại (không thu thập thông tin định danh cá nhân) nhằm ngăn chặn gian lận, bảo đảm an toàn hệ thống theo Luật Bảo vệ dữ liệu cá nhân 2025 và Nghị định 356/2025/NĐ-CP.