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

*เนื้อหานี้แปลโดยใช้ AI (เวอร์ชัน Beta) และอาจมีข้อผิดพลาด หากต้องการดูหน้านี้เป็นภาษาอังกฤษ ให้คลิกที่นี่

เซิร์ฟเวอร์ 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อ่านสคริปต์จากเกมโดยใช้เส้นทางแบบ dot-notation (เช่น game.ServerScriptService.MyScript) รองรับการอ่านสคริปต์ทั้งหมดหรือช่วงบรรทัดเฉพาะ
multi_editใช้การแก้ไขหลายรายการในสคริปต์ในหนึ่งการดำเนินการ หากเส้นทางเป้าหมายไม่มีอยู่ จะสร้างสคริปต์ใหม่ ต้องระบุ datamodel_type (Edit)
script_searchค้นหาสคริปต์ตามชื่อโดยใช้การจับคู่แบบ fuzzy คืนค่าผลลัพธ์ได้สูงสุด 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อัปโหลดชุดรูปภาพจาก URL HTTP ไปยังเซิร์ฟเวอร์ทรัพย์สิน 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 รวมถึงสถานะการเล่นและประเภทโมเดลข้อมูลที่มีอยู่
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, Cloud API, คู่มือการเพิ่มประสิทธิภาพ) รองรับการค้นหาคำสำคัญภายในเนื้อหาที่ดึงมา
skillดึงความรู้โดยละเอียด แนวทางปฏิบัติที่ดีที่สุด หรือเอกสารอ้างอิงสำหรับทักษะเฉพาะ เช่น การดีบัก การจำลองอุปกรณ์ และการค้นหาเอกสาร
การจัดการเซสชัน
list_roblox_studiosแสดงรายการอินสแตนซ์ Studio ที่เชื่อมต่อทั้งหมด รวมถึงชื่อ ID อินสแตนซ์ Studio และ ID สถานที่ สถานที่ท้องถิ่นที่ไม่มี ID สถานที่จะถูกแสดงโดยชื่อเท่านั้น มีประโยชน์เมื่อมีหลายหน้าต่าง Studio เปิดอยู่; หากสองอินสแตนซ์ Studio ที่เปิดอยู่มีชื่อเดียวกัน ID สถานที่จะช่วยให้คุณแยกแยะได้

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

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

  1. เปิด Assistant.
  2. คลิก … ⟩ จัดการเซิร์ฟเวอร์ MCP.
  3. เปิดใช้งาน เปิด Studio เป็นเซิร์ฟเวอร์ MCP.

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

เชื่อมต่อลูกค้าของคุณ

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

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

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

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

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

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

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

  1. ไปที่ การตั้งค่า Assistant ⟩ เซิร์ฟเวอร์ MCP.
  2. ขยายเมนู การเชื่อมต่ออย่างรวดเร็ว เพื่อดูลูกค้าที่ติดตั้งอยู่ในคอมพิวเตอร์ของคุณ
  3. เปิดใช้งานลูกค้าที่คุณเลือก

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

การกำหนดค่า JSON

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

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

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

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 ได้ในเวลาเดียวกัน การเรียกใช้เครื่องมือแต่ละครั้งจะรวมถึง studio_id ที่ระบุอินสแตนซ์ Studio ที่ต้องการ ซึ่งทำให้การทำงานกับหลายอินสแตนซ์ของ Studio และตัวแทนหรือลูกค้าหลายตัวเชื่อถือได้

ใช้ list_roblox_studios เพื่อแสดงรายการอินสแตนซ์ที่เชื่อมต่อพร้อมชื่อ ID อินสแตนซ์ Studio และ ID สถานที่ จากนั้นส่ง ID ของอินสแตนซ์ที่คุณต้องการเป็น studio_id ในการเรียกครั้งถัดไป

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

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

  1. เปิด Assistant.
  2. คลิก … ⟩ จัดการเซิร์ฟเวอร์ MCP.
  3. ภายใต้ เปิด Studio เป็นเซิร์ฟเวอร์ MCP ให้ตรวจสอบตัวบ่งชี้สีเขียวเพื่อยืนยันว่าลูกค้าเชื่อมต่อสำเร็จ

การแก้ไขปัญหา

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

  • รีสตาร์ททั้ง Roblox Studio และลูกค้า MCP ของคุณ
  • ตรวจสอบว่าคำสั่งหรือพาธของไบนารีถูกต้องและไฟล์มีอยู่
  • ตรวจสอบไวยากรณ์ JSON ของคุณ แม้แต่การขาดเครื่องหมายจุลภาคหรือวงเล็บก็สามารถป้องกันไม่ให้การกำหนดค่าถูกโหลดได้
©2026 Roblox Corporation. Roblox, โลโก้ Roblox และ Powering Imagination เป็นส่วนหนึ่งของเครื่องหมายการค้าที่จดทะเบียน และไม่ได้จดทะเบียนของเราในสหรัฐฯ และประเทศอื่นๆ
เงื่อนไข·ความเป็นส่วนตัว·การเข้าถึง·ฝ่ายบริการช่วยเหลือ
ภาษาไทย