获取免费设计
帮助 · 代理（MCP）

配置 Mokbi 的 MCP 服务器。

一句话。 把服务器加进你的代理，在终端里登录一次，然后请代理执行 /mokbi:screenshots。代理会在你自己的机器上按每种语言截取应用，并把这套图放进你的 Mokbi 项目。你在编辑器里一次点击就能应用。

你需要什么

  • Node 20 或更高版本，装在代理运行的那台机器上。用 node --version 查看。
  • 一个支持 MCP 的代理。Claude Code、Cursor、Codex 和 Windsurf 都可以；任何会说 Model Context Protocol 的都行。
  • Android Studio 的 SDK Platform-Tools 和一个模拟器，运行 Android 13 或更高版本（API 33+）。再低就没有“按应用设置语言”，设备得为每种语言重启一次。如果工具不在 PATH 里，请设置 ANDROID_HOME。
  • 一个 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 里。用 Android Studio 的 SDK Manager 安装，或把 ANDROID_HOME 指向你的 SDK 目录。
  • 模拟器刚启动就显示 'offline'。刚开的模拟器在报告“就绪”之后还会继续启动一段时间。服务器会等三个启动信号并重试；先给它一分钟再动手中止。
  • “语言没有切换”。设置之后我们会回读设备报告的结果。对不上，多半是你的应用没有带上那种语言，或者应用已经以另一种语言在运行。请为那种语言重跑一轮。
  • 两种语言看起来一模一样。这是检查在起作用：界面相同，说明你的应用没有翻译成那种语言。等应用真的翻好了，再发布这种语言。
  • 浏览器登录走不通。改用 npx -y @mokbi/mcp login --paste，粘贴你在编辑器里创建的令牌。
  • 编辑器里什么都没有。确认你打开的是代理推送的那个项目，并且令牌仍然有效：npx -y @mokbi/mcp doctor。
  • 某一轮卡在你的应用永远到不了的界面上。截图驱动会报告它当时看到的界面，还带一张图。把这些交回给代理并调整流程；服务器不会替你测试应用。

令牌能做什么、不能做什么

  • 它只准备，不发布。发布到 App Store 和 Google Play 仍然在 Mokbi 里，由你点击。
  • 它不能花钱。一轮设计的费用，是在你按下按钮时从你自己的编辑器会话里扣的，绝不会由代理支付。
  • 它不是你的会话。在菜单 → 代理（MCP） → “代理访问”里撤销它，你的账号毫发无损。每个令牌都会显示最近一次使用时间。
  • 代码始终在你这里。负责截图的那一半完全在你的机器上运行；只有成品图片和文案会发送到你的项目。

打开编辑器 → MCP 服务器都做些什么