MX Stage

MX Stage

英語 | 日本語

MX Stage は、独自の AI アシスタント（Claude Desktop、ChatGPT、Antigravity、IBM Bob）を使って IBM Maximo のデータを修正するための、ローカル専用 AI ワークベンチです。変更はすべてステージングされ、差分が確認でき、人間が承認してから Maximo に書き込まれます。

ウェブサイト：https://mxstage.tsunagi.app · お問い合わせ：[email protected]

• AI は Maximo ではなく、ステージングシート上で作業します。 AI アシスタントは Maximo のデータを 作業画面（ブラウザーのタブ）内のシートに読み込み、分析して、理由を添えて変更を提案します。変更されたセルはすべて確認できます。シートは作業画面のタブとブリッジのメモリ内にのみ存在し、読み込んだテーブルがディスクに書き込まれることはありません。
• 変更を確定できるのは人だけです。 AI のツールから Maximo に書き込むことはできません。変更が書き込まれるのは、作業画面で Commit to Maximo を押したときだけです。MX Stage はまず 1 件を書き込み、残りを送信する前に確認できるようにします。読み込み後に他の人が変更したレコードはスキップされ、一覧に表示されます。エラーが発生した場合や、結果を確認できない場合は処理を停止します。変更のバッチは、確定前であればいつでも元に戻せます。1 回の確定で送信するレコード数は、確定パネルで指定できます（すべて、または任意の数。デフォルトは 200 件です）。
• 承認した内容の記録を残せます。 確定パネルには差分レポート（Excel）が保存されます。変更されたセルごとに、旧値、新値、変更者（AI アシスタントまたは人）と変更理由が 1 行に記録されます。確定後は、その確定処理の書き込みログも保存されます。
• Maximo と AI アシスタントへの通信を除き、PC からデータが外部に送信されることはありません。 MX Stage のクラウドはなく、テレメトリーもありません。例外として、次の 2 つの任意の通信があります。Settings → Updates → Update automatically をオンにした場合（デフォルトではオフ）、ブリッジが GitHub に 1 日 1 回、最新バージョン番号を問い合わせます。また、Settings → Demo → Download data and connect を選択した場合、架空のサンプルデータを mxstage-demo.pages.dev から 1 回ダウンロードします（データは送信されません）。セットアップスクリプトでインストールした場合、作業画面を開いていない間に自動で更新されます（新バージョンは GitHub から、パッケージは npm レジストリから取得します）。Claude Desktop 拡張機能は GitHub から新しいファイルをダウンロードし、インストール前に確認します。小さなローカルプロセス（ブリッジ）が作業画面を提供し、AI アシスタントと MCP で通信し、Maximo へのリクエストを中継するため、Maximo に CORS 設定は不要です。Maximo API キーはブリッジによってこの PC に保存され、Windows のデータ保護（DPAPI）で暗号化され、ブラウザーには送信されません（macOS では未テストですが Keychain が保護し、Linux では自分のユーザーだけが読み取り可能なファイルに保存されます）。作業画面の各ウィンドウ（インストール済みアプリ、ブラウザーのタブ、AI アシスタント内のブラウザー）は、再起動後も含めて自動的に接続されます。また、Settings で保存済みの Maximo 環境を切り替えられます。（保存せずに接続することもできます。その場合、キーはタブのメモリ内にのみ保持されます。）
• 手順を教えられます。 会話の中でまとめた手順を スキル として保存すると、AI は次回からその手順に従います。
• 顧客独自の表記を維持できます。 顧客辞書 には、顧客による名称の表記、障害コードを表す語、メーカー名や部門名などの値の表記方法を登録します。AI が項目を追加し、作業画面がルール（照合、テキストからのコード抽出、値の置換）として適用するため、翌月のファイルを読む手間が減ります。内容は作業画面で確認して保存します。接続ごとに、独自のフォルダー（デフォルトでは Documents\MX Stage<connection>）に辞書とスキルが保存されます。Settings → Skills & dictionaries で共有フォルダー（OneDrive、SharePoint、ネットワークフォルダーなど）を選ぶと、保存した項目は各自のファイル同期を通じてメンバー全員に共有されます。MX Stage 自体がこれらを外部に送信することはありません。

AI から Maximo REST API を直接呼び出さないのはなぜですか？

Maximo MCP サーバーの中には、AI から REST API を呼び出せるものがあります。読み取りには問題ありませんが、大量の変更にはリスクがあります。AI がこれから書き込もうとしている内容を確認できず、誤った推測がそのまま本番環境に反映されるためです。MX Stage はその間にステージングシート、差分、取り消し機能、人による承認を挟みます。

対応している AI アシスタント

アシスタント	状況
Claude Desktop（チャットおよび Code タブ）	対応
ChatGPT デスクトップ — Codex または Work モード（Chat モードではローカル 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
• /maximo/api に JSON API があり、API キーを使用できる IBM Maximo または Maximo Application Suite（Manage）

インストール

Claude Desktop（最も簡単）

1. 最新リリースから mxstage-<version>.mcpb をダウンロードします。
2. Claude Desktop で Settings → Extensions を開き、Advanced settings → Install Extension… を選択してファイルを指定します（または、ファイルをダブルクリックするか、Extensions ページにドラッグします）。Install を選択します。
3. Chrome または Edge で http://127.0.0.1:8788/app を開き、Settings で 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 にはデモが含まれています。PC 上でブリッジ内に、日本語または英語で動作する架空の Maximo（廃棄物焼却施設 3 か所の設備、ロケーション、約 52,000 件の作業指示書、在庫、移行後に残るデータ品質の問題）を利用できます。

1. 上記の手順で MX Stage をインストールし、http://127.0.0.1:8788/settings#demo を開きます。
2. Download data and connect を選択します。MX Stage は架空のデータ約 10 MB を mxstage-demo.pages.dev から一度ダウンロードし（プログラムは含まれません）、このバージョンに組み込まれた SHA-256 と照合します。
3. AI アシスタントに、たとえば「North Clean Center の稼働中の設備のデータ品質を確認して、問題を件数とともに一覧表示して」と尋ねます。

コミットによって変更されるのは PC 上のデータだけです（Reset to the initial state を選ぶと元に戻ります）。ライセンスは不要です。デモの使用中は約 0.5 GB のメモリを使用します。Maximo と統合するための Excel サンプルファイル 5 点（作業指示書番号のない購買発注書、旧式の設備台帳、A4 帳票として印刷された日報（英語データでは修理ログの表）、Maximo より先行している設備台帳、星取表）は、同じタブにあります。docs/demo.en.md を参照してください。

Claude プラグイン（Skills）

plugin/ の mxstage プラグインは、Claude に 2 つの Skills（Maximo データの安全な一括修正の計画、MX Stage の説明・インストール・トラブルシューティング）を追加します。また、Claude Code と Cowork では npx @mxstage/mxstage（Node.js 20 以降）で MX Stage サーバーを起動します。Chat ではローカルサーバーを起動できないため、そこで使用する場合は拡張機能を使ってください。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 を実行してください。

1回のインストールで、このPC上にある対応アシスタントすべてにMX Stageが登録されます。 使用するアシスタントを再起動し、デスクトップで 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を参照）。

各アシスタントでの確認方法

画面名は各製品のドキュメントに記載されている名称です（英語 UI、2026 年 9 月時点）。

アシスタント	MCP（mxstage とそのツール）	スキル（mxstage-workbench など）
Claude Code（CLI）	会話内で /mcp（一覧と接続状態）。シェルでは 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）	表示されません（ファイルはコピーされません）。「MX Stage Skills を表示して」と頼むと、ツールが一覧を返します
Antigravity 2.0	左下の Settings（Ctrl+,）→ Customizations → Installed MCP Servers（再読み込みするには更新します）	同じ Customizations。会話内で /<name> を使って呼び出します
Antigravity IDE	エージェントパネル上部の … → MCP Servers → Manage MCP Servers（View raw config を開くとファイルが表示されます）	エージェントパネルの 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 に「MX Stage をアンインストールして」と伝えるか、%USERPROFILE%\mxstage で次を実行します。

node scripts/setup-local.mjs --uninstall

これにより、各アシスタントから mxstage エントリが削除され（インストーラーが置き換えた設定は復元されます）、コピーされたスキル（編集していないもののみ）、サインイン用ショートカットとデスクトップショートカット、および起動したブリッジが削除されます。自分のスキル（~\.config\mxstage\skills\）とバックアップは保持されます。すべて削除するには、%USERPROFILE%\mxstage と ~\.config\mxstage も削除し（バックアップは元の設定ファイルの完全なコピーで、トークンも含まれます）、ブラウザーで 127.0.0.1:8788 のサイトデータを消去してください。

一部のアシスタントからのみ削除する

インストーラーには単一のアシスタントだけを削除するオプションがないため、そのアシスタントの設定から mxstage エントリのみを削除してください。他のサーバーの設定はそのまま残ります。

アシスタント	MCP サーバーの削除	スキルの削除
Claude Code（CLI）	claude mcp remove --scope user mxstage	~\.claude\skills\ で、MX Stage がコピーしたフォルダー（mxstage-workbench、mxstage-core-*、mxstage-obj-* および自分のスキル名のフォルダー）を削除します
Claude Desktop（チャットと Code タブ）	Settings → Developer → Edit Config で claude_desktop_config.json を開きます。mcpServers の下にある "mxstage" エントリを削除し、Claude Desktop を再度開きます。Code タブからも削除するには、Claude Code からも削除してください	チャットにはありません。Code タブでは Claude Code のものを使います
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-code を追加しない限り、Claude Desktop で MX Stage 拡張機能が有効な間は登録されません）。

Claude Code のインストール手順

ユーザーから MX Stage のインストールを依頼されたら、各コマンドを実行する前にユーザーの承認を得て、次の手順に従ってください。

1. 前提条件を確認する：node --version（22.6 以降）と git --version を実行します。不足している場合は、ユーザーの同意を得て winget install OpenJS.NodeJS.LTS ／ winget install Git.Git でインストールし、新しいシェルで 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 ごとに 1 つです。AI アシスタントが起動したブリッジは、これに中継します
MCP とスキル	登録先 に記載のとおり登録します。一部を除外するには、--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 が名前、説明、本文を提示し、あなたが同意すると下書きを保存します。作業画面に通知が表示されますが、設定 → スキルと辞書で内容を確認して保存するまでは、下書きは使用されません。各スキルには履歴があり、以前のバージョンに戻すことができます。
• インストーラーをもう一度実行すると、この 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 環境のデータを作成、変更、削除する場合は、ユーザー数や PC 数を問わず、本番環境ごとに年間 4,800 米ドルが必要です。ライセンスキーには環境の URL（エイリアスは最大 3 つ）が登録されます。ライセンスと購入。
• 本番環境：組織が日常業務の記録に使用している Maximo、およびその置き換えに向けて準備中の環境（たとえば、本番稼働前の移行先）です。テスト環境：それ以外のすべての環境です（開発、テスト、トレーニング、デモ、移行リハーサルなど）。本番データのコピーを保持していても、テスト環境に該当します。
• **各バージョンは、リリースから 4 年後に 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 による推奨を受けていません。