ข้ามไปที่เนื้อหา

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

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

1. รับคีย์ API#

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

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

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

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

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

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

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

export MAGUYVA_API_KEY=mgv_xxxx

ทำงานเป็นทีมอยู่ใช่ไหม? เพิ่ม --scope project ในคำสั่ง /plugin ทั้งสองคำสั่ง เพื่อ commit ปลั๊กอินลงใน .claude/settings.json ของ repository ให้เพื่อนร่วมทีมได้รับมันโดยอัตโนมัติ

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

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

รูปแบบจะต่างกันเล็กน้อยในแต่ละไคลเอนต์ (VS Code ซ้อนอยู่ใต้ servers ด้วย type: "http", Windsurf ใช้ serverUrl, Zed ใช้ context_servers) แทนที่ mgv_xxxx ด้วยคีย์ API ของคุณ แล้วรีสตาร์ตไคลเอนต์ การกำหนดค่าที่แน่นอนสำหรับไคลเอนต์ทั้ง 24 ตัวที่มีเอกสารอยู่ใน คู่มือการติดตั้ง

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

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

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

ไม่มีผลลัพธ์ หรือเจอข้อผิดพลาดในการเชื่อมต่อ? ไปที่ การแก้ไขปัญหา — ความล้มเหลวส่วนใหญ่มักมาจากคีย์ API ที่ยังไม่ได้ตั้งค่า npx ที่ขาดหายไป หรือ repository ที่ยังจัดทำดัชนีไม่เสร็จ

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