รับดีไซน์ฟรีของคุณ
ความช่วยเหลือ · เอเจนต์ (MCP)

ตั้งค่าเซิร์ฟเวอร์ MCP ของ Mokbi

สรุปสั้น ๆ เพิ่มเซิร์ฟเวอร์เข้าไปในเอเจนต์ ล็อกอินหนึ่งครั้งจากเทอร์มินัล แล้วขอ /mokbi:screenshots เอเจนต์จะเก็บภาพแอปของคุณในทุกภาษาบนเครื่องของคุณเอง และวางชุดภาพไว้ในโปรเจกต์ Mokbi ของคุณ จากนั้นคุณกดใช้งานในเอดิเตอร์เพียงครั้งเดียว

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

  • Node 20 ขึ้นไป บนเครื่องที่เอเจนต์ทำงานอยู่ ตรวจด้วย node --version
  • เอเจนต์ที่รองรับ MCP Claude Code, Cursor, Codex และ Windsurf ใช้ได้ทั้งหมด อะไรก็ตามที่พูด Model Context Protocol ได้ก็ใช้ได้
  • SDK Platform-Tools ของ Android Studio และอีมูเลเตอร์ ที่รัน Android 13 ขึ้นไป (API 33+) ต่ำกว่านั้นจะไม่มีการตั้งภาษาต่อแอป และเครื่องจะต้องรีสตาร์ททุกภาษา ตั้ง ANDROID_HOME ถ้าเครื่องมือไม่ได้อยู่ใน PATH
  • บัญชี Mokbi พร้อมโปรเจกต์ที่คุณต้องการเติม ทุกอย่างจะถูกวางไว้ในโปรเจกต์ ดังนั้นสร้างโปรเจกต์ก่อนถ้ายังไม่มี
  • การเก็บภาพบน iOS ยังไม่รวมอยู่ ส่วนนั้นต้องใช้ macOS และจะมาแยกต่างหาก วันนี้ฝั่งเก็บภาพคือ Android

1. ตรวจเครื่องของคุณ

รัน npx -y @mokbi/mcp doctor คำสั่งนี้จะแสดงเวอร์ชัน Node ตำแหน่งที่มันหา adb และอีมูเลเตอร์ และสถานะว่าคุณล็อกอินแล้วหรือยัง อะไรที่ขึ้น ✗ ให้แก้ก่อน เพราะเครื่องมือเก็บภาพเลี่ยง SDK ที่หายไปไม่ได้

2. เพิ่มเซิร์ฟเวอร์เข้าไปในเอเจนต์

ใน Claude Code ใช้คำสั่งเดียวก็พอ:

claude mcp add mokbi -- npx -y @mokbi/mcp

ใน Cursor, Codex, Windsurf และโฮสต์อื่น ให้เพิ่มเซิร์ฟเวอร์ในคอนฟิก MCP ด้วยคำสั่ง npx และอาร์กิวเมนต์ ["-y","@mokbi/mcp"] จากนั้นรีสตาร์ทโฮสต์เพื่อให้มันเห็นเซิร์ฟเวอร์

3. ล็อกอินหนึ่งครั้ง

รัน npx -y @mokbi/mcp login เบราว์เซอร์จะเปิด Mokbi คุณอนุมัติคำขอ แล้วโทเคนจะกลับมาที่ 127.0.0.1 — มันไม่เคยเดินทางอยู่ใน URL หน้าจออนุมัติจะบอกหมายเลขพอร์ต ให้เทียบกับที่เทอร์มินัลพิมพ์ไว้ก่อนกดอนุมัติ

เครื่องนั้นไม่มีเบราว์เซอร์ใช่ไหม รัน npx -y @mokbi/mcp login --paste แล้วสร้างโทเคนเองใน Mokbi → เมนู → เอเจนต์ (MCP) → "การเข้าถึงของเอเจนต์" → "โทเคนใหม่" โทเคนจะแสดงครั้งเดียว ให้คัดลอกทันที

โทเคนถูกเก็บไว้ที่ ~/.mokbi/config.json ด้วยสิทธิ์ไฟล์ 0600 มันไม่ใช่เซสชันของคุณ การเพิกถอนจึงไม่กระทบบัญชี สำหรับ CI ตัวแปรสภาพแวดล้อม MOKBI_TOKEN มาก่อนไฟล์

4. รอบแรกของคุณ

ขอให้เอเจนต์เริ่มโฟลว์เก็บภาพหน้าจอ เซิร์ฟเวอร์มาพร้อมสแลชคอมมานด์สามตัว และใน Claude Code ก็จะเห็นแบบนี้เลย:

  • /mokbi:screenshots — อ่านรีโป เสนอว่าจะเก็บหน้าจอไหน รันหนึ่งภาษาให้คุณตรวจ แล้วเมื่อคุณอนุมัติจึงรันทุกภาษาและวางชุดภาพไว้ให้
  • /mokbi:localize — ร่างข้อความสำหรับสโตร์ภายในลิมิตตัวอักษรของแต่ละสโตร์
  • /mokbi:check — รายงานว่ามีอะไรพร้อมแล้ว และยังขาดอะไรในแต่ละภาษาแต่ละสโตร์

จะพิมพ์อธิบายสิ่งที่ต้องการเฉย ๆ ก็ได้ เพราะเซิร์ฟเวอร์บอกเอเจนต์เองว่าลำดับงานควรเป็นอย่างไร ให้รอบแรกทำแค่ภาษาเดียว การแตะผิดจะได้เสียแค่หนึ่งรอบ ไม่ใช่ยี่สิบรอบ

5. ใช้งานสิ่งที่เอเจนต์เตรียมไว้

เปิดโปรเจกต์ในเอดิเตอร์ รายการที่ส่งมารออยู่ใต้ "จากเอเจนต์ของคุณ" — ปุ่มรูปหุ่นยนต์บนแถบเครื่องมือ ซึ่งเป็นพาเนลเดียวกับเมนู → เอเจนต์ (MCP) → "การเข้าถึงของเอเจนต์" และปุ่ม "จากเอเจนต์ของคุณ" ในเมนูภาพหน้าจอ ตัวเลขบนปุ่มนั้นนับสิ่งที่กำลังรออยู่

  • "ใช้งาน" วางภาพตามแผนที่แสดงเหนือปุ่ม: ภาพไหนลงพาเนลไหน สำหรับภาษาใด กด Ctrl+Z ครั้งเดียวก็ดึงทั้งชุดออก
  • "ใช้งานและออกแบบ" จะปรากฏเมื่อเอเจนต์ส่งบรีฟสั้น ๆ เกี่ยวกับแอปมาด้วย ปุ่มนี้รันรอบ AI Designer เดียวกับปุ่มสีส้มในเอดิเตอร์ ในราคาเท่ากันคือ 2 เครดิต โดยใช้ภาพที่เตรียมไว้
  • "รับทั้งหมด" จะโผล่มาเมื่อมีข้อความสโตร์หรือคำบรรยายที่แปลแล้วรออยู่เป็นชุดใหญ่ ปุ่มนี้ใช้งานทั้งหมดในขั้นตอนเดียว และการเลิกทำครั้งเดียวก็เอาออกทั้งหมด
  • "ทิ้ง" ลบรายการที่คุณไม่ต้องการ เอเจนต์ส่งใหม่ได้เสมอ

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

เมื่อมีอะไรผิดพลาด

  • "adb not found" ยังไม่ได้ติดตั้ง SDK Platform-Tools หรือมันไม่ได้อยู่ใน PATH ติดตั้งผ่าน SDK Manager ของ Android Studio หรือตั้ง ANDROID_HOME ไปที่โฟลเดอร์ SDK
  • อีมูเลเตอร์ขึ้น 'offline' ทันทีหลังเปิด อีมูเลเตอร์ที่เพิ่งเปิดยังบูตต่ออีกพักหลังจากบอกว่าพร้อมแล้ว เซิร์ฟเวอร์จะรอสัญญาณบูตสามอย่างและลองใหม่ ให้เวลามันสักนาทีก่อนจะยกเลิก
  • "ภาษาไม่เปลี่ยน" หลังตั้งค่าแล้วเราอ่านกลับสิ่งที่เครื่องรายงาน ถ้าไม่ตรงกัน เป็นไปได้มากว่าแอปของคุณไม่มีภาษานั้น หรือแอปเปิดอยู่ในอีกภาษาแล้ว ให้รันรอบนั้นใหม่สำหรับภาษานี้
  • สองภาษาดูเหมือนกันเป๊ะ นั่นคือการตรวจที่ทำงานถูกต้อง หน้าจอเหมือนกันแปลว่าแอปยังไม่ได้แปลเป็นภาษานั้น ปล่อยภาษานั้นเมื่อแอปพร้อมจริง ๆ
  • ล็อกอินผ่านเบราว์เซอร์ไม่สำเร็จ ใช้ npx -y @mokbi/mcp login --paste แล้ววางโทเคนที่คุณสร้างในเอดิเตอร์
  • ในเอดิเตอร์ไม่มีอะไรรออยู่ ตรวจว่าคุณเปิดโปรเจกต์เดียวกับที่เอเจนต์ส่งไป และโทเคนยังใช้ได้: npx -y @mokbi/mcp doctor
  • รอบทำงานค้างอยู่ที่หน้าจอที่แอปไปไม่ถึง ไดรเวอร์เก็บภาพจะรายงานว่ากำลังมองหน้าจอไหน พร้อมภาพประกอบ ส่งข้อมูลนั้นกลับให้เอเจนต์แล้วปรับโฟลว์ เซิร์ฟเวอร์ไม่ได้เทสต์แอปแทนคุณ

โทเคนทำอะไรได้และทำอะไรไม่ได้

  • มันเตรียมไว้ ไม่ได้เผยแพร่ การเผยแพร่ขึ้น App Store และ Google Play ยังอยู่ใน Mokbi ตามการคลิกของคุณ
  • มันใช้เงินไม่ได้ รอบออกแบบถูกจ่ายจากเซสชันเอดิเตอร์ของคุณเองตอนที่คุณกดปุ่ม ไม่ใช่โดยเอเจนต์
  • มันไม่ใช่เซสชันของคุณ เพิกถอนได้ที่เมนู → เอเจนต์ (MCP) → "การเข้าถึงของเอเจนต์" แล้วบัญชีของคุณยังอยู่เหมือนเดิม ทุกโทเคนแสดงว่าใช้ครั้งล่าสุดเมื่อไร
  • โค้ดของคุณอยู่กับคุณ ครึ่งที่เก็บภาพทำงานบนเครื่องคุณทั้งหมด มีเพียงภาพและข้อความที่เสร็จแล้วเท่านั้นที่ถูกส่งไปยังโปรเจกต์

เปิดเอดิเตอร์ → เซิร์ฟเวอร์ MCP ทำอะไร