ใช้โหมดนักพัฒนาแอป Gemini เพื่อทดสอบเซิร์ฟเวอร์ Model Context Protocol (MCP) แบบอินเทอร์แอกทีฟ วินิจฉัยข้อผิดพลาดของสคีมาหรือรันไทม์ และเปรียบเทียบคุณภาพของเครื่องมือก่อนส่งแอปที่เชื่อมต่อเพื่อรับการตรวจสอบใน Google Connected Console
คู่มือนี้ครอบคลุมงานต่อไปนี้
- เปิดใช้โหมดนักพัฒนาแอป Gemini ใน Gemini, สร้างแอป MCP ที่กำหนดเอง และตรวจสอบการค้นพบเครื่องมือเบื้องต้น
- แก้ไขข้อบกพร่องของการเรียกใช้เครื่องมือที่ล้มเหลว ซิงค์สคีมาที่อัปเดต และทดสอบการตรวจสอบสิทธิ์
- จำลองบริบทสภาพแวดล้อมของผู้ใช้และกำหนดค่าการตรวจสอบสิทธิ์ไคลเอ็นต์
ดูข้อมูลเบื้องต้นเกี่ยวกับเลย์เอาต์พื้นที่ทำงานและแท็บเครื่องมือตรวจสอบได้ที่ภาพรวมโหมดนักพัฒนาแอป Gemini
เปิดใช้โหมดนักพัฒนาแอป Gemini
หากคุณกำลังเริ่มต้นใช้งานเซิร์ฟเวอร์ MCP ใน Google Connected Console แอปที่ลงทะเบียนไว้จะพร้อมใช้งานอยู่แล้วเมื่อคุณเปิดใช้โหมดนักพัฒนาแอป Gemini และคุณสามารถข้ามขั้นตอนที่ 2 ได้ หากต้องการทดสอบปลายทางเซิร์ฟเวอร์ HTTPS MCP ที่ติดตั้งใช้งานใน Gemini โดยตรงก่อนลงทะเบียนในคอนโซล ให้ทำตามทั้ง 2 ขั้นตอนเพื่อเปิดใช้โหมดนักพัฒนาแอป Gemini และเชื่อมต่อเซิร์ฟเวอร์เป็นแอป MCP ที่กำหนดเอง
ขั้นตอนที่ 1: เปิดใช้โหมดนักพัฒนาแอปใน Gemini
- เปิด Gemini ในเว็บเบราว์เซอร์
- คลิกการตั้งค่า > โหมดนักพัฒนาแอป Gemini (หรือไปที่ gemini.google.com/devmode โดยตรง)
(ไม่บังคับ) ขั้นตอนที่ 2: สร้างและทดสอบแอป MCP ที่กำหนดเอง
หากต้องการเชื่อมต่อเซิร์ฟเวอร์ MCP เป็นแอปที่กำหนดเองในโหมดนักพัฒนาแอป Gemini ให้ทำดังนี้
- ในกล่องโต้ตอบเลือกแอป ให้คลิก + สร้างใหม่
- ในกล่องโต้ตอบเชื่อมต่อกับเซิร์ฟเวอร์ MCP ให้ป้อนปลายทาง HTTPS สาธารณะของเซิร์ฟเวอร์ใน URL ของเซิร์ฟเวอร์ MCP (ตรวจสอบว่า URL ขึ้นต้นด้วย
https://เช่นhttps://your-app-link.com/mcp) - หากเซิร์ฟเวอร์ของคุณต้องใช้ข้อมูลเข้าสู่ระบบ OAuth ที่ลงทะเบียนไว้ล่วงหน้า ให้คลิกการตั้งค่าเพิ่มเติม > แสดงเพิ่มเติมเพื่อป้อนรหัสไคลเอ็นต์และรหัสลับไคลเอ็นต์ของ OAuth จากนั้นคลิกถัดไป
- ในกล่องโต้ตอบการยืนยันความปลอดภัยและความเป็นส่วนตัว ให้ตรวจสอบวิธีที่ Gemini โต้ตอบกับเซิร์ฟเวอร์ MCP ที่กำหนดเอง ดังนี้
- การเรียกใช้เครื่องมือ: Gemini จะเรียกใช้เครื่องมือของเซิร์ฟเวอร์ MCP เพื่อทริกเกอร์และเรียกใช้ฟังก์ชันที่มีเพื่อดำเนินการตามคำขอของคุณ
- การดึงข้อมูลและการแชร์: Gemini จะดึงข้อมูลและจัดการทรัพยากร สคีมา และบริบทที่แสดงโดยปลายทางของเซิร์ฟเวอร์ MCP และอาจแชร์ข้อมูลที่ตนเองมีสิทธิ์เข้าถึงโดยอิงตามการตั้งค่าบัญชี Google ของคุณหรือเมื่อโต้ตอบกับแอปอื่นๆ ที่เชื่อมต่อไว้
- ความน่าเชื่อถือและการยกเลิกการเชื่อมต่อ: ตรวจสอบว่าคุณเชื่อถือเซิร์ฟเวอร์ MCP และอ่านนโยบายความเป็นส่วนตัวก่อนดำเนินการต่อ คุณสามารถยกเลิกการเชื่อมต่อเซิร์ฟเวอร์ได้ทุกเมื่อจากหน้าแอปที่เชื่อมต่อ หรือลบลิงก์ของเซิร์ฟเวอร์จากการเชื่อมต่อบัญชี Google
- เลือกฉันเข้าใจและยอมรับความเสี่ยงด้านความปลอดภัยและความเป็นส่วนตัวในการเชื่อมต่อแอปที่กำหนดเองนี้ แล้วคลิกเชื่อมต่อ
- ในกล่องโต้ตอบบันทึกแอปที่กำหนดเอง ให้ป้อนชื่อที่แสดงสำหรับแอปที่กำหนดเอง ตรวจสอบว่าเครื่องมือของเซิร์ฟเวอร์ปรากฏในรายการการดำเนินการที่ใช้ได้ แล้วคลิกเชื่อมต่อ
- ในแผงด้านข้างโหมดนักพัฒนาแอป Gemini ให้เลือกแท็บสคีมาเครื่องมือเพื่อตรวจสอบข้อมูลเกี่ยวกับเครื่องมือแต่ละอย่างในแอปที่เชื่อมต่อ ซึ่งรวมถึงคำจำกัดความของพารามิเตอร์ ป้ายความปลอดภัย (อ่านอย่างเดียว ทำลายล้าง ต้องมีการตรวจสอบสิทธิ์) สคีมาดิบ และโครงสร้างการตอบกลับ
- ในแผงแชทด้านซ้าย ให้ป้อนพรอมต์ภาษาธรรมชาติหรือพรอมต์
@mention(เช่น@MyApp show my profile) และตรวจสอบแท็บบันทึกเหตุการณ์เพื่อดูว่าเครื่องมือทำงานอย่างไร
แก้ไขข้อบกพร่องการเรียกใช้เครื่องมือ
เมื่อการเรียกใช้เครื่องมือไม่สำเร็จหรือสร้างอาร์กิวเมนต์ที่ไม่คาดคิด คุณสามารถตรวจสอบการวัดและส่งข้อมูลทางไกลเพื่อการวินิจฉัย อัปเดตเซิร์ฟเวอร์ MCP แบ็กเอนด์ และโหลดสคีมาซ้ำโดยไม่ต้องล้างประวัติการสนทนา
หากต้องการแก้ไขข้อบกพร่องของการเรียกใช้เครื่องมือที่ล้มเหลว ให้ทำดังนี้
- ในแผงด้านขวา ให้เลือกแท็บบันทึกเหตุการณ์
- คลิกเหตุการณ์ที่ดำเนินการไม่สำเร็จในรายการการตรวจวัดระยะไกลเพื่อขยายรายละเอียดและตรวจสอบเพย์โหลดคำขอ
Tool callและการตอบกลับTool resultดังนี้- ข้อผิดพลาดเกี่ยวกับการเชื่อมต่อและเครือข่าย: ตรวจสอบข้อความแสดงข้อผิดพลาดและเวลาในการตอบสนองเพื่อยืนยันว่าเข้าถึงปลายทางได้
- ข้อผิดพลาดในการตรวจสอบสิทธิ์: หากเหตุการณ์แสดงผล
401หรือ403ให้ยืนยันสถานะโทเค็น OAuth หรือข้อมูลเข้าสู่ระบบไคลเอ็นต์ในแท็บการตรวจสอบสิทธิ์ - ความไม่ตรงกันของการตรวจสอบสคีมา: หากเซิร์ฟเวอร์แสดงข้อผิดพลาดพารามิเตอร์ MCP ไม่ถูกต้อง (
-32602) ให้เปรียบเทียบอาร์กิวเมนต์ JSON ที่โมเดลสร้างขึ้นในTool callกับประเภทพารามิเตอร์ พร็อพเพอร์ตี้ที่จำเป็น และวิธีการจัดรูปแบบในแท็บสคีมาเครื่องมือ - ข้อยกเว้นรันไทม์ของเซิร์ฟเวอร์: ตรวจสอบรหัสข้อผิดพลาดและข้อความ JSON-RPC ใน
Tool resultเพื่อวิเคราะห์ข้อยกเว้นของแบ็กเอนด์
- หากต้องการแก้ไขปัญหานี้ ให้อัปเดตการติดตั้งใช้งานเซิร์ฟเวอร์ MCP หรือปรับแต่งคำอธิบายเครื่องมือและพารามิเตอร์ ดูคำแนะนำในการเขียนสคีมาเครื่องมือและการตอบกลับข้อผิดพลาดที่ชัดเจนได้ที่มาตรฐานการผสานรวมแอปที่เชื่อมต่อ MCP
- ในแท็บสคีมาเครื่องมือ ให้คลิกซิงค์สคีมา Gemini จะดึงข้อมูล
tools/listจากเซิร์ฟเวอร์ MCP อีกครั้งและอัปเดตคำจำกัดความของเครื่องมือที่ใช้งานอยู่ขณะที่ยังคงรักษาชุดข้อความแชทปัจจุบันไว้ - ลองค้นหาอีกครั้ง ในแท็บบันทึกเหตุการณ์ ให้ยืนยันว่าการเรียกใช้เครื่องมือที่เล่นซ้ำจะแสดงผล
200 OKและแสดงผลการตอบกลับที่คาดไว้ในตัวอย่างแชท
จำลองบริบทสภาพแวดล้อมและการตรวจสอบสิทธิ์
คุณสามารถทดสอบวิธีที่เครื่องมือ MCP ตอบสนองต่อตำแหน่ง เขตเวลา ภาษา และวิธีการตรวจสอบสิทธิ์ของผู้ใช้ที่แตกต่างกันได้โดยตรงภายในแผงเครื่องมือตรวจสอบ
ลบล้างบริบทของสภาพแวดล้อม
หากต้องการจำลองบริบทของผู้ใช้สำหรับเครื่องมือที่คำนึงถึงวันที่ เวลา หรือภาษา ให้ทำดังนี้
- ในแผงด้านขวา ให้เลือกแท็บสภาพแวดล้อม
- ในส่วนวันที่และเวลา ให้เลือกวันที่จำลองและเวลาจำลองเพื่อทดสอบนิพจน์เวลาสัมพัทธ์ (เช่น "พรุ่งนี้เช้า" หรือ "บ่ายวันเสาร์นี้")
- ในส่วนค่ากำหนด ให้เลือกภาษาเพื่อจำลองภาษาของผู้ใช้ (เช่น
en-US) - เรียกใช้พรอมต์ทดสอบในแผงแชทเพื่อประเมินเครื่องมือด้วยบริบทจำลอง
- หากต้องการคืนค่าการตั้งค่าสภาพแวดล้อมเริ่มต้น ให้คลิกรีเซ็ต
กำหนดค่าการตรวจสอบสิทธิ์ไคลเอ็นต์
หากต้องการกำหนดค่าหรือเปลี่ยนวิธีการตรวจสอบสิทธิ์ที่ใช้ในระหว่างเซสชันโหมดนักพัฒนาแอป Gemini ให้ทำดังนี้
- ในแผงด้านขวา ให้เลือกแท็บการตรวจสอบสิทธิ์
- ในส่วน Client Authentication Configuration ให้เลือกโหมดการตรวจสอบสิทธิ์อย่างใดอย่างหนึ่งต่อไปนี้
- Dynamic Client Registration: ใช้ขั้นตอน OAuth เพื่อเจรจาต่อรองข้อมูลเข้าสู่ระบบกับเซิร์ฟเวอร์การให้สิทธิ์โดยอัตโนมัติ ดูข้อมูลเพิ่มเติมได้ที่คู่มือการติดตั้งใช้งาน OAuth 2.1 หากมี ให้ป้อนปลายทางในเพิ่มลิงก์แอปที่กำหนดเอง
- การลงทะเบียนไคลเอ็นต์ด้วยตนเอง: ช่วยให้คุณระบุรหัสไคลเอ็นต์และรหัสลับไคลเอ็นต์ที่ลงทะเบียนล่วงหน้าด้วยตนเองได้ ขยายการตั้งค่าขั้นสูงเพื่อกำหนดค่าการลบล้างโฟลว์เพิ่มเติม
- คลิกบันทึก แล้วรอให้ข้อความบันทึกแล้วปรากฏขึ้น จากนั้นเรียกใช้พรอมต์ทดสอบเพื่อยืนยันว่าเครื่องมือที่ตรวจสอบสิทธิ์แล้วทำงานได้สำเร็จ