# Bắt đầu nhanh

Canonical source: https://maguyva.ai/vi/docs/quickstart

License: text under [CC BY 4.0](https://creativecommons.org/licenses/by/4.0/); code samples under [MIT-0](https://opensource.org/license/mit-0); the Maguyva name, logos, brand assets and other code are not covered. Details: [maguyva.ai/license](https://maguyva.ai/license).

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í](https://app.maguyva.ai) — 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](https://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:

```text
/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):

```bash
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:

```bash
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:

```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](https://maguyva.ai/vi/docs/installation).

## 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ố](https://maguyva.ai/vi/docs/troubleshooting). 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

- Hướng dẫn cài đặt: cấu hình theo từng client cho toàn bộ 23 client được tài liệu hóa
- Cách hoạt động: điều gì diễn ra giữa câu hỏi của bạn và câu trả lời
- Tài liệu tham chiếu MCP API: từng công cụ, từng tham số một