เชื่อมต่อกับเซิร์ฟเวอร์ MCP ของ Roblox Studio | เอกสาร

เซิร์ฟเวอร์ MCP ของ Roblox Studio ถูกสร้างขึ้นใน Roblox Studio โดยนำเสนอ Model Context Protocol (MCP) ซึ่งเป็นมาตรฐานเปิดที่ช่วยให้เครื่องมือ AI สื่อสารกับแอปพลิเคชันภายนอกได้อย่างปลอดภัย หลังจากเชื่อมต่อแล้ว ไคลเอนต์ AI ของคุณสามารถโต้ตอบโดยตรงกับเซสชัน Studio ที่เปิดอยู่ของคุณ สำรวจโมเดลข้อมูล เขียนสคริปต์ รันโค้ด Luau และทดสอบประสบการณ์ของคุณในโหมดการเล่น

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

สิ่งที่ต้องมี

ก่อนที่คุณจะสามารถเชื่อมต่อกับเซิร์ฟเวอร์ได้ ให้ตรวจสอบให้แน่ใจว่าคุณมี เวอร์ชันล่าสุดของ Roblox Studio และมี MCP ไคลเอนต์ที่คุณชื่นชอบ ติดตั้งอยู่ในคอมพิวเตอร์ของคุณ

วิธีการทำงานของเซิร์ฟเวอร์ MCP ของ Studio

เซิร์ฟเวอร์ทำงานเป็นกระบวนการท้องถิ่นบนเครื่องของคุณและสื่อสารกับไคลเอนต์ AI โดยใช้ stdio transport ซึ่งใช้สตรีมข้อมูลนำเข้า/ส่งออกมาตรฐาน การกระทำทั้งหมดจะเริ่มต้นผ่านไคลเอนต์ AI ของคุณ ซึ่งจะส่งคำขอผ่านช่องนี้ไปยังการดำเนินการภายในเซสชัน Studio ของคุณ

เซิร์ฟเวอร์มีเครื่องมือดังต่อไปนี้:

สคริปต์
script_read	อ่านสคริปต์จากเกมโดยใช้เส้นทางแบบจุด (ตัวอย่างเช่น game.ServerScriptService.MyScript) รองรับการอ่านสคริปต์ทั้งหมดหรือช่วงบรรทัดเฉพาะ
multi_edit	ทำการแก้ไขหลายอย่างในสคริปต์ในการทำงานครั้งเดียว หากเส้นทางที่กำหนดเป้าหมายไม่มีอยู่ มันจะสร้างสคริปต์ใหม่ ต้องการระบุ datamodel_type (Edit)
script_search	ค้นหาสคริปต์ตามชื่อโดยใช้การจับคู่ที่ไม่เข้มงวด คืนค่าผลลัพธ์ได้สูงสุด 10 รายการ
script_grep	ค้นหารูปแบบสตริงในทุกสคริปต์ในเกม คืนค่าการจับคู่ได้สูงสุด 50 รายการ
การสร้างองค์ประกอบและเนื้อหา
generate_mesh	สร้างเมช 3D ที่มีพื้นผิวจากคำสั่งข้อความโดยใช้ AI
generate_material	สร้างการเปลี่ยนแปลงวัสดุแบบกำหนดเอง คืนค่าวัสดุพื้นฐานและชื่อการเปลี่ยนแปลงวัสดุที่ใช้กับส่วนต่าง ๆ
generate_procedural_model	สร้างวัตถุ 3D ที่สร้างจากส่วนพื้นฐาน (บล็อก, ลูกบอล, กระบอก, วี) เป็น ProceduralModel ที่มีคุณลักษณะที่กำหนดได้ รองรับภาพอ้างอิงและรูปแบบชิ้นส่วนกำหนดเอง
wait_job_finished	รอให้การสร้างโมเดลเชิงพาณิชย์เสร็จสิ้นและคืนค่าสถานะสุดท้าย
search_asset	ค้นหาทรัพย์สินใน Creator Store (ตลาดสาธารณะ) และ Creator Inventory (ผู้ใช้, กลุ่ม, หรือจักรวาล) รองรับการกรองตามประเภททรัพย์สิน ราคา แท็ก และขอบเขต
insert_asset	แทรกทรัพย์สินเข้าสู่เกมโดยใช้หมายเลข ID ของทรัพย์สิน Roblox รองรับโมเดล เมช รูปภาพ เสียง วิดีโอ แอนิเมชัน และแพ็คเกจ
upload_image	อัปโหลดชุดรูปภาพจาก HTTP URLs ไปยังเซิร์ฟเวอร์ทรัพย์สินของ Roblox คืนค่าที่อยู่ภาพไปยังแผนที่ ID ของทรัพย์สิน
store_image	โหลดภาพจากเส้นทางไฟล์ในเครื่องและคืนค่า URI ของภาพที่สามารถส่งไปยังเครื่องมืออื่น ๆ (ตัวอย่างเช่น เป็นภาพอ้างอิงสำหรับ generate_procedural_model)
การสำรวจโมเดลข้อมูล
subagent	เปิด subagent ที่เชี่ยวชาญเพื่อตอบสนองต่อการทำงานที่ซับซ้อนและหลายขั้นตอนโดยอัตโนมัติ ประเภทที่มีอยู่รวมถึง explore (สำหรับการตรวจสอบโค้ดและการสอบถามสถานะเกม) และ playtest (สำหรับการรันสถานการณ์การเล่นเกมและยืนยันผลลัพธ์)
search_game_tree	สำรวจลำดับชั้นของอินสแตนซ์เป็นอาร์เรย์ JSON แบน สามารถกรองตามเส้นทาง ประเภทของอินสแตนซ์ และคำสำคัญ โดยมีการตั้งค่าขีดจำกัดความลึก
inspect_instance	คืนค่าข้อมูลโดยละเอียดเกี่ยวกับอินสแตนซ์เฉพาะ รวมถึงคุณสมบัติที่อ่านได้ทุกประเภท, แอตทริบิวต์ที่กำหนดเอง, และสรุปของลูกและลูกหลาน
การรัน Luau
execute_luau	รันโค้ด Luau ใน Studio คืนค่าไม่ว่าจะเป็นผลลัพธ์หรือข้อผิดพลาด ต้องระบุ datamodel_type (Edit, Client หรือ Server)
การทดสอบการเล่น
get_studio_state	ดึงสถานะปัจจุบันของ Studio รวมถึงสถานะการเล่นและประเภท datamodel ที่มีอยู่
start_stop_play	เริ่มต้นหรือหยุดการทดสอบการเล่น
get_console_output	ดึงข้อมูลผลลัพธ์จากบันทึกผลลัพธ์ของ Studio
screen_capture	จับภาพมุมมองของ Studio ในปัจจุบันและคืนค่าข้อมูลภาพ อาจรับตำแหน่งกล้องที่กำหนดเองและเป้าหมายการมองมองได้
การจำลองการป้อนข้อมูลจากผู้เล่น
character_navigation	ย้ายตัวละครผู้เล่นไปยังตำแหน่งหรือเส้นทางอินสแตนซ์ที่กำหนด รองรับการปรับความเร็วที่กำหนดได้
user_keyboard_input	ส่งหนึ่งหรือหลายการกระทำด้วยแป้นพิมพ์ตามลำดับ: กดปุ่ม, ปล่อยปุ่ม, กดปุ่ม, ป้อนข้อความ, หรือรอ รองรับการกำหนดเป้าหมายไปยัง UI อินสแตนซ์เฉพาะ
user_mouse_input	ส่งหนึ่งหรือหลายการกระทำด้วยเมาส์ตามลำดับ: ย้าย, คลิก, ปุ่มกด/ปล่อย, เลื่อน, หรือรอ รองรับการกำหนดเป้าหมายไปยังอินสแตนซ์เฉพาะหรือพิกัดหน้าจอ
เอกสารและทักษะ
http_get	ดึงเนื้อหาจาก URL ข้อมูล Roblox ที่อนุญาต (เอกสาร API ของ Engine, เอกสาร Creator, API ของ Cloud, คู่มือการปรับแต่งประสิทธิภาพ) รองรับการค้นหาคำสำคัญภายในเนื้อหาที่ดึงข้อมูลมา
skill	ดึงความรู้ รายการแนวทางที่ดีที่สุด หรือเอกสารอ้างอิงสำหรับทักษะเฉพาะเช่น การดีบัก การจำลองอุปกรณ์ และการค้นหาเอกสาร
การจัดการเซสชัน
list_roblox_studios	แสดงรายชื่อการเปิด Studio ทั้งหมดที่เชื่อมต่อ รวมถึงชื่อ ID และสถานะที่เปิดใช้งาน สะดวกในกรณีที่มีหลายหน้าต่าง Studio เปิดอยู่
set_active_studio	ตั้งอินสแตนซ์ Studio เป็นที่เปิดใช้งานเพื่อให้การเรียกเครื่องมือถัดไปทั้งหมดกำหนดเป้าหมายไปยังอินสแตนซ์นั้น

เปิดใช้งานเซิร์ฟเวอร์ MCP ใน Studio

เพื่อเปิดใช้งานเซิร์ฟเวอร์ MCP ใน Studio:

เปิด Assistant.
คลิก … ⟩ Manage MCP Servers.
เปิดใช้งาน Enable Studio as MCP server.

เมื่อเปิดใช้งานแล้ว แผงการตั้งค่าจะแสดงตัวเลือกการเชื่อมต่ออย่างรวดเร็วและคำแนะนำการตั้งค่าสำหรับไคลเอนต์ต่างๆ เมื่อไคลเอนต์เชื่อมต่อสำเร็จ จะมีตัวบ่งชี้สีเขียวแสดงจำนวนไคลเอนต์ที่เชื่อมต่ออยู่

เชื่อมต่อไคลเอนต์ของคุณ

คุณสามารถเชื่อมต่อไคลเอนต์ของคุณกับเซิร์ฟเวอร์ MCP ของ Studio โดยใช้การเชื่อมต่ออย่างรวดเร็ว การตั้งค่า JSON หรือคำสั่ง CLI

ใช้ quick connect ถ้าไคลเอนต์ของคุณได้รับการสนับสนุน
หากไม่เป็นเช่นนั้น ใช้ JSON configuration หากไคลเอนต์ของคุณรองรับไฟล์การตั้งค่า MCP
มิฉะนั้นใช้ CLI command

เซิร์ฟเวอร์ MCP ของ Studio ทำงานร่วมกับไคลเอนต์ใดๆ ที่รองรับการใช้ stdio transport หลังจากเพิ่มการตั้งค่า ให้ทำตามเอกสารของไคลเอนต์ของคุณเพื่อทำการตั้งค่าต่อไป จากนั้นรีสตาร์ทไคลเอนต์เพื่อให้การเปลี่ยนแปลงทำงาน

MCP ไคลเอนต์สามารถอ่านและแก้ไขเนื้อหาในสถานที่ Roblox ที่เปิดอยู่ของคุณได้ ให้แน่ใจว่าคุณเชื่อมต่อเฉพาะไคลเอนต์ที่คุณเชื่อถือได้

การเชื่อมต่ออย่างรวดเร็ว

การเชื่อมต่ออย่างรวดเร็วรองรับไคลเอนต์ต่อไปนี้:

Antigravity
Codex CLI
Claude Code
Claude Desktop
Cursor
Gemini CLI
Visual Studio Code

เพื่อเชื่อมต่อโดยใช้การเชื่อมต่ออย่างรวดเร็ว:

ไปที่ Assistant Settings ⟩ MCP Servers.
ขยายรายการ Quick connect เพื่อดูรายการไคลเอนต์ที่รองรับที่ติดตั้งในคอมพิวเตอร์ของคุณ
เปิดใช้งานไคลเอนต์ที่คุณเลือก

หากไคลเอนต์ที่คุณต้องการไม่ปรากฏในรายการ Quick connect ให้ติดตั้งและรีสตาร์ท Roblox Studio

การตั้งค่า JSON

ไคลเอนต์ MCP ส่วนใหญ่รองรับไฟล์การตั้งค่า JSON ตัวอย่างด้านล่างแสดงการตั้งค่าแบบครบถ้วนที่คุณสามารถใช้ได้

หาก Roblox Studio เป็นเซิร์ฟเวอร์ MCP เพียงตัวเดียวของคุณ ให้ใช้การตั้งค่าเหล่านี้ตามที่เป็นอยู่ หากคุณใช้หลายเซิร์ฟเวอร์ MCP ให้คัดลอกข้อมูล Roblox_Studio แล้วเพิ่มเข้าไปในพจนานุกรม mcpServers ที่มีอยู่ของคุณ

ไฟล์ mcp.json ของคุณอาจมีรายการอื่นอยู่แล้ว เมื่อเพิ่มการตั้งค่า Roblox_Studio ให้ตรวจสอบว่าแต่ละรายการแยกจากกันด้วยเครื่องหมายจุลภาค เครื่องหมายจุลภาคที่ขาดหายไปจะทำให้ JSON ไม่ถูกต้องและทำให้การตั้งค่าล้มเหลวในการโหลด

การตั้งค่าจะแตกต่างกันไปตามระบบปฏิบัติการ:

Windows
{
  "mcpServers": {
    "Roblox_Studio": {
      "command": "cmd.exe",
      "args": [
        "/c",
        "%LOCALAPPDATA%\\Roblox\\mcp.bat"
      ]
    }
  }
}

macOS
{
  "mcpServers": {
    "Roblox_Studio": {
      "command": "/Applications/RobloxStudio.app/Contents/MacOS/StudioMCP"
    }
  }
}

คำสั่ง CLI

ไคลเอนต์ MCP บางตัวต้องการคำสั่ง CLI แทนที่จะเป็นการตั้งค่า JSON ใช้คำสั่งที่เหมาะสมสำหรับระบบปฏิบัติการของคุณ:

Windows
cmd.exe /c %LOCALAPPDATA%\Roblox\mcp.bat

macOS
/Applications/RobloxStudio.app/Contents/MacOS/StudioMCP

ใช้งานหลายอินสแตนซ์ Studio

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

คุณสามารถสลับอินสแตนซ์ด้วยตนเองโดยใช้ list_roblox_studios และ set_active_studio

ตรวจสอบการเชื่อมต่อของคุณ

หลังจากตั้งค่าไคลเอนต์ของคุณแล้ว ให้ตรวจสอบว่าการเชื่อมต่อทำงานใน Roblox Studio:

เปิด Assistant.
คลิก … ⟩ Manage MCP Servers.
ภายใต้ Enable Studio as MCP server ให้ตรวจสอบหาตัวบ่งชี้สีเขียวเพื่อยืนยันว่าไคลเอนต์ได้เชื่อมต่อสำเร็จ

แก้ไขปัญหา

หากเซิร์ฟเวอร์ไม่แสดงหรือเครื่องมือไม่พร้อมใช้งาน:

รีสตาร์ททั้ง Roblox Studio และไคลเอนต์ MCP ของคุณ
ตรวจสอบให้แน่ใจว่าคำสั่งหรือเส้นทางไบนารีถูกต้องและไฟล์มีอยู่
ตรวจสอบไวยากรณ์ JSON ของคุณ แม้แต่เครื่องหมายจุลภาคหรือวงเล็บที่หายไปก็สามารถทำให้การตั้งค่าไม่สามารถโหลดได้