聚光灯-游乐工作室

TapTap制造创作者

TapTap Maker MCP 双账号并行配置指南

7 小时前16 浏览

Cindy不能用，其他客户端可以

适用环境：Windows + ZCode + TapTap Maker MCP。

目标：同一台电脑同时保留两个 TapTap 账号。分别打开两个项目时，MCP 自动使用对应账号；两个项目可以独立构建，不会因凭证串号而互相影响。

1. 当前项目映射

本文中的 A、B 只是账号标签，不会修改 TapTap 的实际账号名称。

标签	项目目录	凭证目录	说明
A	K:\anzt	C:\Users\<Windows 用户名>\.taptap-maker	默认凭证目录。当前项目是「xxxx」。
B	K:\ahgbt	C:\Users\<Windows 用户名>\.taptap-maker-acctB	独立凭证目录。当前项目是 B 账号绑定的项目。

项目归属以项目根目录的 .maker-mcp/config.json 为准。不要因为两个项目目录名称相似，就手动改这个绑定文件。

2. 工作原理

TapTap Maker 会从下列目录读取账号凭证：

text
C:\Users\<Windows 用户名>\.taptap-maker

其中的 tap-auth.json、pat.json 和可能存在的 jwt.json 是账号登录信息。Maker 支持环境变量 TAPTAP_MAKER_HOME，可以把整套凭证目录改到另一个位置。

因此，双账号的核心规则是：

A 使用默认目录 ~\.taptap-maker。
B 使用独立目录 ~\.taptap-maker-acctB。
A 项目的工作区 MCP 配置不设置 TAPTAP_MAKER_HOME。
B 项目的工作区 MCP 配置设置 TAPTAP_MAKER_HOME=...\.taptap-maker-acctB。
不在 Windows 的系统环境变量中永久设置 TAPTAP_MAKER_HOME。否则所有项目都会误连到同一个账号。

~ 在本文中表示 C:\Users\<Windows 用户名>。

3. 新电脑完整配置步骤

3.1 前置检查

安装 Node.js，并确认以下命令可以执行：
将 A、B 两个项目分别放到本机目录，例如：
保留每个项目原有的 .maker-mcp/config.json。已有项目不要在不确定时重复执行 taptap-maker init，避免改写项目绑定。

3.2 登录账号 A 到默认目录

在 PowerShell 中运行：

powershell
npx.cmd -y -p @taptap/maker taptap-maker login --json

浏览器会打开 Maker 的 token 页面。确认登录的是账号 A，然后点击「创建 token」。成功后，A 的凭证会保存到：

text
C:\Users\<Windows 用户名>\.taptap-maker

验证 A 凭证：

powershell
npx.cmd -y -p @taptap/maker taptap-maker apps --json

输出中应能看到 A 账号名下的项目，例如当前的「暗黑地狱」。

3.3 创建并登录账号 B 的独立目录

先复制 A 目录中的本地 Python、Lua LSP 等工具文件到 B 目录。只在 B 目录尚不存在时执行一次：

powershell
$source = "$env:USERPROFILE\.taptap-maker"
$target = "$env:USERPROFILE\.taptap-maker-acctB"

New-Item -ItemType Directory -Path $target
Copy-Item -Path "$source\*" -Destination $target -Recurse -Force

不要在 B 已登录后再次执行复制命令，否则可能用 A 的旧凭证覆盖 B 的凭证。

接着只对本次登录命令设置 B 的凭证目录：

powershell
$env:TAPTAP_MAKER_HOME = "$env:USERPROFILE\.taptap-maker-acctB"
npx.cmd -y -p @taptap/maker taptap-maker login --json
Remove-Item Env:TAPTAP_MAKER_HOME

浏览器会打开授权页。确认登录的是账号 B，然后点击「创建 token」。登录成功后，B 的 tap-auth.json 与 pat.json 会写入：

text
C:\Users\<Windows 用户名>\.taptap-maker-acctB

验证 B 凭证：

powershell
$env:TAPTAP_MAKER_HOME = "$env:USERPROFILE\.taptap-maker-acctB"
npx.cmd -y -p @taptap/maker taptap-maker apps --json
Remove-Item Env:TAPTAP_MAKER_HOME

输出中应能看到 B 账号名下的项目，并能与 K:\ahgbt\.maker-mcp\config.json 中的 project_id 对上。

4. ZCode MCP 配置

4.1 清理用户级 Maker 条目

ZCode 的用户级配置文件是：

text
C:\Users\<Windows 用户名>\.zcode\cli\config.json

用户级 MCP 会覆盖同名的工作区 MCP，还会在所有项目窗口自动启动。双账号模式下，用户级配置中不应保留任何 TapTap Maker MCP 条目，例如 maker 或 taptap-maker。

修改前先备份：

powershell
Copy-Item `
  "$env:USERPROFILE\.zcode\cli\config.json" `
  "$env:USERPROFILE\.zcode\cli\config.json.bak-multi-account"

然后只删除 mcp.servers 里的 Maker 条目；不要误删其它 MCP 服务配置。

4.2 A 项目：使用默认凭证

A 项目的工作区配置放在：

text
K:\anzt\.zcode\config.json

当前 A 项目已有 maker 条目，保持它不含 TAPTAP_MAKER_HOME 即可。它会自动读取默认目录中的 A 凭证。

如果新电脑上该配置不存在，可以使用以下 Maker 条目；不要覆盖已有的 maker-lua-lsp 等其它条目：

json
{
  "mcp": {
    "servers": {
      "maker": {
        "type": "stdio",
        "command": "C:\\Program Files\\nodejs\\node.exe",
        "args": [
          "C:\\Program Files\\nodejs\\node_modules\\npm\\bin\\npm-cli.js",
          "exec",
          "--yes",
          "--package",
          "@taptap/maker",
          "--",
          "taptap-maker"
        ],
        "env": {
          "TAPTAP_MCP_CLIENT_IDE": "zcode"
        },
        "timeoutMs": 60000
      }
    }
  }
}

如果 Node.js 不在 C:\Program Files\nodejs，用 where.exe node 找到本机的 node.exe 后，相应替换 command 与 npm-cli.js 的路径。

4.3 B 项目：固定使用 B 凭证

B 项目的工作区配置放在：

text
K:\ahgbt\.zcode\config.json

B 条目必须包含 TAPTAP_MAKER_HOME：

json
{
  "mcp": {
    "servers": {
      "taptap-maker": {
        "type": "stdio",
        "command": "C:\\Program Files\\nodejs\\node.exe",
        "args": [
          "C:\\Program Files\\nodejs\\node_modules\\npm\\bin\\npm-cli.js",
          "exec",
          "--yes",
          "--package",
          "@taptap/maker",
          "--",
          "taptap-maker"
        ],
        "env": {
          "TAPTAP_MCP_CLIENT_IDE": "zcode",
          "TAPTAP_MAKER_HOME": "C:\\Users\\<Windows 用户名>\\.taptap-maker-acctB"
        },
        "timeoutMs": 60000
      }
    }
  }
}

将 <Windows 用户名> 替换为真实 Windows 用户名。JSON 中的反斜杠必须写成 \\。

5. 日常使用与构建

重启 ZCode，确保旧 MCP 进程退出，新配置重新加载。
一个 ZCode 窗口打开 K:\anzt，它会连接 A。
另一个 ZCode 窗口打开 K:\ahgbt，它会连接 B。
在各自窗口中构建当前项目。构建的提交、推送和远端编译都只使用该窗口所属的账号与项目绑定。

本地凭证和项目路由已经隔离。远端构建队列、频率限制等仍以 TapTap 服务端对各账号的实际规则为准。

6. 验证清单

打开对应项目后，让 AI 调用 Maker 状态检查，或在 ZCode 的 Settings → MCP 查看连接状态。

项目	应看到的凭证路径	应看到的项目目录
A：K:\anzt	C:\Users\<用户>\.taptap-maker\tap-auth.json	K:\anzt
B：K:\ahgbt	C:\Users\<用户>\.taptap-maker-acctB\tap-auth.json	K:\ahgbt

当前电脑的已验证结果：

A 项目绑定的是 A 账号的「暗黑地狱」。
B 凭证能读取 K:\ahgbt 绑定的 B 项目。
K:\ahgbt 重启 ZCode 后已确认读取 ~\.taptap-maker-acctB。

7. 常见故障与恢复

现象	原因	处理方式
B 项目显示成 A 账号的应用列表	B 工作区缺少 TAPTAP_MAKER_HOME，或用户级 Maker 条目覆盖了工作区配置	检查 K:\ahgbt\.zcode\config.json 的 env；删除用户级 Maker 条目；重启 ZCode。
A 项目显示成 B 账号	A 工作区错误设置了 TAPTAP_MAKER_HOME，或 Windows 全局环境变量设置了它	删除 A 配置中的该变量；在系统环境变量中删除 TAPTAP_MAKER_HOME；重启 ZCode。
MCP 没有连接	修改配置后旧进程仍在运行，或 Node.js 路径不正确	重启 ZCode；在 Settings → MCP 看错误；用 where.exe node 核对 Node 路径。
B 提示未登录或 token 失效	B 的 PAT 已过期	不要重新复制目录。仅按 3.3 节用 TAPTAP_MAKER_HOME=...acctB 重新登录 B。
想回到原先单账号模式	需要临时恢复旧的用户级配置	用 config.json.bak-multi-account 恢复；恢复前先备份当前配置。