ข้อผิดพลาด MCP แบ่งเป็นกลุ่มการเชื่อมต่อ การยืนยันตัวตน ขอบเขตและแผน โควตา และการเรียกเครื่องมือ จับคู่รหัสด้านล่างก่อนเปลี่ยนโค้ดไคลเอนต์
ควรทำอย่างไรเมื่อบริการไม่พร้อมใช้งาน?
ผลตอบกลับ 503 แสดงว่าบริการมีปัญหาความพร้อมใช้งาน ตรวจสอบ URL สาธารณะ หยุดเรียกชั่วคราว แล้วลองใหม่ภายหลังโดยเพิ่มเวลารอและจำกัดจำนวนครั้ง หากยังมีปัญหา ให้ติดต่อฝ่ายสนับสนุนพร้อมเวลาและรหัสคำขอที่ลบข้อมูลอ่อนไหวแล้ว
เหตุใดการตรวจสอบโฮสต์หรือ origin จึงล้มเหลว
- ใช้
https://app.dureach.com/mcpให้ตรงทุกตัวกับไคลเอนต์ MCP ที่รองรับ streamable HTTP - ให้ความยินยอม OAuth สำหรับพื้นที่ทำงานที่ต้องการ และเก็บข้อมูลรับรองในที่เก็บที่ป้องกันของไคลเอนต์หรือระบบจัดการข้อมูลลับฝั่งเซิร์ฟเวอร์
- หากโฮสต์หรือต้นทางถูกปฏิเสธ ให้ตรวจสอบ URL ที่ตั้งค่าและติดต่อฝ่ายสนับสนุน ห้ามลบหรือปลอมส่วนหัวความปลอดภัยเพื่อข้ามการปฏิเสธ
- เก็บ
request_idจากผลตอบกลับเพื่อแก้ปัญหา และห้ามใส่โทเคนหรือแถวข้อมูลในบันทึกที่แชร์
เหตุใดการยืนยันตัวตนจึงล้มเหลว
| อาการ | ความหมาย | วิธีแก้ |
|---|---|---|
401 ไม่มีรายละเอียด request_id | โทเค็นขาด หมดอายุ ถูกเพิกถอน หรือกลุ่มเป้าหมายผิด | ทำความยินยอม OAuth ใหม่ ยืนยันว่ากลุ่มเป้าหมายคือทรัพยากร /mcp (/.well-known/oauth-protected-resource/mcp) ส่ง Authorization: Bearer YOUR_OAUTH_ACCESS_TOKEN |
คีย์ REST API ใช้ที่อื่นได้ แต่ถูกปฏิเสธบน /mcp | คีย์ API ใช้กับ MCP ไม่ได้ | ใช้โทเค็น OAuth bearer คีย์ API ใช้ได้เฉพาะเส้นทาง REST ที่ระบุไว้ |
workspace_context_required (403) | X-Workspace-ID ไม่ตรงกับเวิร์กสเปซโทเค็น | ส่งรหัสเวิร์กสเปซของโทเค็นหรือละส่วนหัว โทเค็นใช้ข้ามเวิร์กสเปซไม่ได้ |
เหตุใดเครื่องมือหายไปหรือถูกปฏิเสธ
| อาการ | ความหมาย | วิธีแก้ |
|---|---|---|
เครื่องมือไม่อยู่ใน tools/list | ไม่พร้อมใช้งานสำหรับการเชื่อมต่อนี้ | ตรวจสอบสิทธิ์ที่ได้รับและการเข้าถึงพื้นที่ทำงานกับผู้ดูแล |
Unknown tool (INVALID_PARAMS) | ชื่อขาดคำนำหน้า dureach. หรือไม่อยู่ใน 14 เครื่องมือ | ส่งชื่อเต็ม (เช่น dureach.trade.search) นามแฝง companies.list แปลงเป็น companies.search ชื่ออื่นถูกปฏิเสธ |
scope_required | โทเค็นขาดขอบเขตเครื่องมือ | ตรวจสอบและให้เฉพาะสิทธิ์ที่เครื่องมือต้องการ อย่าขยายการเข้าถึงเพียงเพื่อให้ข้อผิดพลาดหายไป |
plan_capability_required (403) | เวิร์กสเปซขาดความสามารถแพลตฟอร์มเอเจนต์ | ขอให้ผู้ดูแลเปิดความสามารถหรือเปลี่ยนแผน |
invalid_arguments | ค่านอกช่วง คำค้นสั้น ฟิลด์ไม่รู้จัก หรือ SQL ใหญ่เกิน | เทียบกับตารางเครื่องมือ คำค้นต้องมี 3 อักขระขึ้นไป หน้าและขีดจำกัดต้องอยู่ในช่วง SQL ต้องไม่เกิน 16 KiB และอยู่ในไวยากรณ์อ่านอย่างเดียว |
company_not_found | ไม่รู้จัก ID ของ companies.read | ยืนยันว่า UUID มาจาก companies.search ในเวิร์กสเปซเดียวกัน |
policy_not_found / policy_not_authorized | การส่ง R3 ระบุนโยบายที่ไม่รู้จัก ถูกเพิกถอน หมดอายุ หรือไม่ตรงกัน | ส่ง policy_id ของนโยบายที่เจ้าของตรวจแล้วและอยู่ในสถานะ ACTIVE ที่ผูกกับไคลเอนต์ OAuth นี้ เรียก dry_run: true ก่อน แล้วลองใหม่ด้วยคีย์ idempotency เดิม |
policy_budget_exceeded / policy_daily_cap_exceeded | เพดานการส่งของนโยบายเต็มแล้ว | รอรอบวันถัดไปหรือขอให้เจ้าของทบทวนเพดาน ห้ามแยกการส่งไปยังนโยบายใหม่เพื่อหลีกเลี่ยงเพดาน |
recipient_suppressed / recipient_already_attempted | ผู้รับยกเลิกรับข้อความ ตีกลับ ไม่ใช่ลีดที่ใช้งานอยู่ หรือถูกส่งหาแล้วภายใต้นโยบายนี้ | ลบผู้รับออกและทบทวนสถานะการระงับ ห้ามลองผู้รับเดิมซ้ำภายใต้นโยบายใหม่ |
result_too_large | ผลลัพธ์ทางสายเกิน 1 MiB | ลดคอลัมน์หรือตัวกรอง หรือลด limit |
quota_exceeded (429) | งบรายนาที รายชั่วโมง หรือรายวันหมดแล้ว | ปฏิบัติตาม Retry-After รายละเอียดมี limit_type, reset_at, retry_after ดู การอนุมัติ นโยบาย และโควตา MCP |
| เนื้อหาคำขอถูกปฏิเสธหรือถูกตัด | คำขอเกิน 256,000 ไบต์ | ลด SQL หรืออาร์กิวเมนต์ แยกการเรียก |
ควรส่งอะไรให้ฝ่ายสนับสนุน
ระบุ request_id (หรือ x-request-id) เวลา ชื่อเครื่องมือ page/limit หรือรูปแบบ SQL (เลี่ยงตัวระบุลูกค้าเท่าที่ทำได้) สถานะ HTTP และรหัสข้อผิดพลาด ห้ามระบุโทเค็น bearer แถวผู้ติดต่อเต็ม หรือเพย์โหลด webhook