ข้ามไปยังเนื้อหา

เอกสารอ้างอิงเครื่องมือ MCP

ทุกเครื่องมือ MCP แมปกับความสามารถในขอบเขตองค์กร ปฏิเสธโดยค่าเริ่มต้น: API key ต้องมีขอบเขตสิทธิ์ MCP ที่ตรงกัน และผู้เรียกต้องมีบทบาทองค์กรขั้นต่ำ

ขอบเขต: mcp:templates:read · บทบาทขั้นต่ำ: viewer

เครื่องมือ คำอธิบาย
list_templates รายการเทมเพลตเกมที่อนุมัติแล้ว พร้อมสคีมาสินทรัพย์และ baseGameConfig
get_template ดึงเทมเพลตหนึ่งรายการตาม id รวมคำใบ้การต่อ config

อินพุตทางเลือกของ list_templates: category (กรองแบบ substring ไม่สนใจตัวพิมพ์)

อ่าน: mcp:games:read · เขียน: mcp:games:write · บทบาทขั้นต่ำ: viewer (อ่าน) / editor (เขียน)

เครื่องมือ ขอบเขต คำอธิบาย
list_games อ่าน รายการเกมขององค์กร; กรอง status ได้
get_game อ่าน ดึงเกมพร้อม config แบบแบนและรางวัลที่ใช้งาน
list_game_prizes อ่าน รายการรางวัลที่ใช้งานของเกม
create_game เขียน สร้างเกมแบบร่างจากเทมเพลต; config แบบแบน + รางวัล (ถ้ามี)
update_game เขียน อัปเดตฟิลด์; config รวมแบบตื้น
set_game_status เขียน ตั้งสถานะเป็น draft, published, หรือ archived
set_game_prizes เขียน ซิงก์ตารางรางวัล (ไม่ใส่ id เพื่อสร้าง; รางวัลที่ไม่อยู่ในอาร์เรย์จะถูกลบ; อาร์เรย์ว่างล้างทั้งหมด)

เปอร์เซ็นต์โอกาสต้องรวมพอดี 100% ต่อ min_score tier

อ่าน: mcp:streams:read · เขียน: mcp:streams:write · บทบาทขั้นต่ำ: viewer (อ่าน) / editor (เขียน)

เครื่องมือ ขอบเขต คำอธิบาย
list_streams อ่าน รายการสตรีมขององค์กร
get_stream อ่าน ดึงสตรีม; เลือก include_games / include_connections ได้
create_stream เขียน สร้างแคมเปญเจอร์นีย์ (สตรีม)
update_stream เขียน อัปเดตฟิลด์สตรีม

อ่าน: mcp:connections:read · เขียน: mcp:connections:write · บทบาทขั้นต่ำ: admin

เครื่องมือ ขอบเขต คำอธิบาย
list_connections อ่าน รายการอินทิเกรชันองค์กร (ไม่มีข้อมูลรับรองดิบ)
get_connection อ่าน รายละเอียดพร้อม has_credentials / credential_keys เท่านั้น
create_connection เขียน สร้างอินทิเกรชัน (เช่น Braze, Zapier)
update_connection เขียน อัปเดตชื่อ คำอธิบาย หรือข้อมูลรับรองที่รองรับ
delete_connection เขียน ลบคอนเนกชันขององค์กร
list_stream_connections อ่าน รายการอินทิเกรชันที่ลิงก์กับสตรีม
link_stream_connection เขียน แนบคอนเนกชันกับสตรีม
update_stream_connection เขียน อัปเดตลิงก์สตรีม–คอนเนกชัน
unlink_stream_connection เขียน ยกเลิกลิงก์

อ่าน: mcp:analytics_providers:read · เขียน: mcp:analytics_providers:write · บทบาทขั้นต่ำ: admin

เครื่องมือ ขอบเขต คำอธิบาย
list_analytics_providers อ่าน รายการคอนฟิก Analytics Provider ขององค์กร (รหัสสาธารณะเท่านั้น)
get_analytics_provider อ่าน ดู Analytics Provider หนึ่งรายการ
create_analytics_provider เขียน สร้างผู้ให้บริการที่ใช้ซ้ำได้ (google_analytics, mixpanel, posthog, amplitude, google_tag_manager, meta_pixel)
update_analytics_provider เขียน อัปเดตชื่อ, config หรือ is_active
delete_analytics_provider เขียน ลบผู้ให้บริการ (ลบลิงก์สตรีมตาม)
list_stream_analytics_providers อ่าน รายการผู้ให้บริการที่ลิงก์กับสตรีม
link_stream_analytics_provider เขียน แนบผู้ให้บริการองค์กรกับสตรีม
update_stream_analytics_provider เขียน อัปเดตลิงก์สตรีม (is_active, config_override)
unlink_stream_analytics_provider เขียน ยกเลิกลิงก์สตรีม (ผู้ให้บริการองค์กรยังอยู่)

รับเฉพาะ measurement ID / project token สาธารณะ — ห้าม secret API keys ดู Analytics Providers

อ่าน: mcp:gallery:read · เขียน: mcp:gallery:write · บทบาทขั้นต่ำ: editor

เครื่องมือ ขอบเขต คำอธิบาย
list_gallery_media อ่าน สื่อแกลเลอรีแบบแบ่งหน้าพร้อมสถิติพื้นที่เก็บ; กรอง source ได้ (upload, generated)
delete_gallery_media เขียน ลบรายการตาม id; ได้ 409 หากยังใช้เป็น thumbnail, โลโก้, สินทรัพย์เกม หรือภาพรางวัล

ดูรายการและพื้นที่เก็บก่อนลบ ดูแกลเลอรี สำหรับเวิร์กโฟลว์ในแดชบอร์ด

อ่าน: mcp:vouchers:read · เขียน: mcp:vouchers:write · บทบาทขั้นต่ำ: viewer (อ่าน) / editor (เขียน)

เครื่องมือ ขอบเขต คำอธิบาย
list_voucher_sets อ่าน รายการชุดบัตรกำนัลพร้อมสถิติรหัสและเกมที่ลิงก์
get_voucher_set อ่าน ดึงหนึ่งชุด; เลือก include_vouchers ได้
create_voucher_set เขียน สร้างชุดบัตรกำนัลว่าง
add_vouchers_to_set เขียน เพิ่มรหัสแบบจำนวนมาก (ตัวพิมพ์ใหญ่; ข้ามซ้ำ; สูงสุด 5,000 ต่อครั้ง)
update_org_voucher_status เขียน ตั้งรหัสเป็น available หรือ claimed
delete_org_voucher เขียน ลบรหัสที่available เท่านั้น (claimed/used ลบไม่ได้)
delete_voucher_set เขียน ลบชุดและรหัสแบบ cascade

หลังสร้างชุดและนำเข้ารหัส ให้ลิงก์กับรางวัลด้วย set_game_prizes โดยใช้ prize_type: voucher_set และ voucher_set_id ดูระบบบัตรกำนัล

ขอบเขต: mcp:reports:read · บทบาทขั้นต่ำ: analyst

เครื่องมือ คำอธิบาย
get_org_analytics_summary สรุปแดชบอร์ดแบบเบา (เล่นรายวัน, รวม, เกมยอดนิยม); สูงสุด 90 วัน
get_org_report รายงาน JSON ละเอียด (รูปเดียวกับ Reports API โดยไม่มี CSV); สูงสุด 365 วัน; ตารางคืนสูงสุด 100 แถว

get_org_report รับ report, start_date, end_date (YYYY-MM-DD) และ game_id / stream_id (ถ้ามี) ประเภทรายงาน: overview, games, streams, prizes, sessions, highscores, streamScoreboard, ctaLeads

ขอบเขต: mcp:ai · บทบาทขั้นต่ำ: editor

เครื่องมือ คำอธิบาย
extract_brand ดึงอัตลักษณ์แบรนด์จาก URL เว็บไซต์
generate_funnel แนะนำขั้นตอนฟันเนลจาก URL แบรนด์หรือบรีฟ
generate_image สร้างสินทรัพย์เกมหนึ่งชิ้นด้วย Gemini; PNG โปร่งใสได้; เก็บในแกลเลอรีองค์กร
generate_images สร้างสูงสุด 8 ชิ้นแบบขนาน; แนะนำสำหรับเทมเพลตหลายสินทรัพย์

สำหรับการสร้างอาร์ต ส่ง width, height, transparent, และ prompt_wrapper จากสคีมาสินทรัพย์เทมเพลต สำหรับ generate_images ตั้ง asset_key ของแต่ละรายการเป็น asset.name แล้วต่อ URL ที่ได้เข้า game.config ด้วย update_game หากมีสินทรัพย์เกิน 8 ให้สร้างเกมด้วย placeholder ก่อน แล้วสร้างเป็นชุด

ขอบเขต: mcp:sessions:write · บทบาทขั้นต่ำ: editor

เครื่องมือ คำอธิบาย
create_play_session ออกโทเค็นเซสชันการเล่นแบบใช้ครั้งเดียวสำหรับ game_id หรือ stream_id (เหมือน REST create-session)

อินพุตทางเลือก: external_ref, metadata, expires_in_minutes (สูงสุด 7 วัน)

ดูโทเค็นเซสชัน สำหรับรูปแบบ URL ผู้เล่นและวงจรชีวิต

บทบาทขั้นต่ำ เครื่องมือ
viewer อ่านเทมเพลต เกม/สตรีม และบัตรกำนัล
analyst เครื่องมือรายงาน
editor เขียนเกม/สตรีม, แกลเลอรี, เขียนบัตรกำนัล, AI, ออกเซสชัน
admin เครื่องมือคอนเนกชันและ Analytics Providers ทั้งหมด

API key ยังใช้โมเดลสมาชิกองค์กรสำหรับตรวจบทบาทเมื่อเรียกผ่าน MCP รายการอนุญาตทรัพยากรบนคีย์ยังมีผลอยู่

ความสามารถเดียวกันขับเคลื่อนผู้ช่วยในแอป (ยืนยันตัวตนด้วยผู้ใช้ที่ลงชื่อเข้าใช้ ไม่ใช่ API key)