ข้อกำหนดเบื้องต้นในการใช้แอปที่เชื่อมต่อ

ก่อนเริ่มต้น โปรดตรวจสอบว่าคุณมีสิ่งต่อไปนี้

  • เซิร์ฟเวอร์ MCP ที่ติดตั้งใช้งานซึ่งมีปลายทาง HTTPS ที่ปลอดภัย

    เซิร์ฟเวอร์ MCP ของคุณต้องเข้าถึงได้แบบสาธารณะผ่าน HTTPS โดยใช้การรับส่งข้อมูล HTTP แบบสตรีมได้ (เช่น https://api.yourdomain.com/v1/mcp)

    ดูรายละเอียดการติดตั้งใช้งานได้ในคู่มือนักพัฒนาซอฟต์แวร์เซิร์ฟเวอร์ MCP ของแพลตฟอร์มแอปที่เชื่อมต่อ

  • ตรวจสอบว่าเซิร์ฟเวอร์ของคุณรับคำขอจาก Google ได้

    หากเซิร์ฟเวอร์จำกัดการเข้าถึงจากภายนอกตาม IP ต้นทาง ให้เพิ่มที่อยู่ IP ต่อไปนี้ในรายการที่อนุญาต

    • 108.177.64.0/20
    • 142.250.88.0/22
    • 172.217.80.0/20
    • 192.178.20.0/22
    • 192.179.0.0/20
    • 74.125.232.0/24
    • 136.121.40.0/21

    ช่วง IP ขาออกของ Google อาจเปลี่ยนแปลงเมื่อเวลาผ่านไป ดังนั้นเราขอแนะนำให้อ่านช่วง IP จากรายการที่ Google เผยแพร่และรีเฟรชรายการที่อนุญาตเป็นประจำ โดยทำดังนี้

  • สิทธิ์เข้าถึงบัญชีนักพัฒนาแอปที่ลงทะเบียนไว้ใน Google Connected Console

    หลังจากลงชื่อเข้าใช้แล้ว ให้ตรวจสอบว่าคุณมีสิทธิ์ของแอปที่เชื่อมต่ออย่างใดอย่างหนึ่งต่อไปนี้ใน Google Connected Console

    • ดูแอปที่เชื่อมต่อ
    • สร้างและจัดการแอปที่เชื่อมต่อ

    นอกจากนี้ เจ้าของบัญชีหรือผู้ดูแลระบบต้องยอมรับข้อกำหนดในการให้บริการของแอปที่เชื่อมต่อด้วย ครั้งแรกที่องค์กรของคุณเข้าถึงแอปที่เชื่อมต่อใน Google Connected Console เจ้าของบัญชีหรือผู้ดูแลระบบต้องลงชื่อเข้าใช้และยอมรับข้อตกลงของโปรแกรมก่อนที่สมาชิกในทีมที่ได้รับเชิญจะดำเนินการต่อได้

    หากคิดว่าคุณมีสิทธิ์เข้าถึงแต่สร้างแอปที่เชื่อมต่อไม่ได้ โปรดขอให้เจ้าของบัญชีหรือผู้ดูแลระบบให้สิทธิ์ "ดูแอปที่เชื่อมต่อ" หรือ "สร้างและจัดการแอปที่เชื่อมต่อ" แก่บัญชีผู้ใช้ของคุณในหน้าผู้ใช้และสิทธิ์

  • ความสามารถในการโฮสต์ไฟล์ยืนยัน .well-known ในโดเมนเซิร์ฟเวอร์ MCP

    หากต้องการยืนยันการเป็นเจ้าของโดเมน คุณต้องแสดงไฟล์โทเค็นการทดสอบ JSON โดยตรง (มี HTTP 200 OK และไม่มีการเปลี่ยนเส้นทาง) ที่ https://<your-domain>/.well-known/google-connected-apps

  • ตรวจสอบหมวดหมู่แอปที่เชื่อมต่อที่พร้อมใช้งาน

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

  • เซิร์ฟเวอร์ MCP ที่ติดตั้งใช้งานซึ่งมี URL ปลายทางที่ถูกต้อง

    ดูรายละเอียดเพิ่มเติมได้ที่คู่มือนักพัฒนาซอฟต์แวร์เซิร์ฟเวอร์ MCP ของแอปที่เชื่อมต่อ

  • ข้อมูลเมตาและชิ้นงานของแบรนด์ที่แสดงต่อสาธารณะสำหรับแอปที่เชื่อมต่อ

    • ชื่อแอปที่เชื่อมต่อ: ชื่อที่แสดงของแอปที่เชื่อมต่อซึ่งแสดงต่อผู้ใช้ในผลิตภัณฑ์ต่างๆ ของ Google และใช้เมื่อผู้ใช้พูดถึงแอปของคุณด้วย @
    • คำอธิบาย: สรุปสั้นๆ เพียงประโยคเดียว (ไม่เกิน 30 คำ) เกี่ยวกับสิ่งที่แอปที่เชื่อมต่อทำได้สำหรับผู้ใช้ เช่น "ติดตามการซื้อล่าสุด ตรวจสอบสถานะการนำส่ง และดูประวัติคำสั่งซื้อ"
    • ไอคอน: ไอคอนแอปขนาด 512 x 512 พิกเซลในรูปแบบ JPEG หรือ PNG โดยมีขนาดไฟล์สูงสุด 1 MB (1,024 KB)
    • ความสามารถ: งานที่มีมูลค่าสูงอย่างน้อย 3 รายการที่แอปที่เชื่อมต่อของคุณทำได้ เช่น "ค้นหาประวัติคำสั่งซื้อ" หรือ "ตรวจสอบสถานะการนำส่งแบบเรียลไทม์" นอกเหนือจากความสามารถเริ่มต้นที่กำหนดโดยหมวดหมู่ของแอป ข้อมูลเหล่านี้จะแสดงต่อผู้ใช้เพื่อช่วยให้ตัดสินใจได้ว่าจะเชื่อมต่อหรือไม่ อย่าใส่ตัวเลขที่จุดเริ่มต้นของความสามารถ
    • พรอมต์ตัวอย่าง: คำถามตัวอย่างอย่างน้อย 3 รายการที่ช่วยให้ผู้ใช้เข้าใจว่าสามารถถามอะไรได้บ้าง เริ่มต้นพรอมต์ตัวอย่างอย่างน้อย 2 รายการด้วยชื่อแอปที่เชื่อมต่อ พูดถึงชื่อแอปอย่างเป็นธรรมชาติในพรอมต์อย่างน้อย 1 รายการ (เช่น โดยไม่ต้องขึ้นต้นด้วยชื่อแอป) อย่าใส่ตัวเลขที่จุดเริ่มต้นของพรอมต์ตัวอย่าง
    • URL ของข้อกำหนดในการให้บริการ: URL ที่เข้าถึงได้แบบสาธารณะสำหรับข้อกำหนดในการให้บริการของแอปที่เชื่อมต่อ
    • URL ของนโยบายความเป็นส่วนตัว: URL ที่เข้าถึงได้แบบสาธารณะสำหรับนโยบายความเป็นส่วนตัวของแอปที่เชื่อมต่อ
    • URL ของเว็บไซต์ (ไม่บังคับ): เว็บไซต์สำหรับแอปที่เชื่อมต่อ