MX Stage

MX Stage

English | 日本語

MX Stage 是一款仅在本地运行的 AI 工作台，可使用你自己的 AI 助手（Claude Desktop、ChatGPT、Antigravity、IBM Bob）修正 IBM Maximo 数据：每项更改都会先暂存、生成差异并由人工批准，然后才会写入 Maximo。

网站：https://mxstage.tsunagi.app · 联系方式：[email protected]

• 你的 AI 操作的是暂存表，而不是 Maximo。 AI 助手会将 Maximo 数据加载到工作界面（浏览器标签页）中的表格，进行分析，并说明原因、提出修改建议。你可以查看每个被修改的单元格。表格只存在于工作界面标签页和桥接程序的内存中；加载的表永远不会写入磁盘。
• 只有人可以提交。 AI 的工具无法写入 Maximo。只有当你在工作界面中按下 提交到 Maximo 时，修改才会写入。MX Stage 会先写入一条记录，让你检查后再发送其余记录。如果其他人在你加载记录后修改了记录，这些记录会被跳过并列出；遇到错误或无法确认结果时，操作会停止。提交之前可以撤销任何一批修改。你可以在提交面板中选择一次提交多少条记录（全部，或指定数量；默认值为 200）。
• 留存已批准内容的记录。 提交面板会保存差异报告（Excel）：每个被修改的单元格占一行，包含旧值、新值、修改者（AI 助手或人员）以及修改原因。提交后，面板还会保留该次提交的写入日志。
• 除了调用你的 Maximo 和 AI 助手之外，不会有任何数据离开你的电脑。 MX Stage 没有云服务，也不收集遥测数据。只有两种可选例外：如果你启用 设置 → 更新 → 自动更新（默认关闭），桥接程序每天会向 GitHub 查询一次最新版本号；如果你选择 设置 → 演示 → 下载数据并连接，程序会从 mxstage-demo.pages.dev 下载一次虚构的示例数据（不会发送任何内容）。使用安装脚本安装的程序会在没有打开工作区时自行更新（从 GitHub 获取新版本，从 npm registry 获取所需程序包）；Claude Desktop 扩展会从 GitHub 下载新文件，并检查文件后供你安装。一个小型本地进程（桥接程序）负责提供工作界面、通过 MCP 与 AI 助手通信，并将请求转发给 Maximo，因此 Maximo 无需设置 CORS。你的 Maximo API 密钥由桥接程序保存在这台电脑上，并使用 Windows 数据保护（DPAPI）加密，不会发送到浏览器（macOS 上尚未测试，由 Keychain 保护；Linux 上保存在只有你的用户能读取的文件中）。工作界面的每个窗口——已安装的应用、浏览器标签页，或 AI 助手内置的浏览器——都会自动连接，即使重启后也不例外；你还可以在设置中切换已保存的 Maximo 环境。（你也可以选择不保存连接信息；此时密钥只保留在标签页的内存中。）
• 教它遵循你的流程。 将对话中整理出的流程保存为 Skill；AI 下次会遵循该流程。
• 保留客户的用语习惯。 客户词典会记录客户如何书写名称、哪些词表示故障代码，以及制造商或部门名称等值的书写方式。AI 会添加词条，工作界面则会将它们作为规则应用（匹配、从文本中提取代码、替换值），这样下个月的文件就无需阅读那么多内容。你可以在工作界面中检查并保存词典。每个连接都有自己的词典和 Skill 文件夹（默认路径为 Documents\MX Stage<connection>）；在设置 → Skills 和词典中选择共享文件夹（OneDrive、SharePoint、网络文件夹等），保存的词条便会通过你自己的文件同步服务提供给每位成员。MX Stage 本身不会将它们发送到任何地方。

为什么不让 AI 直接调用 Maximo REST API？

有几个 Maximo MCP 服务允许 AI 调用 REST API。读取数据时这样做没有问题，但批量修改时风险很大：你无法查看 AI 即将写入的内容，错误的猜测会直接写入生产环境。MX Stage 在两者之间加入暂存表、差异、撤销功能和人工审批。

支持的 AI 助手

助手	状态
Claude Desktop（聊天和 Code 选项卡）	支持
ChatGPT 桌面版 — Codex 或 Work 模式（聊天模式无法使用本地 MCP 服务）	支持
Antigravity（2.0，IDE）	支持（由安装程序注册）
IBM Bob	支持（由安装程序注册）
Claude Code、Codex CLI 和 IDE 扩展	可用，但不受官方支持

要求

• Windows（macOS 和 Linux 未经测试）
• 安装程序：Node.js 22.6 或更高版本以及 Git（安装程序会提供安装选项）。Claude Desktop 扩展两者都不需要；npm 包（npx @mxstage/mxstage）需要 Node.js 20 或更高版本。
• Chrome 或 Edge
• IBM Maximo 或 Maximo Application Suite (Manage)，提供 /maximo/api 下的 JSON API 和 API 密钥

安装

Claude Desktop（最简单）

1. 从最新版本下载 mxstage-<version>.mcpb。
2. 在 Claude Desktop 中，打开设置 → 扩展，然后选择高级设置 → 安装扩展…，并选择该文件（也可以双击文件，或将其拖到“扩展”页面）。选择安装。
3. 在 Chrome 或 Edge 中打开 http://127.0.0.1:8788/app，并**在设置中输入 Maximo URL 和 API 密钥。**切勿将 API 密钥粘贴到聊天中。
4. 在新聊天中询问“显示 MX Stage 状态”。

该扩展不需要 Node.js 或 Git：Claude Desktop 会运行它。若要同时在其他助手（ChatGPT 桌面版、IBM Bob、终端中的 Claude Code、Antigravity）中使用 MX Stage，请使用下方的安装程序；它会检测到该扩展，不会重复注册 MX Stage。

不使用 Maximo 体验

手头没有 Maximo？MX Stage 内置了一个演示环境：虚构的 Maximo，包含三家垃圾焚烧厂（资产、位置、约 52,000 张工单、库存，以及迁移遗留的数据质量问题），支持日语或英语，并在你电脑上的桥接程序内运行。

1. 安装 MX Stage（见上文），然后打开 http://127.0.0.1:8788/settings#demo。
2. 选择下载数据并连接。MX Stage 会从 mxstage-demo.pages.dev 下载约 10 MB 的虚构数据（不含程序），仅下载一次，并使用内置于此版本中的 SHA-256 值进行校验。
3. 向 AI 助手提问，例如：“检查 North Clean Center 运行中资产的数据质量，并列出问题及其数量。”

提交的修改只会更改你电脑上的副本（选择重置为初始状态即可还原），且无需许可证。演示环境在使用时约占用 0.5 GB 内存。同一选项卡中还提供五个可与 Maximo 合并的 Excel 示例文件（缺少工单号的采购订单、旧版设备登记册、打印为 A4 表格的每日报告（英语数据中为维修日志表）、早于 Maximo 的设备登记册、星形图表）。详见 docs/demo.en.md。

Claude 插件（Skills）

plugin/ 中的 mxstage 插件为 Claude 添加了两个 Skills（规划安全批量更正 Maximo 数据；解释、安装和排查 MX Stage 问题），并会在 Claude Code 和 Cowork 中通过 npx @mxstage/mxstage 启动 MX Stage 服务（需要 Node.js 20 或更高版本）。聊天不会启动本地服务，因此请在聊天中使用扩展。在 Claude Code 中：/plugin marketplace add mxstage/mxstage，然后运行 /plugin install mxstage@mxstage。

其他助手（安装程序）

**让 Claude Code（或 Claude Desktop 的 Code 标签页）为你安装：**将此仓库的 URL 提供给它，并说“安装这个”。它会按照下文的 Claude Code 安装步骤操作，并在运行每条命令前征求你的同意。

若要手动安装，请将此仓库克隆到 %USERPROFILE%\mxstage，然后在其中运行 node scripts/setup-local.mjs。

**一次安装即可将 MX Stage 注册到这台 PC 上找到的所有受支持助手中。然后重启你使用的助手，在桌面上打开 mxstage（或访问 http://127.0.0.1:8788/app），并在 Settings 中输入你的 Maximo URL 和 API 密钥。**切勿将 API 密钥粘贴到聊天中。

在 Settings 中，还要为每个 Maximo 选择它是生产环境还是测试环境。提交到生产环境需要许可证（参见 许可证）；其他操作均免费。

使用 npm 启动服务的 MCP 客户端也可以单独运行服务：npx -y @mxstage/mxstage（需要 Node.js 20 或更高版本；Skills 和快捷方式仅随安装程序提供）。

若要更新，请说“更新 MX Stage”；若要移除，请说“卸载 MX Stage”（参见卸载）。

注册位置

~ 表示 %USERPROFILE%。安装程序只会处理已安装的助手（Claude Desktop：其设置文件夹存在；Antigravity：~\.gemini；Codex：~\.codex；IBM Bob：~\.bob），更改文件前会备份每个文件（到 ~\.config\mxstage\backup\），并且绝不会更改其他服务的设置。运行 node scripts/setup-local.mjs --status 可查看注册情况，不会进行任何更改。若要排除某个助手，请添加 --no-claude-desktop、--no-antigravity、--no-codex 或 --no-bob（--no-skills 不会复制任何 Skills）。--claude-code 即使在启用了扩展的情况下，也会注册 Claude Code。

助手	MCP 服务	Skills	安装或更新后
Claude Code（CLI）	~\.claude.json 中的 mcpServers.mxstage。在 Claude Desktop 中启用 MX Stage 扩展（.mcpb）时不会注册，因为 Code 标签页已通过扩展获得 MX Stage，否则会显示两次每个工具（安装程序先前添加的条目会被移除）。添加 --claude-code 可仍为终端中的 Claude Code 注册（后续运行会记住此设置）	~\.claude\skills\<name>\SKILL.md	重启 Claude Code
Claude Desktop（Code 标签页）	与 Claude Code 相同，或在启用扩展（.mcpb）时使用该扩展	与 Claude Code 相同	从系统托盘退出 Claude Desktop，然后重新打开
Claude Desktop（聊天）	%APPDATA%\Claude\claude_desktop_config.json 中的 mcpServers.mxstage。Microsoft Store 版本：如果该文件夹存在，也会在 %LOCALAPPDATA%\Packages\Claude_<publisher ID>\LocalCache\Roaming\Claude\claude_desktop_config.json 中注册。在 Claude Desktop 中安装并启用 MX Stage 扩展（.mcpb）时不会注册（安装程序先前添加的条目会被移除）	不复制（参见 Skills）	从系统托盘退出（仅关闭窗口不够），然后重新打开
Antigravity	~\.gemini\config\mcp_config.json 中的 mcpServers.mxstage	~\.gemini\config\skills\<name>\SKILL.md	开始新对话
Codex（ChatGPT 桌面端、CLI、IDE 扩展）	~\.codex\config.toml 中的 [mcp_servers.mxstage]	~\.agents\skills\<name>\SKILL.md	重启 Codex
IBM Bob	~\.bob\settings\mcp.json 中的 mcpServers.mxstage	~\.bob\skills\<name>\SKILL.md	重启 IBM Bob

安装程序会复制 17 个内置 Skills（索引 mxstage-workbench、基本操作 mxstage-core-* 和标准对象 mxstage-obj-*），以及你自己的 Skills（位于 ~\.config\mxstage\skills\）。不会获得 Skill 文件的助手（Claude Desktop 聊天、agy CLI）仍会在工具结果中收到索引和 Skills 列表（参见 Skills）。

在各个助手中检查

界面名称取自各产品的文档（英文界面，2026 年 9 月）。

助手	MCP（mxstage 及其工具）	Skills（mxstage-workbench 等）
Claude Code (CLI)	在对话中输入 /mcp（查看列表和连接状态）。在 shell 中运行：claude mcp list、claude mcp get mxstage	在对话中输入 /skills。输入 / 会显示 /mxstage-workbench
Claude Desktop（Code 标签页）	输入框中的 + → Connectors	在输入框中输入 /，或点击 + → Slash commands
Claude Desktop（聊天）	输入框中的 + → Connectors → Manage connectors 可查看工具。连接状态和日志：Settings → Developer（日志：%APPDATA%\Claude\logs\mcp-server-mxstage.log）	不显示（不会复制文件）。询问“show the MX Stage Skills”，工具会返回列表
Antigravity 2.0	左下角的 Settings（Ctrl+,）→ Customizations → Installed MCP Servers（刷新以重新加载）	同一个 Customizations。在对话中使用 /<name> 调用
Antigravity IDE	Agent 面板顶部的 … → MCP Servers → Manage MCP Servers（View raw config 会打开文件）	Agent 面板中的 Customizations
agy CLI	在对话中输入 /mcp	不显示（不会复制文件）
Codex（ChatGPT 桌面应用）	Settings → MCP servers。在输入框中输入 /mcp	左侧的 Skills。在输入框中输入 @ 以选择一个
Codex CLI	codex mcp list。在对话中输入 /mcp	在对话中输入 /skills，或输入 $mxstage-workbench
Codex IDE 扩展	齿轮菜单 → MCP servers	输入 /skills，或输入 $ 以选择一个

卸载

移除所有内容

对 Claude Code 说“uninstall MX Stage”，或在 %USERPROFILE%\mxstage 中运行：

node scripts/setup-local.mjs --uninstall

这会从每个助手中移除 mxstage 条目（并还原安装程序替换的任何设置）、移除复制的 Skills（除非你编辑过它们）、移除登录快捷方式和桌面快捷方式，并停止启动的桥接程序。它会保留你自己的 Skills（~\.config\mxstage\skills\）和备份。若要移除所有内容，还要删除 %USERPROFILE%\mxstage 和 ~\.config\mxstage（备份是原始设置文件的完整副本，其中可能包含令牌），并在浏览器中清除 127.0.0.1:8788 的站点数据。

仅从部分助手中移除

安装程序没有单独移除某个助手的选项，因此只需从该助手的设置中删除 mxstage 条目。其他服务的设置会保留。

助手	移除 MCP 服务	移除 Skills
Claude Code (CLI)	claude mcp remove --scope user mxstage	在 ~\.claude\skills\ 中，删除 MX Stage 复制的文件夹（mxstage-workbench、mxstage-core-*、mxstage-obj-* 以及你自己的 Skills 名称）
Claude Desktop（聊天和 Code 标签页）	Settings → Developer → Edit Config 会打开 claude_desktop_config.json：删除 mcpServers 下的 "mxstage" 条目，然后重新打开 Claude Desktop。若要同时从 Code 标签页移除，还要从 Claude Code 中移除	聊天中没有。Code 标签页使用 Claude Code 的 Skills
Antigravity	在 ~\.gemini\config\mcp_config.json 的 mcpServers 下删除 "mxstage" 条目（在 IDE 中点击 View raw config 可打开该文件）	删除 ~\.gemini\config\skills\ 中相同的文件夹
Codex	在 ~\.codex\config.toml 中删除 [mcp_servers.mxstage] 表（直到下一行 [ 为止），然后重新打开 Codex	删除 ~\.agents\skills\ 中相同的文件夹
IBM Bob	在 ~\.bob\settings\mcp.json 的 mcpServers 下删除 "mxstage" 条目，然后重启 IBM Bob	删除 ~\.bob\skills\ 中相同的文件夹

再次运行安装程序会重新向该助手注册，除非添加 --no-claude-desktop、--no-antigravity、--no-codex 或 --no-bob（Claude Code 没有此类选项，但在 Claude Desktop 中启用 MX Stage 扩展期间不会注册；除非添加 --claude-code）。

Claude Code 安装步骤

当用户要求安装 MX Stage 时，请按以下步骤操作，并在执行每条命令前征得用户同意。

1. 检查前置条件：运行 node --version（22.6 或更高版本）和 git --version。如果缺少其中任何一项，请在征得用户同意后运行 winget install OpenJS.NodeJS.LTS / winget install Git.Git 进行安装，然后在新 shell 中确认 node 和 git 可正常运行。
2. 获取代码，存放在 %USERPROFILE%\mxstage 中（macOS 和 Linux 上为 ~/mxstage）：
   • 如果目录不存在：运行 git clone <this repository URL> "%USERPROFILE%\mxstage"
   • 如果目录已存在：在该目录中运行 git pull --ff-only（如果本地更改导致操作无法继续，请停止并告知用户）
3. 安装：在该文件夹中运行 node scripts/setup-local.mjs --json。此操作还会运行 npm install 并构建工作界面。不要使用 mxstage.cmd（它会在结束时等待按键）。
4. 读取结果：如果 steps 中没有任何项的 "level": "error"，则表示成功。若出现 error 或 warn，请将其 message 和 hint 告知用户，并按照 hint 操作。不要凭猜测修改设置文件。
5. 告知用户：重启正在使用的助手，在工作界面设置（http://127.0.0.1:8788/app）中输入 Maximo URL 和 API 密钥，并且绝不要将 API 密钥粘贴到聊天中。

更新：执行步骤 2 到 4。之后请用户重启助手，以便使用新的桥接服务。卸载：运行 node scripts/setup-local.mjs --uninstall --json。状态：运行 node scripts/setup-local.mjs --status --json（不会进行任何更改）。

安装程序的操作

项目	详情
桥接服务	在端口 8788 上启动（固定端口，绝不会更改）。每台 PC 仅有一个；由 AI 助手启动的桥接服务会将请求转发给它
MCP 和 Skills	按照注册位置进行注册。若要排除某些项目：--no-claude-desktop、--no-antigravity、--no-codex、--no-bob、--no-skills
启动和快捷方式	创建一个在登录时启动桥接服务的快捷方式，并在桌面上创建 mxstage 快捷方式

重复运行也是安全的。详情请参阅 docs/local.md（日文）。

技能

技能是 AI 助手遵循的一套流程。

	位置	内容	更新
内置：索引	skills/mxstage-workbench	每项任务的规则，以及何时读取哪项技能	随 MX Stage 更新而替换；请勿编辑
内置：基本操作	skills/mxstage-core-*（8 项）	加载、分析、修改、匹配、导入、提交、工作界面、编写技能	同上
内置：标准 Maximo 对象	skills/mxstage-obj-*（8 项）	资产和仪表、位置、分类和规格、工单、PM 和作业计划、物料和库存、采购、参考数据：Maximo 如何处理这些对象、MX Stage 可以修改什么，以及需要注意的问题	同上
客户的	连接对应的文件夹及其字典（skills/<name>/versions/）	该客户的环境（自定义对象、属性、规则）和重复性任务	与使用同一文件夹的成员共享；每次保存都会创建新版本。仅当工作界面连接到该客户时，才会提供给 AI
你在这台 PC 上的	~/.config/mxstage/skills/<name>/SKILL.md	适用于任意连接的个人流程	更新后仍会保留，且绝不会发送到任何地方。以 mxstage 开头的名称为保留名称

• 每个助手都会获得索引：每次对话中的首次工具调用结果都会附带索引和全部技能列表，因此无法加载技能文件的助手（例如 Claude Desktop 聊天）也会遵循相同规则。工具结果会列出每个步骤所需的技能（例如加载资产规格时所需的资产和分类技能），AI 会使用 get_skill 读取它们。
• 处理对应客户时优先使用你的技能：这些技能可以替换内置技能中的步骤，但不能替换索引中的规则。客户技能会取代这台 PC 上同名的技能。
• 通过聊天创建技能：说“将此流程保存为技能”。AI 会显示名称、说明和正文；你同意后，它会保存草稿。工作界面会显示通知；只有在检查草稿并前往 Settings → Skills & dictionaries 按下 Save 后，才会使用该技能。此处的每项技能都有历史记录，并可恢复。
• 再次运行安装程序，将这台 PC 上新增或更改的技能复制到各个助手。客户技能不会复制到那里，因此为其他客户工作时不会读取这些技能。

文档

目前，详细指南均为日文，演示指南除外：

• docs/demo.en.md — 不连接 Maximo 试用 MX Stage（内置演示；英文）
• docs/local.md — 日常使用、更新、卸载、故障排除、文件写入位置
• docs/status.md — 当前可用功能
• docs/publish.md — 推送到 GitHub 前的检查（不含客户数据）
• docs/design.md — 工作界面的设计规则

开发

npm run typecheck      # tsc (app and bridge)
npx vitest run         # tests (app, bridge and the demo data generator)
npm run test:setup     # installer tests (write only to temporary folders)
npm run build          # build the built-in Skills and the work screen (dist/app)
npm run dev:app        # dev server for the work screen (http://localhost:5173/app?samples=1 shows sample data; relays to the dev bridge on 8790)
npm run dev:fake-maximo  # a fake Maximo at https://127.0.0.1:9797 (API key: test-api-key)
npm run dev:bridge     # a bridge on port 8790 that accepts the development license for the fake Maximo
node scripts/check-publish.mjs --worktree   # checks before pushing (docs/publish.md)

安装依赖时，请禁用 IBM 遥测（在 PowerShell 中运行 $env:IBM_TELEMETRY_DISABLED='true'; npm install）；安装程序会自行执行此操作。有关许可证检查的开发和测试，请参阅 dev/README.md。

仅可使用虚拟数据在开发用 Maximo 上测试提交。 写入 Maximo 的更改不会自动回滚。

许可证

MX Stage 根据 Business Source License 1.1 授权。源代码可用，但它不是开源软件。LICENSE 文件具有最终效力；以下内容仅为摘要。

• 免费：除向生产 Maximo 提交数据外，其他功能均可免费使用，包括加载、分析和编辑生产数据、构建 Skills，以及向测试环境提交数据。你可以在同一许可证下阅读、修改和重新分发源代码。
• 需要许可证：使用 MX Stage 在生产 Maximo 环境中创建、更改或删除数据——每个生产环境每年 4,800 美元，用户和电脑数量不限。许可证密钥会列出环境的 URL（最多三个别名）。许可证和购买。
• 生产环境：组织用于记录日常运营的 Maximo，以及正在准备取代它的环境（例如上线前的迁移目标）。测试环境：其他所有环境（开发、测试、培训、演示、迁移演练），即使其中包含生产数据的副本。
• **每个版本在发布四年后都会转为 Apache License 2.0。**此后，该版本也可以根据 Apache 2.0 向生产环境写入数据。
• 第三方软件包和字体（IBM Carbon Design System、IBM Plex 等）继续遵循各自的许可证（THIRD_PARTY_NOTICES.md）。

IBM 和 Maximo 是 International Business Machines Corporation 的商标。MX Stage 是独立产品，与 IBM 无关联，也未获 IBM 背书。