เริ่มต้นใช้งานด่วน
เส้นทางที่เร็วที่สุดจากศูนย์ไปสู่คำตอบที่ยืนยันได้: เอาคีย์มาก่อน จัดทำดัชนีรีโพซิทอรีหนึ่งตัวที่คุณรู้จักอยู่แล้ว เชื่อมต่อไคลเอนต์ของคุณ แล้วถามคำถามหนึ่งข้อที่คุณให้คะแนนได้อยู่แล้วว่าถูกหรือผิด
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:
{
"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 พร้อมใช้งาน
ขั้นตอนถัดไป
#- คู่มือการติดตั้ง — การกำหนดค่าเฉพาะไคลเอนต์สำหรับไคลเอนต์ทั้ง 23 ตัวที่มีเอกสาร
- วิธีการทำงาน — เกิดอะไรขึ้นระหว่างคำถามของคุณกับคำตอบ
- เอกสารอ้างอิง MCP API — ทุกเครื่องมือ ทีละพารามิเตอร์