เซิร์ฟเวอร์ MCP ของข้อมูลผู้ขาย (อัลฟ่าแบบสาธารณะ)

รับข้อมูลแบบเรียลไทม์เกี่ยวกับบัญชี Merchant Center ได้โดยตรงจากผู้ช่วยการเขียนโค้ดที่คุณเลือก ภายในสภาพแวดล้อมในการพัฒนาซอฟต์แวร์แบบรวม (IDE) หรือเฟรมเวิร์กเอเจนต์ที่กำหนดเอง คุณสามารถเข้าถึงและจัดการข้อมูล Merchant Center ได้แล้วโดยใช้บริการ Model Context Protocol (MCP) บริการนี้ช่วยให้ผู้ช่วยการเขียนโค้ดหรือเอเจนต์ของคุณดำเนินการอ่านอย่างเดียวและดำเนินการเขียนที่ปลอดภัยในข้อมูล Merchant Center ได้ ซึ่งจะช่วยให้วินิจฉัยปัญหา ตรวจสอบโปรแกรม และค้นหารายงานด้วยบริบทแบบเรียลไทม์ที่เชื่อถือได้

ดูข้อมูลเพิ่มเติมเกี่ยวกับโปรโตคอลได้ที่มาตรฐานโปรโตคอลบริบทของโมเดล

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

การรักษาความปลอดภัยและการควบคุมการเข้าถึง

เซิร์ฟเวอร์ MCP ของข้อมูลผู้ขายออกแบบมาโดยคำนึงถึงความปลอดภัยเป็นอันดับแรก

• การตรวจสอบสิทธิ์: การดำเนินการเครื่องมือจะอยู่ภายใต้การตรวจสอบสิทธิ์ API ของผู้ขายมาตรฐานอย่างเคร่งครัด โดยต้องใช้ข้อมูลเข้าสู่ระบบ OAuth 2.0 หรือบัญชีบริการ
• ความปลอดภัยในการดำเนินการ: แม้ว่าสคีมาเครื่องมือจะมีการเข้าถึงในวงกว้างสำหรับเอเจนต์ของคุณ แต่การดำเนินการจริงของเครื่องมือใดๆ ก็ยังคงมีความปลอดภัยสูงและถูกจำกัดอย่างเข้มงวดด้วยข้อมูลเข้าสู่ระบบ API ที่เฉพาะเจาะจงของคุณ

สิ่งสำคัญที่ต้องคำนึงถึง

ก่อนใช้เครื่องมือเหล่านี้ โปรดอ่านแนวทางปฏิบัติแนะนำและข้อจำกัดต่อไปนี้

การเปลี่ยนแปลงและการเปิดตัว

เราจะโพสต์เกี่ยวกับการเปลี่ยนแปลงในหมายเหตุประจำรุ่น แต่การเปลี่ยนแปลงอาจเกิดขึ้นทันทีโดยไม่มีระยะเวลาการเลิกใช้งาน

การทดสอบที่ปลอดภัย

เราขอแนะนำให้ทดลองใช้บัญชีทดสอบหรือบัญชีที่ไม่ใช่บัญชีที่ใช้งานจริงก่อนที่จะใช้เครื่องมือเหล่านี้ในสภาพแวดล้อมฮาร์ดแวร์และซอฟต์แวร์ที่ใช้งานจริง

โควต้าที่ใช้ร่วมกัน

เซิร์ฟเวอร์ MCP ใช้พูลโควต้าเดียวกันกับการเรียกใช้ Merchant API มาตรฐาน การเรียกใช้เอเจนต์อาจทำให้โควต้าหมดลงอย่างรวดเร็ว โดยเฉพาะอย่างยิ่งสำหรับการดึงข้อมูล แหล่งข้อมูล เราขอแนะนำอย่างยิ่งให้ใช้บัญชีทดสอบเพื่อป้องกันไม่ให้ บริการที่ใช้งานจริงหยุดชะงัก

การกรองเครื่องมือและความปลอดภัย

Google อาจเพิ่มเครื่องมือใหม่ (รวมถึงความสามารถในการเขียน) ลงในเซิร์ฟเวอร์ MCP นี้ในอนาคต เพื่อป้องกันไม่ให้ AI Agent ของคุณเรียกใช้เครื่องมือใหม่หรือเครื่องมือที่มีความเสี่ยงโดยอัตโนมัติและโดยไม่ตั้งใจ เราขอแนะนำอย่างยิ่งให้กำหนดค่าไคลเอ็นต์อย่างชัดเจนเพื่อการกรองเครื่องมือในตัวแทนที่จะเปิดเผยชุดเครื่องมือทั้งหมด

ขอบเขตและข้อจำกัด

• โฟกัสแบบอ่านอย่างเดียว: เครื่องมือจะจำกัดการดำเนินการแบบอ่านอย่างเดียวและเครื่องมือเขียนที่มีความเสี่ยงต่ำ (เช่น การสร้างแหล่งข้อมูล) อย่างเคร่งครัดเพื่อเป็นแนวทางด้านความปลอดภัยสำหรับระยะเริ่มต้นนี้

ความสามารถที่มีให้ใช้งาน

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

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

ตั้งค่า

หากต้องการเชื่อมต่อ IDE หรือผู้ช่วยการเขียนโค้ดกับเซิร์ฟเวอร์ MCP ของข้อมูลผู้ขาย ให้อัปเดตการตั้งค่าไคลเอ็นต์ MCP เช่น อัปเดตไฟล์ mcp.json สำหรับ Claude Desktop, Antigravity, Visual Studio Code หรือเฟรมเวิร์กเอเจนต์ที่กำหนดเอง

การตั้งค่าเซิร์ฟเวอร์ MCP ในเครื่องต้องใช้บัญชีบริการ ผู้ใช้มาตรฐาน ไม่รองรับ OAuth สำหรับการดำเนินการในเครื่องแบบไม่มีส่วนหัวนี้ คุณต้องสร้าง บัญชีบริการ ดาวน์โหลดไฟล์คีย์ส่วนตัว JSON ของบัญชี และระบุเส้นทางไปยังไฟล์ดังกล่าว พร้อมกับรหัส Merchant Center ที่เฉพาะเจาะจงเป็นอาร์กิวเมนต์

ดูวิธีการสร้างและดาวน์โหลดบัญชีบริการแบบละเอียดได้ที่คู่มือบัญชีบริการ

การกำหนดค่าไคลเอ็นต์

การตั้งค่าการกำหนดค่า

Antigravity

ทำตามวิธีการในเอกสารประกอบของ Antigravity

{
    "mcpServers": {
        "merchant-data-mcp": {
            "command": "npx",
            "args": [
                "-y",
                "@google/merchant-data-mcp",
                "--credentials",
                "/path/to/your/service-account-file.json"
            ]
        }
    }
}

Claude Desktop

ทำตามวิธีการในเอกสารประกอบของ Claude Desktop

{
    "mcpServers": {
        "merchant-data-mcp": {
            "command": "npx",
            "args": [
                "-y",
                "@google/merchant-data-mcp",
                "--credentials",
                "/path/to/your/service-account-file.json"
            ]
        }
    }
}

ตัวอย่างสถานการณ์การใช้งาน

เซิร์ฟเวอร์ MCP ของข้อมูลผู้ขายช่วยให้ตัวแทนโต้ตอบกับข้อมูล Merchant Center ที่ใช้งานจริงได้ ต่อไปนี้เป็นสถานการณ์ตัวอย่างทั่วไป:

สถานการณ์ที่ 1: วินิจฉัยการไม่อนุมัติผลิตภัณฑ์

คุณต้องการทราบสาเหตุที่ผลิตภัณฑ์หนึ่งๆ ไม่แสดงในผลการค้นหาของ Google

พรอมต์ของผู้ใช้:

"เหตุใดผลิตภัณฑ์ที่มีรหัสข้อเสนอ 'offer123' ของฉันจึงไม่ได้รับอนุมัติ"

พฤติกรรมของตัวแทนที่มี MCP

1. ตัวแทนจะเรียกใช้ list_products หรือ get_product_by_name เพื่อค้นหาสถานะผลิตภัณฑ์
2. เซิร์ฟเวอร์ MCP จะแสดงสถานะผลิตภัณฑ์ รวมถึงรายการissues (เช่น "รูปแบบราคาไม่ถูกต้อง" หรือ "ไม่มีค่าการจัดส่ง")
3. โดยเอเจนต์จะวิเคราะห์ปัญหาและอธิบายสาเหตุหลักให้คุณทราบ พร้อมแนะนำวิธีแก้ไข (เช่น การอัปเดตข้อมูลราคา)

สถานการณ์ที่ 2: ตรวจสอบการปรับปรุงอัตโนมัติ

คุณต้องการตรวจสอบว่าการปรับปรุงการจัดส่งอัตโนมัติใช้งานอยู่หรือไม่

พรอมต์ของผู้ใช้:

"ฉันเปิดใช้การปรับปรุงการจัดส่งอัตโนมัติแล้วใช่ไหม"

พฤติกรรมของตัวแทนที่มี MCP

1. Agent จะเรียกใช้ get_automatic_improvements เพื่อดึงข้อมูล การตั้งค่าระดับบัญชี
2. เซิร์ฟเวอร์ MCP จะแสดงการกำหนดค่าที่แสดงสถานะของการปรับปรุงรูปภาพ สินค้า และการจัดส่ง
3. ตัวแทนจะยืนยันว่าการปรับปรุงการจัดส่งใช้งานอยู่ หรืออธิบาย วิธีเปิดใช้หากปิดอยู่

สถานการณ์ที่ 3: เมตริกประสิทธิภาพการค้นหา

คุณต้องการตรวจสอบประสิทธิภาพล่าสุดอย่างรวดเร็วโดยไม่ต้องไปที่ UI ของ Merchant Center

พรอมต์ของผู้ใช้:

"แสดงผลิตภัณฑ์ 5 รายการที่มีประสิทธิภาพสูงสุดตามจำนวนคลิกของสัปดาห์ที่แล้ว"

พฤติกรรมของตัวแทนที่มี MCP

1. เอเจนต์สร้างคำค้นหา Merchant Center Query Language (MCQL) โดยกำหนดเป้าหมายไปที่ตาราง product_performance_view เรียงตาม clicks DESC และจำกัดไว้ที่ 5
2. Agent จะเรียกใช้ report_search ด้วยการค้นหาที่สร้างขึ้น
3. เซิร์ฟเวอร์ MCP จะเรียกใช้การค้นหาในฐานข้อมูลการรายงานแบบเรียลไทม์ และแสดงผลแถว
4. Agent จะจัดรูปแบบผลลัพธ์เป็นตารางมาร์กดาวน์ที่เป็นระเบียบให้คุณ

รายการเครื่องมือที่มีให้ใช้งานโดยละเอียด

เซิร์ฟเวอร์ MCP จะแสดงเครื่องมือต่อไปนี้ต่อ Agent ของคุณ

เครื่องมือ MCP	คำอธิบาย
get_product_by_name	รับข้อมูลผลิตภัณฑ์สำหรับผู้ขายที่ระบุโดยใช้ชื่อทรัพยากรผลิตภัณฑ์ที่แน่นอน แสดงสถานะผลิตภัณฑ์โดยละเอียดซึ่งมีบริบทการรายงานและปัญหาที่อาจเกิดขึ้นในระดับผลิตภัณฑ์
list_products	แสดงหรือค้นหาสินค้าหลายรายการสำหรับผู้ขายที่ระบุ แสดงสถานะผลิตภัณฑ์โดยละเอียดซึ่งมีบริบทการรายงานและปัญหาที่อาจเกิดขึ้นในระดับผลิตภัณฑ์
report_search	ค้นหาตารางการรายงานเพื่อดึงเมตริกประสิทธิภาพ สถานะผลิตภัณฑ์ และข้อมูลเชิงลึกด้านราคา ดูรายละเอียดได้ที่คำแนะนำเกี่ยวกับรายงาน
list_data_sources	แสดงแหล่งข้อมูลสำหรับผู้ขายที่ระบุ
get_data_source	ดูรายละเอียดของแหล่งข้อมูลที่เฉพาะเจาะจง
create_data_source	สร้างแหล่งข้อมูลสำหรับผู้ขายที่ต้องการ
fetch_data_source	ดึงและประมวลผลไฟล์ที่เชื่อมโยงกับแหล่งข้อมูลของผู้ขายที่ระบุ
get_file_upload	ดูสถานะการอัปโหลดไฟล์ล่าสุดสำหรับแหล่งข้อมูลที่ระบุ
list_accounts	แสดงรายการบัญชีสำหรับผู้ใช้ที่ระบุ
list_account_issues	แสดงปัญหาระดับบัญชีของผู้ขายที่ระบุเพื่อระบุปัญหาทั่วทั้งบัญชี
list_programs	แสดงรายการโปรแกรมสำหรับผู้ขายที่ระบุ รวมถึงสถานะการเข้าร่วม ภูมิภาคที่ใช้งานอยู่ และข้อกำหนดที่ยังไม่เป็นไปตามเกณฑ์
list_aggregated_product_issues	แสดงปัญหาระดับผลิตภัณฑ์ที่รวบรวมไว้เพื่อตรวจสอบประสิทธิภาพโดยรวมของข้อมูลสินค้า
get_automatic_improvements	รับการตั้งค่าการปรับปรุงอัตโนมัติ ซึ่งรวมถึงการอัปเดตสินค้า การปรับปรุงรูปภาพ และการปรับปรุงการจัดส่ง