เอกสารอ้างอิงเครื่องมือ 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 |
เขียน | ยกเลิกลิงก์ |
Analytics Providers
หัวข้อที่มีชื่อว่า “Analytics Providers”อ่าน: 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)