Chuyển tới nội dung

Bắt đầu nhanh

Con đường nhanh nhất từ con số 0 đến một câu trả lời đã được xác minh: lấy khóa API, lập chỉ mục một repository bạn đã biết rõ, kết nối client của bạn, rồi đặt một câu hỏi mà bạn đã có thể tự chấm điểm.

1. Lấy khóa API#

Bắt đầu miễn phí — không cần thẻ tín dụng. Khóa API của bạn (bắt đầu bằng mgv_) nằm trong app.maguyva.ai.

2. Lập chỉ mục một repository bạn đã biết rõ#

Kết nối một GitHub repository từ portal và để nó lập chỉ mục. Chọn một repo nhỏ mà bạn có thể kiểm tra nhanh — điều đó cho thấy rõ ràng liệu Maguyva có đang neo mô hình vào dữ liệu thực hay không, thay vì cố lập chỉ mục toàn bộ công ty ngay từ ngày đầu.

3. Kết nối client của bạn#

Với Claude Code, cài đặt plugin Maguyva từ marketplace — chạy từng lệnh sau bên trong Claude Code:

/plugin marketplace add maguyva/claude-code-plugin
/plugin install maguyva@maguyva

Plugin xác thực bằng khóa của bạn từ biến môi trường MAGUYVA_API_KEY. Đặt biến này trong shell của bạn (nên dùng direnv theo từng dự án, vì khóa được giới hạn theo repository):

export MAGUYVA_API_KEY=mgv_xxxx

Làm việc theo nhóm? Thêm --scope project vào cả hai lệnh /plugin để commit plugin vào .claude/settings.json của repository, để đồng đội tự động có được plugin này.

Hầu hết các client khác (Cursor, VS Code, Windsurf, Zed, và những cái tên quen thuộc khác) kết nối trực tiếp đến server từ xa — chỉ cần trỏ chúng đến endpoint kèm header Bearer, không cần bridge trung gian. Ví dụ, .cursor/mcp.json của Cursor:

.cursor/mcp.json
{
  "mcpServers": {
    "maguyva": {
      "url": "https://maguyva.tools/mcp",
      "headers": {
        "Authorization": "Bearer mgv_xxxx"
      }
    }
  }
}

Cấu trúc có thay đổi đôi chút tùy theo client (VS Code lồng bên trong servers với type: "http", Windsurf dùng serverUrl, Zed dùng context_servers). Thay mgv_xxxx bằng khóa API của bạn, sau đó khởi động lại client. Cấu hình chính xác cho toàn bộ 24 client được tài liệu hóa có trong Hướng dẫn cài đặt.

4. Đặt một câu hỏi mà bạn đã có thể tự chấm điểm#

Bắt đầu với "Tôi đã kết nối những repository nào?" để xác nhận kết nối, sau đó đặt một câu hỏi thực tế về repo của bạn mà bạn đã biết trước câu trả lời — kiểu như "Xác thực được xử lý như thế nào trong codebase này?"

Bạn sẽ nhận được câu trả lời kèm đường dẫn file và số dòng. Mở các file được trích dẫn và kiểm tra xem câu trả lời có đứng vững khi đối chiếu với repo thực tế hay không. Một câu trả lời đã được chấm điểm đó nói lên nhiều hơn bất kỳ danh sách tính năng nào — hãy để công cụ này chứng minh được sự tin cậy trước khi nó trở thành một phần trong quy trình mặc định của bạn.

Không có kết quả, hoặc gặp lỗi kết nối? Hãy vào Khắc phục sự cố — hầu hết lỗi là do chưa thiết lập khóa API, thiếu npx, hoặc repository chưa lập chỉ mục xong.

Các bước tiếp theo#