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

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

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

แก้ปัญหาการติดตั้ง Maguyva ที่พบบ่อย: ปัญหาคีย์ API ปัญหาบริดจ์ @maguyva/mcp การค้นหารีโพซิทอรีและข้อผิดพลาดในการเชื่อมต่อ

### ปัญหาคีย์ API

- ตรวจสอบว่าคีย์ของคุณขึ้นต้นด้วยพรีฟิกซ์ mgv_
- ตรวจสอบว่าคุณเปลี่ยนตัวยึดตำแหน่ง mgv_xxxx ในตัวอย่างการกำหนดค่าเป็นคีย์จริงจาก app.maguyva.ai แล้ว
- ถ้าการกำหนดค่าของคุณอ่านคีย์จาก MAGUYVA_API_KEY ให้ยืนยันว่าตัวแปรนี้ถูกตั้งค่าไว้ในสภาพแวดล้อมที่ไคลเอนต์ของคุณเปิดขึ้นมาจริง ๆ ค่า export ของ shell ที่ใส่ไว้ใน ~/.zshrc หรือ ~/.bashrc จะมีผลก็ต่อเมื่อโหลด shell ใหม่ และแอป GUI บางตัวก็อาจไม่รับค่าเหล่านี้เลย ถ้าไม่แน่ใจ ให้เขียนคีย์ลงในการกำหนดค่าโดยตรง: ในเฮดเดอร์ Authorization ของการกำหนดค่ารีโมตแบบเนทีฟ (Bearer ตามด้วยคีย์ของคุณ) หรือในบล็อก env ของการกำหนดค่าที่ใช้บริดจ์ @maguyva/mcp
- ตรวจสอบว่าคีย์ยังไม่หมดอายุหรือถูกเพิกถอน

### ปัญหาบริดจ์ @maguyva/mcp

- ตรวจสอบว่า npx ใช้งานได้ใน PATH ของคุณ -- บริดจ์ต้องการ Node.js ที่ติดตั้งใช้งานได้ รัน npx -y @maguyva/mcp --help ในเทอร์มินัลเพื่อยืนยันว่ามันเริ่มทำงานได้
- ตรวจสอบไวยากรณ์ของการกำหนดค่า MCP ในไคลเอนต์ของคุณ -- ไฟล์ JSON ที่ผิดรูปแบบจะล้มเหลวแบบเงียบ ๆ ในบางไคลเอนต์
- ไคลเอนต์หลายตัวไม่ต้องใช้บริดจ์เลยด้วยซ้ำ Claude Code ใช้ปลั๊กอิน Maguyva (/plugin install maguyva@maguyva) ส่วน Cursor, VS Code, Devin Desktop และ Zed เชื่อมต่อกับเซิร์ฟเวอร์รีโมตแบบเนทีฟด้วยเฮดเดอร์ Bearer (Zed ผ่าน context_servers) บริดจ์มีไว้สำหรับไคลเอนต์ที่ส่งเฮดเดอร์นั้นจากการกำหนดค่าของตัวเองไม่ได้ เช่น Claude Desktop ซึ่ง claude_desktop_config.json เริ่มได้เฉพาะเซิร์ฟเวอร์ในเครื่อง ตัวเชื่อมแบบกำหนดเองของ Claude Desktop ส่งเฮดเดอร์คำขอ authorization ได้ แต่เฮดเดอร์คำขอยังเป็นเบต้าสำหรับองค์กรจำนวนจำกัด

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

- ตรวจสอบว่ารีโพซิทอรีเชื่อมต่อและจัดทำดัชนีใน app.maguyva.ai
- ตรวจสอบรูปแบบ: "owner/repo" กำหนดเป้าหมายไปที่แบรนช์เริ่มต้น "owner/repo:branch" กำหนดเป้าหมายไปที่แบรนช์เฉพาะ (เช่น "owner/repository:develop")
- ตรวจสอบให้แน่ใจว่าบัญชีของคุณมีสิทธิ์เข้าถึงรีโพซิทอรี
- ใช้ repository_context(action="info", repository="...") เพื่อตรวจสอบวิธีจับคู่รีโพซิทอรี โดยไม่ต้องระบุพารามิเตอร์ repository เฉพาะเมื่อไคลเอนต์ MCP กำหนดค่าเริ่มต้นสำหรับคำขอนั้น หรือเมื่อคีย์เข้าถึงได้เพียงรีโพซิทอรีเดียว

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

- ทดสอบการเชื่อมต่อไปยัง https://maguyva.tools/mcp จากเครื่องของคุณ -- พร็อกซีและไฟร์วอลล์ขององค์กรมักเป็นตัวการ
- ตรวจสอบว่า API token ของคุณยังใช้ได้และไม่หมดอายุ
- ตรวจสอบการกำหนดค่าของไคลเอนต์อีกครั้งเทียบกับคู่มือการติดตั้งสำหรับไคลเอนต์ของคุณ -- ตำแหน่งไฟล์การกำหนดค่าและรูปแบบต่างกันไปในแต่ละไคลเอนต์

### ยืนยันว่าแก้ได้แล้ว

หลังจากเปลี่ยนแปลงอะไรก็ตาม ให้ถามเอเจนต์ของคุณว่า "ฉันเชื่อมต่อรีโพซิทอรีไหนไว้บ้าง?" -- วิธีนี้จะยืนยันการเชื่อมต่อแบบครบวงจร จากนั้นลองถามคำถามจริงเกี่ยวกับรีโพของคุณ คุณควรจะเห็นคำตอบพร้อมพาธไฟล์และเลขบรรทัดจากรีโพซิทอรีที่เชื่อมต่ออยู่