# เริ่มต้นใช้งานด่วน

Canonical source: https://maguyva.ai/th/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).

เส้นทางที่เร็วที่สุดจากศูนย์ไปสู่คำตอบที่ยืนยันได้: เอาคีย์มาก่อน จัดทำดัชนีรีโพซิทอรีหนึ่งตัวที่คุณรู้จักอยู่แล้ว เชื่อมต่อไคลเอนต์ของคุณ แล้วถามคำถามหนึ่งข้อที่คุณให้คะแนนได้อยู่แล้วว่าถูกหรือผิด

## 1. รับคีย์ API

[เริ่มใช้ฟรี](https://app.maguyva.ai) — ไม่ต้องใช้บัตรเครดิต คีย์ API ของคุณ (ขึ้นต้นด้วย `mgv_`) อยู่ใน [app.maguyva.ai](https://app.maguyva.ai)

## 2. จัดทำดัชนีรีโพซิทอรีที่คุณรู้จักอยู่แล้ว

เชื่อมต่อ GitHub รีโพซิทอรีจากพอร์ทัล แล้วปล่อยให้มันจัดทำดัชนี เลือกรีโพเล็ก ๆ ที่คุณตรวจสอบได้เร็ว — วิธีนี้จะทำให้เห็นชัดว่า Maguyva กำลังทำให้โมเดลอ้างอิงจากโค้ดจริงหรือไม่ แทนที่จะพยายามจัดทำดัชนีทั้งบริษัทตั้งแต่วันแรก

## 3. เชื่อมต่อไคลเอนต์ของคุณ

สำหรับ Claude Code ให้ติดตั้งปลั๊กอิน Maguyva จากมาร์เก็ตเพลส — รันแต่ละคำสั่งภายใน Claude Code:

```text
/plugin marketplace add maguyva/agent-plugins
/plugin install maguyva@maguyva
```

ปลั๊กอินจะยืนยันตัวตนด้วยคีย์ของคุณจากตัวแปรสภาพแวดล้อม `MAGUYVA_API_KEY` ตั้งค่ามันไว้ใน shell ของคุณ (แนะนำให้ใช้ `direnv` แยกตามโปรเจกต์ เพราะคีย์ผูกกับรีโพซิทอรีแต่ละตัว):

```bash
export MAGUYVA_API_KEY="mgv_xxxx"
```

ทำงานเป็นทีมใช่ไหม เลือกขอบเขต project ในแผงที่ `/plugin install maguyva@maguyva` เปิดขึ้นมา ปลั๊กอินจะถูกบันทึกลงใน `.claude/settings.json` ของรีโพซิทอรี ซึ่งคุณ commit ไว้ เพื่อนร่วมทีมแต่ละคนยังต้องรันการติดตั้งหนึ่งครั้ง คำสั่ง `/plugin` ภายในเซสชันไม่มีแฟล็ก `--scope` ดังนั้นหากต้องการเขียนสคริปต์ ให้รันรูปแบบ shell จากไดเรกทอรีรากของ repository:

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

ไคลเอนต์อื่น ๆ ส่วนใหญ่ (Cursor, VS Code, Devin Desktop, Zed และเพื่อน ๆ) เชื่อมต่อกับเซิร์ฟเวอร์รีโมตโดยตรง — ชี้ไปที่ endpoint พร้อมเฮดเดอร์ `Bearer` ไม่ต้องใช้บริดจ์เลย ตัวอย่างเช่น `.cursor/mcp.json` ของ Cursor:

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

รูปแบบจะต่างกันเล็กน้อยในแต่ละไคลเอนต์ (VS Code ซ้อนอยู่ใต้ `servers` ด้วย `type: "http"`, Antigravity ใช้ `serverUrl`, Zed ใช้ `context_servers`) ตัวอย่าง Cursor นี้อ่านคีย์ของคุณจากตัวแปรสภาพแวดล้อม `MAGUYVA_API_KEY` ที่แสดงไว้ด้านบน หากการกำหนดค่าของไคลเอนต์ใดแสดงตัวยึดตำแหน่ง `mgv_xxxx` แทน ให้แทนที่ด้วยคีย์ API ของคุณ จากนั้นรีสตาร์ตไคลเอนต์ การกำหนดค่าที่แน่นอนสำหรับไคลเอนต์ทั้ง 23 ตัวที่มีเอกสารอยู่ใน [คู่มือการติดตั้ง](https://maguyva.ai/th/docs/installation)

## 4. ถามคำถามหนึ่งข้อที่คุณให้คะแนนได้อยู่แล้ว

เริ่มด้วย **"ฉันเชื่อมต่อรีโพซิทอรีไหนไว้บ้าง?"** เพื่อยืนยันการเชื่อมต่อ จากนั้นถามคำถามจริงหนึ่งข้อเกี่ยวกับรีโพของคุณที่คุณรู้คำตอบอยู่แล้ว — อย่างเช่น **"โค้ดเบสนี้จัดการเรื่องการยืนยันตัวตนอย่างไร?"**

คุณควรได้คำตอบกลับมาพร้อมพาธไฟล์และเลขบรรทัด เปิดไฟล์ที่ถูกอ้างอิงแล้วตรวจสอบว่าคำตอบยังถูกต้องเมื่อเทียบกับรีโพจริง คำตอบที่ให้คะแนนได้หนึ่งข้อนั้นบอกอะไรคุณได้มากกว่ารายการฟีเจอร์ใด ๆ — ให้เครื่องมือพิสูจน์ตัวเองก่อนที่จะเข้าร่วมวงจรการทำงานปกติของคุณ

ไม่มีผลลัพธ์หรือมีข้อผิดพลาดการเชื่อมต่อ? ตรวจสอบคีย์ API การตั้งค่าไคลเอนต์ และสถานะการจัดทำดัชนีรีโพซิทอรีใน [การแก้ไขปัญหา](https://maguyva.ai/th/docs/troubleshooting) หากการตั้งค่าใช้ตัวเชื่อม ให้ตรวจสอบด้วยว่ามี `npx` พร้อมใช้งาน

## ขั้นตอนถัดไป

- คู่มือการติดตั้ง: การกำหนดค่าเฉพาะไคลเอนต์สำหรับไคลเอนต์ทั้ง 23 ตัวที่มีเอกสาร
- วิธีการทำงาน: เกิดอะไรขึ้นระหว่างคำถามของคุณกับคำตอบ
- เอกสารอ้างอิง MCP API: ทุกเครื่องมือ ทีละพารามิเตอร์