Từ con số 0 đến kết quả đầu tiên
API và MCP server là gì, cách kết nối dịch vụ của Belumind vào phần mềm của bạn hoặc vào trợ lý AI, và bạn nhận lại được gì. Các ví dụ dùng Virgo — bạn có thể thử ngay hôm nay.
01 · Cơ bản
API là gì?
API là cách để một phần mềm nhờ một phần mềm khác làm giúp việc gì đó. Phần mềm của bạn gửi việc cần làm — ví dụ nội dung một hợp đồng — và dịch vụ gửi lại kết quả ở dạng mà phần mềm của bạn đọc và dùng được ngay.
Phần mềm của bạn
website · ứng dụng · script
→ nội dung hợp đồng
điều khoản cần xem ←
Virgo
dịch vụ của Belumind
đang đọc hợp đồng…
Bạn gửi việc cần làm
Phần mềm của bạn gửi nội dung hợp đồng tới địa chỉ web của Virgo.
Bạn nhận lại kết quả
Virgo trả lời, xác nhận đã xử lý xong và gửi kèm các điều khoản tìm được, sẵn sàng để hiển thị hoặc lưu lại.
Bạn quyết định mọi thứ
Phần mềm của bạn chọn khi nào hỏi, gửi gì và dùng câu trả lời ra sao. Phù hợp khi bạn tự xây ứng dụng hoặc muốn tự động hoá một việc lặp lại.
02 · Cho trợ lý AI
MCP là gì?
MCP là một chuẩn chung giúp trợ lý AI — như Claude hay Cursor — tự dùng các dịch vụ bên ngoài. Bạn chỉ cần kết nối dịch vụ một lần; sau đó trợ lý sẽ biết dịch vụ làm được gì và tự dùng mỗi khi câu hỏi của bạn cần đến. Không cần biết lập trình.
Trợ lý AI
Claude · Cursor · …
Virgo MCP
Đánh dấu những điều khoản hợp đồng cần đọc kỹ
analyze_contract · get_clause · list_risk_types
Paginta MCP
Chuyển PDF thành tệp Word sửa được, giữ nguyên bảng
convert_pdf · get_document · list_documents
Clausa MCP
Đọc văn bản hành chính: ai ban hành, ai ký, thay thế văn bản nào
extract_document_fields · extract_entities · submit_job
1 · Trợ lý hỏi từng dịch vụ làm được gì
2 · Trợ lý chọn Virgo để xem hợp đồng
| API | MCP | |
|---|---|---|
| Ai làm việc | Phần mềm của bạn | Trợ lý AI của bạn |
| Biết phải làm gì nhờ đâu | Lập trình viên viết sẵn chỉ dẫn | Trợ lý tự đọc mô tả của dịch vụ |
| Cách kết nối | Thêm vài dòng mã | Dán một địa chỉ web vào phần cài đặt của trợ lý |
| Phù hợp nhất cho | Ứng dụng, website và việc tự động | Nhờ giúp đỡ trong khung chat, bằng lời của bạn |
Một dịch vụ, hai cách dùng. Mọi dịch vụ của Belumind đều có cả hai, nên bạn có thể bắt đầu trong khung chat rồi đưa vào phần mềm của mình sau.
03 · Cài đặt
Cài đặt
Chọn cách phù hợp với bạn — cả hai đều tới cùng một dịch vụ. Kết nối trợ lý AI chỉ mất khoảng một phút.
Kết nối trợ lý AI
Claude Code
Dán dòng này vào terminal rồi nhấn Enter:
$ claude mcp add --transport http \ virgo \ https://mcp.belumind.com/virgo \# rồi mở Claude Code và hỏi, ví dụ:# "Xem giúp hợp đồng này — tôi nên hỏi lại những gì?"
Claude Desktop & claude.ai
- 1Mở Settings → Connectors
- 2Chọn Add custom connector
- 3Đặt tên Virgo và dán https://mcp.belumind.com/virgo
- 4Mở cuộc trò chuyện mới — Claude đã dùng được Virgo
Custom connector chỉ có ở một số gói Claude.
Cursor
Mở tệp cài đặt MCP của Cursor (~/.cursor/mcp.json) và thêm các dòng sau:
{
"mcpServers": {
"virgo": {
"url": "https://mcp.belumind.com/virgo",
"headers": {
"X-API-Key": "bm_live_…",
"Authorization": "Bearer <access token>"
}
}
}
}Paginta kết nối theo cách tương tự — chỉ cần dùng địa chỉ này: https://mcp.belumind.com/paginta/mcp
Đưa vào phần mềm của bạn
- 1Mọi yêu cầu đều gửi tới địa chỉ web của Virgo: https://api.belumind.com/virgo
- 2Dán ví dụ vào terminal để thấy kết quả. Lập trình viên có thể làm điều tương tự bằng bất kỳ ngôn ngữ lập trình nào.
- 3Mỗi lần gọi cần hai thứ: API key cho sản phẩm, tạo trong trang quản lý ở mục API key, và access token khi bạn đăng nhập, có hạn 15 phút.
curl -X POST \
https://api.belumind.com/virgo/v1/analyze/text \
-H "X-API-Key: bm_live_…" \
-H "Authorization: Bearer <access token>" \
-H "Content-Type: application/json" \
-d '{
"text": "Điều 3. Công ty có quyền đơn phương chấm dứt hợp đồng bất cứ lúc nào mà không cần báo trước."
}'04 · Thực hành
Sử dụng
Khi đã kết nối trợ lý, bạn chỉ cần hỏi bằng lời của mình. Đây là những gì diễn ra phía sau.
Làm điều tương tự từ phần mềm của bạn
Một câu hỏi, một câu trả lời. Mỗi điều khoản trong câu trả lời được đánh dấu mức cần đọc: “doc_ky” là nên đọc kỹ, “xem_xet” là nên xem xét.
curl -X POST \
https://api.belumind.com/virgo/v1/analyze/text \
-H "X-API-Key: bm_live_…" \
-H "Authorization: Bearer <access token>" \
-H "Content-Type: application/json" \
-d '{
"text": "Điều 3. Công ty có quyền đơn phương chấm dứt hợp đồng bất cứ lúc nào mà không cần báo trước."
}'{
"summary": {
"n_flagged_clauses": 1
},
"clauses": [
{
"id": "c0",
"max_level": "doc_ky",
"risks": [
{
"code": "DON_PHUONG_CHAM_DUT",
"label": "Một bên được đơn phương chấm dứt",
"level": "doc_ky",
"score": 0.9035
}
],
"advice": {
"title": "Chấm dứt tuỳ ý, không cần lý do",
"ask": [
"Bên kia được chấm dứt trong những trường hợp cụ thể nào? \"Khi có nhu cầu / khi xét thấy cần thiết\" nghĩa là gì?"
]
}
}
]
}Nên biết
- Gửi quá nhiều cùng lúc? Dịch vụ sẽ đề nghị bạn chờ — hãy đợi đúng khoảng thời gian được báo rồi thử lại.
- PDF dài có thể mất khoảng một phút. Gửi mỗi tệp một lần và lưu kết quả; gửi lại đúng tệp đó sẽ có câu trả lời ngay.
- Kết quả là gợi ý, không phải tư vấn pháp lý — dùng chúng để biết nên đọc gì trước.
Muốn xem đầy đủ chi tiết?
Hướng dẫn đầy đủ liệt kê mọi việc mỗi dịch vụ làm được, kèm ví dụ để sao chép.