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

ทุกเครื่องมือ MCP แมปกับความสามารถในขอบเขตองค์กร ปฏิเสธโดยค่าเริ่มต้น: API key ต้องมี[ขอบเขตสิทธิ์ MCP](/th/api/mcp/#ขอบเขตสิทธิ์-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` | เขียน | ยกเลิกลิงก์ |

:::note
`voucher_webhook` ไม่รองรับผ่าน MCP การอ่านไม่คืนความลับของผู้ให้บริการ
:::

## AI

**ขอบเขต:** `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 วัน)

ดู[โทเค็นเซสชัน](/th/api/session-tokens/) สำหรับรูปแบบ URL ผู้เล่นและวงจรชีวิต

## สรุปข้อกำหนดบทบาท

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

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