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

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

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

1. รับคีย์ API

#

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

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

#

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

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

#

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

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

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

export MAGUYVA_API_KEY=mgv_xxxx

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

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:

.cursor/mcp.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 ตัวที่มีเอกสารอยู่ใน คู่มือการติดตั้ง

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

#

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

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

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

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

#