# คู่มือการติดตั้ง

Canonical source: https://maguyva.ai/th/docs/installation

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).

เริ่มใช้งานได้ภายในไม่ถึง 5 นาที คู่มือนี้ครอบคลุมการตั้งค่าสำหรับไคลเอนต์ MCP 23 รายการ รวมถึง Claude Code, Claude Desktop, Cursor, VS Code, Devin Desktop, Codex CLI, GitHub Copilot CLI, Gemini CLI, Cline, Goose, Continue, LM Studio, Kiro CLI, JetBrains, Zed, Trae, OpenCode, BoltAI, LibreChat, Antigravity, Claude Cowork, ChatGPT และ Warp และอื่นๆ

**สิ่งที่ต้องมีก่อน**: คุณจะต้องมีคีย์ API จาก [app.maguyva.ai](https://app.maguyva.ai) และรีโพซิทอรี GitHub ที่เชื่อมต่อไว้แล้ว

## การตั้งค่าสภาพแวดล้อม

ขั้นแรก ให้ตั้งค่าคีย์ API ในตัวแปรสภาพแวดล้อม ไม่ต้องระบุ `repository` เมื่อไคลเอนต์ MCP กำหนดค่าเริ่มต้นสำหรับคำขอนั้น หรือเมื่อคีย์เข้าถึงได้เพียงรีโพซิทอรีเดียว มิฉะนั้นให้ส่งค่าอย่างชัดเจน

### macOS/Linux (Bash/Zsh)

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

### Windows (PowerShell)

```powershell
'$Env:MAGUYVA_API_KEY="mgv_xxxx"' | Out-File -Append $PROFILE
. $PROFILE
```

แทนที่ `mgv_xxxx` ด้วยคีย์ API จริงของคุณจาก [app.maguyva.ai](https://app.maguyva.ai)

## การตั้งค่าไคลเอนต์

เลือกไคลเอนต์ MCP ของคุณด้านล่าง เพื่อดูคำแนะนำการตั้งค่าเฉพาะ

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

Maguyva ใช้ MCP มาตรฐาน ไคลเอนต์ใดก็ตามที่รองรับโปรโตคอลนี้สามารถเชื่อมต่อได้ แม้จะไม่มีคู่มือทางการด้านบนก็ตาม มีไคลเอนต์ที่บันทึกไว้แล้ว 23 รายการ และเพิ่มขึ้นอย่างสม่ำเสมอ

## ตรวจสอบการตั้งค่าของคุณ

หลังจากเชื่อมต่อแล้ว ลองถามคำถามสองสามข้อกับเอเจนต์ของคุณ:

- "ฉันเชื่อมต่อรีโพซิทอรีอะไรไว้บ้าง?" — ตรวจสอบว่าการเชื่อมต่อทำงานอยู่
- "โค้ดเบสนี้จัดการการยืนยันตัวตนอย่างไร?" — ทดสอบการค้นหาเชิงความหมาย
- "หาฟังก์ชันทั้งหมดที่เรียกใช้ฐานข้อมูล" — ทดสอบการค้นหาการพึ่งพา
- "คลาส UserService พึ่งพาอะไรบ้าง?" — ทดสอบการค้นหาสัญลักษณ์

คุณควรเห็นผลลัพธ์ที่มีพาธไฟล์และเลขบรรทัดจากรีโพซิทอรีที่เชื่อมต่อไว้ หากไม่เห็น ให้ตรวจสอบ [troubleshooting](https://maguyva.ai/th/docs/troubleshooting) ด้านล่าง

## รูปแบบรีโพซิทอรี

เมื่อระบุรีโพซิทอรี:

- ระบุแบรนช์: `"owner/repo:branch"` (e.g. `"owner/repository:develop"`)
- แบรนช์เริ่มต้น: `"owner/repo"`

**เคล็ดลับ**: ใช้ `repository_context(action="info", repository="...")` เพื่อตรวจสอบการระบุรีโพซิทอรี การระบุรีโพซิทอรีแทนค่าเริ่มต้นมีผลเฉพาะการเรียกครั้งปัจจุบัน

## การแก้ไขปัญหา

### ปัญหาเกี่ยวกับคีย์ API

- ตรวจสอบว่าคีย์ของคุณขึ้นต้นด้วย mgv_
- ตรวจสอบว่าคีย์ถูกตั้งค่าอย่างถูกต้องในสภาพแวดล้อมของคุณ
- ตรวจสอบว่าคีย์ยังไม่หมดอายุ

### ไม่พบรีโพซิทอรี

- ตรวจสอบว่ารีโพซิทอรีเชื่อมต่อไว้ใน app.maguyva.ai แล้ว
- ตรวจสอบว่ารูปแบบ owner/repo ถูกต้อง
- ตรวจสอบว่าคุณมีสิทธิ์เข้าถึงรีโพซิทอรีนี้

### ปัญหาการเชื่อมต่อ MCP

- หากไคลเอนต์ใช้ตัวเชื่อม @maguyva/mcp ให้ตรวจสอบว่ามี npx อยู่ใน PATH
- ตรวจสอบว่าโทเคน API ของคุณถูกต้องและยังไม่หมดอายุ
- ทดสอบการเชื่อมต่อไปยัง https://maguyva.tools/mcp
- ตรวจสอบไวยากรณ์การตั้งค่า MCP ของไคลเอนต์คุณ

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

- คู่มืออ้างอิง MCP API: เอกสาร API ฉบับสมบูรณ์
- วิธีการทำงาน: ทำความเข้าใจการปรับบริบทให้เหมาะสม
- การแก้ไขปัญหา: แก้ปัญหาการตั้งค่าและการเชื่อมต่อ