Hướng dẫn

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.

  • 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

APIMCP
Ai làm việcPhần mềm của bạnTrợ lý AI của bạn
Biết phải làm gì nhờ đâuLập trình viên viết sẵn chỉ dẫnTrợ lý tự đọc mô tả của dịch vụ
Cách kết nốiThê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ự độngNhờ 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:

terminal
$ 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

  1. 1Mở Settings → Connectors
  2. 2Chọn Add custom connector
  3. 3Đặt tên Virgo và dán https://mcp.belumind.com/virgo
  4. 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:

mcp.json
{
  "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

  1. 1Mọi yêu cầu đều gửi tới địa chỉ web của Virgo: https://api.belumind.com/virgo
  2. 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.
  3. 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
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.

BạnTrợ lý AIVirgoXem giúp hợp đồng nàyBạn làm được gì?Tôi xem được hợp đồngXem giúp tệp nàyĐiều khoản + gợi ý3 điều cần đọc + câu hỏi

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.

Bạn gửi
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."
  }'
Bạn nhận lại (rút gọn)
{
  "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.