เอกสารอ้างอิงเครื่องมือ 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:ai · บทบาทขั้นต่ำ: editor
| เครื่องมือ | คำอธิบาย |
|---|---|
extract_brand |
ดึงอัตลักษณ์แบรนด์จาก URL เว็บไซต์ |
generate_funnel |
แนะนำขั้นตอนฟันเนลจาก URL แบรนด์หรือบรีฟ |
generate_image |
สร้างสินทรัพย์เกมด้วย Gemini; PNG โปร่งใสได้; เก็บในที่เก็บขององค์กร |
สำหรับการสร้างอาร์ต ส่ง width, height, transparent, และ prompt_wrapper จากสคีมาสินทรัพย์เทมเพลต แล้วต่อ url ที่ได้เข้า game.config ด้วย update_game โดยใช้ชื่อคีย์แบนของสินทรัพย์
ขอบเขต: mcp:sessions:write · บทบาทขั้นต่ำ: editor
| เครื่องมือ | คำอธิบาย |
|---|---|
create_play_session |
ออกโทเค็นเซสชันการเล่นแบบใช้ครั้งเดียวสำหรับ game_id หรือ stream_id (เหมือน REST create-session) |
อินพุตทางเลือก: external_ref, metadata, expires_in_minutes (สูงสุด 7 วัน)
ดูโทเค็นเซสชัน สำหรับรูปแบบ URL ผู้เล่นและวงจรชีวิต
สรุปข้อกำหนดบทบาท
หัวข้อที่มีชื่อว่า “สรุปข้อกำหนดบทบาท”| บทบาทขั้นต่ำ | เครื่องมือ |
|---|---|
| viewer | อ่านเทมเพลตและเกม/สตรีม |
| editor | เขียนเกม/สตรีม, AI, ออกเซสชัน |
| admin | เครื่องมือคอนเนกชันทั้งหมด |
API key ยังใช้โมเดลสมาชิกองค์กรสำหรับตรวจบทบาทเมื่อเรียกผ่าน MCP รายการอนุญาตทรัพยากรบนคีย์ยังมีผลอยู่