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/agent-plugins
/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 team? Chọn phạm vi project trong bảng mà /plugin install maguyva@maguyva mở ra. Plugin sẽ được ghi vào .claude/settings.json của repository, tệp mà bạn commit; mỗi đồng đội vẫn cần chạy cài đặt một lần. Các lệnh /plugin trong phiên không có cờ --scope, nên để viết script, hãy chạy dạng shell từ thư mục gốc của repository:

claude plugin marketplace add maguyva/agent-plugins --scope project
claude plugin install maguyva@maguyva --scope project

Hầu hết các client khác (Cursor, VS Code, Devin Desktop, 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 cầu nối trung gian. Ví dụ, .cursor/mcp.json của Cursor:

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

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", Antigravity dùng serverUrl, Zed dùng context_servers). Ví dụ Cursor này đọc key của bạn từ biến môi trường MAGUYVA_API_KEY ở phía trên; nếu cấu hình của một client hiển thị placeholder mgv_xxxx thay vào đó, hãy thay nó 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ộ 23 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? Kiểm tra khóa API, cấu hình client và trạng thái lập chỉ mục repository trong Khắc phục sự cố. Nếu thiết lập dùng cầu nối, hãy kiểm tra thêm rằng npx khả dụng.

Các bước tiếp theo

#

Liên quan

Đọc tiếp