Cài đặt máy chủ MCP của Mokbi.

Bạn cần gì

• Node 20 trở lên trên máy chạy agent. Kiểm tra bằng node --version.
• Một agent nói được MCP. Claude Code, Cursor, Codex và Windsurf đều được; bất cứ thứ gì nói Model Context Protocol đều dùng được.
• SDK Platform-Tools của Android Studio và một trình giả lập chạy Android 13 trở lên (API 33+). Thấp hơn thì không có ngôn ngữ riêng cho từng ứng dụng và thiết bị sẽ phải khởi động lại cho mỗi ngôn ngữ. Đặt ANDROID_HOME nếu các công cụ không nằm trong PATH.
• Một tài khoản Mokbi với dự án bạn muốn lấp đầy. Mọi thứ được để sẵn vào một dự án, nên hãy tạo dự án trước nếu chưa có.
• Chụp trên iOS chưa có trong này. Phần đó cần macOS và sẽ đến riêng; hôm nay phía chụp là Android.

1. Kiểm tra máy của bạn

Chạy npx -y @mokbi/mcp doctor. Nó in ra phiên bản Node, nơi nó tìm adb và trình giả lập, và bạn đã đăng nhập hay chưa. Cái nào có dấu ✗ thì xử lý trước — công cụ chụp không thể lách qua một SDK còn thiếu.

2. Thêm máy chủ vào agent

Trong Claude Code, một lệnh là đủ:

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

Trong Cursor, Codex, Windsurf và các host khác, hãy thêm vào cấu hình MCP một máy chủ với lệnh npx và tham số ["-y","@mokbi/mcp"]. Sau đó khởi động lại host để nó nhận ra máy chủ.

3. Đăng nhập một lần

Chạy npx -y @mokbi/mcp login. Trình duyệt mở Mokbi, bạn duyệt yêu cầu, và token quay về 127.0.0.1 — nó không bao giờ đi trong URL. Màn hình duyệt có nêu số cổng; hãy đối chiếu với số mà terminal in ra trước khi bấm duyệt.

Máy đó không có trình duyệt? Chạy npx -y @mokbi/mcp login --paste và tự tạo token trong Mokbi → menu → Agent (MCP) → "Quyền truy cập của agent" → "Token mới". Token chỉ hiện một lần, nên hãy sao chép ngay.

Token được lưu ở ~/.mokbi/config.json với quyền 0600. Nó không phải phiên đăng nhập của bạn: thu hồi token không đụng tới tài khoản. Với CI, biến môi trường MOKBI_TOKEN được ưu tiên hơn tệp.

4. Lượt chạy đầu tiên

Hãy yêu cầu agent chạy luồng ảnh chụp. Máy chủ kèm theo ba lệnh gạch chéo, và trong Claude Code chúng hiện đúng như vậy:

• /mokbi:screenshots — đọc repo, đề xuất những màn hình cần chụp, chạy một ngôn ngữ để bạn kiểm tra, rồi sau khi bạn đồng ý thì chạy hết các ngôn ngữ và để sẵn bộ ảnh.
• /mokbi:localize — soạn văn bản store trong giới hạn ký tự của từng store.
• /mokbi:check — báo cáo những gì đã sẵn sàng và những gì còn thiếu theo từng ngôn ngữ, từng store.

Bạn cũng có thể chỉ cần mô tả điều mình muốn; máy chủ sẽ tự nói cho agent biết luồng nên diễn ra thế nào. Hãy để lượt đầu tiên chỉ chạy một ngôn ngữ. Khi đó một cú chạm sai chỉ tốn một lượt thay vì hai mươi.

5. Áp dụng thứ agent đã để sẵn

Mở dự án trong trình chỉnh sửa. Lô gửi đang chờ ở "Từ agent của bạn" — nút robot trên thanh công cụ, cũng chính là bảng ở menu → Agent (MCP) → "Quyền truy cập của agent", và nút "Từ agent của bạn" trong menu Ảnh chụp màn hình. Chấm đếm trên nút đó cho biết có bao nhiêu thứ đang chờ.

• "Áp dụng" đặt các ảnh theo kế hoạch hiển thị phía trên nút: ảnh nào vào khung nào, cho ngôn ngữ nào. Một lần Ctrl+Z gỡ cả bộ ra.
• "Áp dụng & thiết kế" xuất hiện khi agent gửi kèm bản brief ngắn về ứng dụng. Nó chạy đúng vòng AI Designer như nút cam trong trình chỉnh sửa, cùng mức giá 2 tín dụng, dựa trên các ảnh đã để sẵn.
• "Nhận tất cả" hiện ra khi có văn bản store hoặc bản dịch chú thích chờ theo lô. Nó áp dụng tất cả trong một bước, và một lần hoàn tác gỡ hết.
• "Bỏ" xoá lô gửi bạn không muốn. Agent luôn có thể gửi lại.

Không có gì được áp dụng tự động, và đó là chủ ý. Trình chỉnh sửa là nơi duy nhất ghi dự án của bạn: một tab đang mở sẽ lưu lại toàn bộ tài liệu. Nếu lô gửi rơi thẳng vào thiết kế, một tab trình chỉnh sửa đang mở ở nơi khác có thể lặng lẽ ghi đè lên nó.

Khi có gì đó trục trặc

• "adb not found". SDK Platform-Tools chưa được cài hoặc không nằm trong PATH. Cài qua SDK Manager của Android Studio, hoặc đặt ANDROID_HOME trỏ tới thư mục SDK.
• Trình giả lập báo 'offline' ngay sau khi khởi động. Một trình giả lập mới vẫn tiếp tục khởi động sau khi báo là đã sẵn sàng. Máy chủ chờ ba tín hiệu boot rồi thử lại; hãy cho nó một phút trước khi bạn ngắt.
• "Ngôn ngữ không đổi". Sau khi đặt, chúng tôi đọc lại thứ thiết bị báo cáo. Nếu lệch, nhiều khả năng ứng dụng của bạn không kèm ngôn ngữ đó, hoặc ứng dụng vốn đang chạy ở ngôn ngữ khác. Hãy chạy lại lượt đó cho ngôn ngữ này.
• Hai ngôn ngữ trông giống hệt nhau. Đó là kiểm tra đang làm đúng việc của nó: màn hình giống nhau, nghĩa là ứng dụng chưa được dịch sang ngôn ngữ đó. Hãy phát hành ngôn ngữ khi ứng dụng đã sẵn sàng.
• Đăng nhập bằng trình duyệt không xong. Dùng npx -y @mokbi/mcp login --paste và dán token bạn tạo trong trình chỉnh sửa.
• Không có gì chờ trong trình chỉnh sửa. Kiểm tra xem bạn có đang mở đúng dự án mà agent đã gửi tới không, và token còn hiệu lực không: npx -y @mokbi/mcp doctor.
• Lượt chạy kẹt ở màn hình mà ứng dụng không bao giờ tới. Trình điều khiển chụp sẽ báo nó đang nhìn màn hình nào, kèm ảnh. Đưa lại cho agent và chỉnh luồng; máy chủ không kiểm thử ứng dụng thay bạn.

Token làm được gì và không làm được gì

• Nó để sẵn chứ không đăng. Việc đăng lên App Store và Google Play vẫn nằm trong Mokbi, theo cú nhấp của bạn.
• Nó không tiêu tiền được. Một vòng thiết kế được trả từ chính phiên trình chỉnh sửa của bạn khi bạn bấm nút, không bao giờ do agent.
• Nó không phải phiên của bạn. Thu hồi ở menu → Agent (MCP) → "Quyền truy cập của agent" và tài khoản của bạn vẫn nguyên vẹn. Mỗi token đều hiện lần dùng gần nhất.
• Mã của bạn ở lại với bạn. Nửa lo việc chụp chạy hoàn toàn trên máy bạn; chỉ ảnh và văn bản đã hoàn thiện mới được gửi tới dự án.

Mở trình chỉnh sửa → Máy chủ MCP làm gì