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

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

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

ปัญหาคีย์ API#

ทุกคำขอจะยืนยันตัวตนด้วยคีย์ API ของคุณ ซึ่งส่งไปเป็นเฮดเดอร์ Authorization: Bearer ถ้าการเรียกเครื่องมือถูกปฏิเสธ:

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

ปัญหาบริดจ์ mcp-remote#

การกำหนดค่าไคลเอนต์ที่มีเอกสารส่วนใหญ่จะเปิดโปรเซสบริดจ์บนเครื่องเพื่อส่งต่อทราฟฟิก MCP แบบ stdio ไปยังเซิร์ฟเวอร์รีโมต:

npx -y mcp-remote https://maguyva.tools/mcp --header "Authorization: Bearer ${MAGUYVA_API_KEY}"

ถ้าเซิร์ฟเวอร์ไม่เคยขึ้นในไคลเอนต์ของคุณเลย หรือขึ้นมาแล้วตัดการเชื่อมต่อทันที:

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

ไม่พบ Repository#

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

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

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

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

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

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