Skip to Content
Referenceการรวม MCP

การรวม MCP

OpenFactory รองรับ Model Context Protocol  เพื่อให้ผู้ช่วย AI ช่วยสร้างบิลด์ ตรวจสูตร จัดการ VM และทบทวนผลการทดสอบ

ใช้ MCP เมื่อต้องการทำงานกับ OpenFactory จาก Claude, Cursor, Claude Code, OpenAI Codex หรือไคลเอนต์ที่เข้ากันได้กับ MCP โดยไม่สลับไปมาระหว่างเครื่องมือ

ข้อกำหนด

  • ไคลเอนต์ MCP ที่รองรับเซิร์ฟเวอร์ MCP ระยะไกล
  • สำหรับการเข้าถึงที่ผูกบัญชี ให้ลงชื่อเข้าใช้ OpenFactory ในเบราว์เซอร์นี้
  • สำหรับการเข้าถึงแบบแขก ใช้โทเค็นแขกที่ถูกสร้างด้านล่าง

คีย์ API ของบัญชีแสดงครั้งเดียวตอนสร้าง และเพิกถอนได้จากคอนโซล โทเค็นแขกเป็นตัวระบุเบราว์เซอร์สำหรับการเข้าถึงแบบคิดปริมาณ ไม่ใช่ความลับของบัญชี

จุดสิ้นสุด

การขนส่งURLการใช้
Streamable HTTPhttps://console.openfactory.tech/mcp-stream/mcpจุดสิ้นสุด MCP ของ OpenFactory

Streamable HTTP เป็นการขนส่งเดียวที่รองรับ จุดสิ้นสุด HTTP+SSE แบบเก่า (/mcp/sse, /mcp/messages) ถูกเลิกใช้แล้วและตอนนี้คืน 410 Gone ให้ชี้ไคลเอนต์ที่ยังใช้อยู่ไปที่ URL Streamable HTTP ด้านบน พร้อมส่วนหัว Authorization เดิม Claude Code, Claude Desktop, Cursor, Codex และ OpenCode รองรับ Streamable HTTP ทั้งหมด

การตั้งค่าแบบคัดลอกวาง

Preparing your MCP config...

รีสตาร์ท Claude Desktop, Cursor, OpenAI Codex หรือไคลเอนต์ MCP ที่รันนานตัวอื่นหลังจากเปลี่ยนการตั้งค่า MCP OpenAI Codex อ่านเซิร์ฟเวอร์ MCP จาก ~/.codex/config.toml และเชื่อมต่อ Streamable HTTP โดยตรง ไม่ต้องมีสะพาน mcp-remote ตัวเชื่อมต่อกำหนดเองของ Claude.ai อาจขอ URL เซิร์ฟเวอร์และส่วนหัวเป็นฟิลด์แยก

ความสามารถที่มี

OpenFactory เปิดเครื่องมือสำหรับลูกค้าในเรื่อง:

หมวดตัวอย่าง
บิลด์แสดงรายการบิลด์ สร้างบิลด์จากสูตร ตรวจสถานะบิลด์ ลองบิลด์ที่ล้มเหลวอีกครั้ง
สูตรเรียกดูเทมเพลต ตรวจสูตร ปรับแต่งเทมเพลต
อิมเมจรับลิงก์ดาวน์โหลดสำหรับอาร์ติแฟกต์ที่เสร็จแล้ว
VMแสดงรายการ VM สร้าง VM ทดสอบ เริ่มหรือหยุด VM เปิดลิงก์คอนโซล
การทดสอบรันการตรวจ แสดงรายการรันทดสอบ ตรวจผลการทดสอบ จัดการชุดทดสอบที่ใช้ซ้ำได้
การทดสอบ UI ของแอปขับ VM ผู้ทดสอบเพื่อทดสอบ URL ของแอปใดก็ได้: สถานการณ์ GUI ที่ใช้ซ้ำและแข็งตัวเอง ไม่ต้องปรับใช้
การปรับใช้แอปปรับใช้ที่เก็บ Git เป็นเว็บแอปที่ใช้งานจริง พร้อม URL ดูตัวอย่างสาธารณะ (https://<slug>.apps.openfactory.tech)

ความพร้อมใช้ของเครื่องมืออาจต่างกันตามแผนและสิทธิ์องค์กร

ชุดทดสอบที่ใช้ซ้ำได้

ชุดทดสอบสามารถสร้างได้ก่อนที่ตัวแปรหรือ ISO จะถูกสร้าง กำหนด กรณีทดสอบตั้งแต่หนึ่งรายการ การยืนยันกำหนดเอง การทดสอบที่กำหนดไว้ล่วงหน้า และช่องเป้าหมาย ISO ที่มีชื่อ เช่น primary, client หรือ server เมื่อบิลด์พร้อม ให้ผูกแต่ละ ช่องกับบิลด์ที่เสร็จแล้วแล้วรันชุด

เครื่องมือการใช้
create_test_suiteสร้างชุดที่ใช้ซ้ำได้โดยไม่ต้องมีตัวแปรที่สร้างแล้ว
list_test_suitesแสดงชุดที่ผู้ใช้ MCP ปัจจุบันใช้ได้
get_test_suiteดูคำจำกัดความชุดและประวัติรันล่าสุด
update_test_suite_targetsผูกช่องเป้าหมาย ISO ที่มีชื่อกับบิลด์ที่เสร็จแล้ว
run_test_suiteรันชุดกับช่องเป้าหมาย ISO ที่ผูกแล้ว
list_test_suite_runsแสดงรันที่สร้างจากชุด
get_test_suite_statusดูความพร้อมในการเขียนและสถานะรันล่าสุด

การทดสอบ UI ของแอป: URL ใดก็ได้ ไม่ต้องปรับใช้

ทดสอบ ส่วนติดต่อผู้ใช้ของเว็บแอปใดก็ได้ โดยชี้ VM ผู้ทดสอบที่จัดการไปที่ URL คุณไม่ต้องปรับใช้แอปด้วย OpenFactory เพื่อทดสอบ VM ผู้ทดสอบ เปิดเซิร์ฟเวอร์พัฒนาในเครื่อง การปรับใช้ดูตัวอย่าง/สภาพแวดล้อมจริงบน Vercel, AWS, Netlify หรือโฮสต์ใดก็ได้ หรือ URL สาธารณะใดที่ VM เข้าถึงได้ แอปของคุณยังอยู่ ที่ที่รันอยู่แล้ว

สถานการณ์เขียนด้วยภาษาธรรมดาและ แข็งตัวเอง: รันแรก เรียนรู้ตำแหน่งของแต่ละองค์ประกอบ UI และรันถัดไปเล่นซ้ำจากความจำนั้น (ข้าม รอบภาพที่ช้า) ทำให้การเล่นซ้ำเร็วและทนต่อการเปลี่ยน UI เล็กน้อย สถานการณ์รองรับ ตัวแปรสภาพแวดล้อม (${VAR}) และ 2FA (${totp:VAR}, RFC 6238) สำหรับ การลงชื่อเข้าใช้ ความลับถูกส่งตอนรันและไม่ถูกเก็บ

เครื่องมือการใช้
ensure_tester_vmรับหรือสร้าง VM ผู้ทดสอบเดสก์ท็อปที่คงอยู่
create_app_scenarioบันทึกสถานการณ์ GUI ที่ใช้ซ้ำสำหรับ URL ของแอป
run_app_scenarioรัน (ส่งความลับตอนรันที่นี่) และบันทึกภาพหน้าจอ + คำตัดสิน
list_app_scenarios / get_app_scenarioเรียกดูสถานการณ์และแคชที่แข็งแล้ว
start_app_test / record_app_test_step / finish_app_testขับและบันทึกรันเฉพาะกิจด้วยตนเอง
annotate_screenshotวาดกล่องเน้นที่มีป้ายบนภาพหน้าจอ

ดู การทดสอบ UI ของแอป สำหรับเวิร์กโฟลว์เต็ม สคีมา ขั้นตอน และตัวอย่าง 2FA

การปรับใช้แอป: ที่เก็บ Git สู่ URL สาธารณะ

ปรับใช้เว็บแอปตรงจากที่เก็บ Git แล้วได้ URL ดูตัวอย่างสาธารณะ (https://<slug>.apps.openfactory.tech) ที่เปิด แชร์ หรือชี้สถานการณ์ทดสอบได้ OpenFactory โคลนที่เก็บ ติดตั้งส่วนที่พึ่งพา เริ่มแอป และตรวจสุขภาพให้ ไม่มีอะไรต้องต่อสาย ไม่ต้องส่งต่อพอร์ต อุโมงค์ หรือ DNS

สิ่งนี้จับคู่กับการทดสอบ UI ของแอป: ปรับใช้แอปแล้วรันสถานการณ์กับ URL ดูตัวอย่าง หรือข้ามการปรับใช้แล้วทดสอบแอปที่คุณโฮสต์อยู่แล้ว (Vercel, AWS, ฯลฯ)

เครื่องมือการใช้
create_appลงทะเบียนที่เก็บ Git เป็นแอป (ชื่อ แหล่ง slug)
deploy_appปรับใช้แอปและคืน URL ดูตัวอย่างสาธารณะ
list_apps / get_appเรียกดูแอป URL และประวัติการปรับใช้
iterate_appส่งการเปลี่ยนแปลงภาษาธรรมชาติไปยังแอป เอเจนต์นำไปใช้แล้วปรับใช้อีกครั้ง
get_app_build_statusโพลสถานะการปรับใช้ของแอปและตั๋วการเปลี่ยนแปลงที่กำลังทำ

ดู การปรับใช้แอป สำหรับเวิร์กโฟลว์เต็ม เพื่อให้ ผู้ใช้ของคุณพูดการเปลี่ยนแปลงไปยังแอปจากปุ่มไมค์ ดู วิดเจ็ต Voice Iterate

ตัวอย่างพรอมต์

Show my most recent OpenFactory builds and summarize any failures.
Create a Debian server image with SSH, Docker, a deploy user, and default verification tests.
Validate this recipe before I start a build.
Start a VM from my latest completed build and give me the console link.
Create a reusable smoke test suite for example-project with primary and client ISO slots. I will bind the builds later.
Create a smoke-login scenario for my app at https://my-app.vercel.app, run it in a tester VM, and verify the dashboard loads. I'll give you the password and 2FA seed at run time.

หมายเหตุความปลอดภัย

  • ใช้คีย์ API เฉพาะกับไคลเอนต์ที่คุณไว้ใจ
  • เพิกถอนคีย์เก่าจากคอนโซลเมื่อหมุนเครื่องหรือออกจากโครงการ
  • เลือกสิทธิ์เครื่องมือที่ต้องอนุมัติสำหรับการกระทำที่สร้างบิลด์ เริ่ม VM หรือเปลี่ยนโครงสร้างพื้นฐาน
  • อย่าวางคีย์ API ของ OpenFactory ในพรอมต์ ตั๋ว ที่เก็บสาธารณะ หรือเอกสารที่ใช้ร่วมกัน

การแก้ปัญหา

เครื่องมือไม่ปรากฏ

รีสตาร์ทไคลเอนต์ MCP และยืนยันว่า URL เซิร์ฟเวอร์ตรงกับ:

https://console.openfactory.tech/mcp-stream/mcp

หากไคลเอนต์ถูกตั้งด้วย URL /mcp/sse ที่เลิกใช้แล้ว จะได้ 410 Gone: เปลี่ยน URL เป็นด้านบน ไม่ต้องเปลี่ยนอย่างอื่น

การยืนยันตัวตนล้มเหลว

รีเฟรชหน้านี้แล้วคัดลอกการตั้งค่าที่ถูกสร้างอีกครั้ง ผู้ใช้ที่ลงชื่อเข้าใช้ควรใช้ส่วนหัว Authorization ที่ถูกสร้าง ผู้ใช้แขกควรใช้ส่วนหัว X-Guest-Id ที่ถูกสร้างจากการตั้งค่าคัดลอกวางด้านบน

การกระทำบิลด์หรือ VM ล้มเหลว

ตรวจแผน OpenFactory สิทธิ์องค์กร และสถานะบิลด์ บางการกระทำต้องการบิลด์ที่เสร็จแล้ว สิทธิ์ VM ที่คงอยู่ หรือสิทธิ์ระดับองค์กร

ข้อผิดพลาดการขนส่ง

อัปเดตไคลเอนต์ MCP หากยังไม่รองรับ Streamable HTTP หากอัปเดตไม่ได้ ให้สลับไปยังจุดสิ้นสุดความเข้ากันได้ HTTP+SSE