matlab-agentic-toolkit-setup

MATLAB Agentic Toolkit のセットアップ

MATLAB Agentic Toolkit のオンボーディングを自動化します。MATLAB を検出し、MCP サーバーのバイナリをダウンロードしてインストールし、AI コーディングエージェントを設定して、すべてが正常に動作することを確認します。

テスト済みのプラットフォーム： Claude Code。 自動化に対応したプラットフォーム： GitHub Copilot、Gemini CLI（手動での代替手順も用意されています）。 実験的なプラットフォーム： Codex、Amp は現状のまま提供されます。セットアップでは各手順を案内し、問題が発生した場合は手動での代替手順を提示します。

このスキルでは MATLAB MCP サーバーは必要ありません。最終確認の手順まで、すべてシェルコマンドを使用します。

ウェルカムメッセージ

作業を始める前に、ユーザーにウェルカムメッセージを表示してください。これから行うことと、操作の承認を求める場合がある理由を伝えます。「私」を主語にした、親しみやすく個人的な口調にしてください。メッセージでは、次の内容を説明してください。

Welcome! My goal is to get you set up with the MATLAB Agentic Toolkit so you
can use MATLAB tools and skills with your agent for your projects.

Here's what I'll do:

1. Look around your computer to find your MATLAB installation(s) and check
   whether the MCP server is already installed. Depending on your permissions
   settings, you may be asked to approve some of these steps — I'm just
   reading system info, not changing anything yet.

2. Come back to you with a plan showing what I found and what I'd like to
   configure. You'll have a chance to adjust any choices before I make changes.

3. Once you approve, I'll install the MCP server (if needed), configure your
   agent to use it for your other projects, and verify the connection to MATLAB.

This setup configures everything globally — once it's done, MATLAB tools and
skills will be available in every session, regardless of which project you're
working in. This is the easiest way to get started. If you later want to scope
the configuration to specific projects, the Configuration and Troubleshooting guide covers that.

If you'd rather set things up manually, the Configuration and Troubleshooting guide has
step-by-step instructions: Configuration_and_Troubleshooting.md

表現は自然に調整してください。文言をそのまま読み上げる必要はありませんが、3 つのポイントすべてを含めてください。ウェルカムメッセージを表示したら、応答を待たずにフェーズ 1 に進んでください。

使用する場合

• ユーザーが /matlab-setup を実行するか、MATLAB Agentic Toolkit のセットアップを依頼した場合
• クローン後に初めてこのツールキットを使用する場合
• ツールキットを新しい場所に移動した後
• 新しいバージョンの MATLAB をインストールした後
• MCP サーバーを最新バージョンにアップグレードする場合
• MCP 接続の問題から、インストールが破損している可能性がある場合
• 対応するエージェントプラットフォームで MATLAB MCP を設定する場合

使用しない場合

• MATLAB 環境がすでにセットアップ済みで正常に動作している場合 — 代わりに環境の検証を直接行ってください
• ユーザーが特定の MATLAB タスクについて尋ねている場合（適切なドメインスキルを使用してください）

ワークフローの概要

1. 検出（通知なし）— プラットフォームの検出、MATLAB インストールの検索、既存の MCP サーバーの確認、エージェントプラットフォームの検出
2. 計画（対話あり）— 検出した内容と実行予定の操作をすべて単一の要約として提示し、変更を加える前にユーザーが確認または調整できるようにします
3. 実行（中断なし）— 承認された計画を実行します：バイナリのインストール、エージェントの設定
4. 検証 — MCP サーバーが MATLAB に接続できることを確認します
5. 報告 — 設定した内容とその保存場所をすべて最終要約として提示します

目標は、すべての判断について一度だけユーザーに尋ね、その後は中断せずに実行することです。

---

フェーズ 1：検出

開始前に、簡潔な状況メッセージを表示してください：「MATLAB のインストールを検索し、現在のセットアップを確認しています。読み取り専用コマンドの承認をお願いすることがありますが、情報を収集しているだけで、まだ何も変更していません。」

次の確認をすべて通知なしで実行してください。このフェーズではユーザーに確認を求めないでください。結果をすべて収集し、フェーズ 2 で提示してください。

1a. プラットフォームの検出

uname -s   # Darwin, Linux, or MINGW*/MSYS* for Windows
uname -m   # arm64, x86_64, aarch64

GitHub リリース URL で使用するダウンロードアセット名に対応付けます。

OS	アーキテクチャ	アセット名
macOS	arm64	matlab-mcp-server-macos-arm64
macOS	x86_64	matlab-mcp-server-macos-x64
Linux	x86_64	matlab-mcp-server-linux-x64
Windows	x86_64	matlab-mcp-server-windows-x64.exe

ダウンロードしたアセット名にかかわらず、ローカルのバイナリ名は常に matlab-mcp-server です（Windows では matlab-mcp-server.exe）。

1b. 既存の設定の確認

まず現在の場所にある設定ファイルを確認し、見つからない場合は従来の場所を確認します。

cat ~/.matlab/agentic-toolkits/config.json 2>/dev/null

見つからない場合は、従来の場所を確認します。

cat ~/.matlab-agentic-toolkit/config.json 2>/dev/null

いずれかの場所に有効なパスを含む設定ファイルがある場合は、保存されている値をフェーズ 2 のデフォルトとして記録します。従来の設定ファイルだけが存在する場合は、フェーズ 3 で移行する必要があることを記録してください。

1c. MATLAB のインストールを検索する

PATH（which matlab）、一般的な場所、macOS Spotlight のすべてを検索します。見つかった結果をすべて収集します。

プラットフォーム	検索場所
macOS	/Applications/*/MATLAB_*.app、/Applications/MATLAB_*.app、Spotlight
Linux	/usr/local/MATLAB/R20*、/opt/MATLAB/R20*
Windows	/c/Program Files/MATLAB/R20*

各結果を検証します：test -x "$MATLAB_ROOT/bin/matlab" を実行し、VersionInfo.xml からバージョンを読み取ります。

1d. 既存の MCP サーバーを確認する

現在の場所にあるバイナリ（新しい名前を先に、次に古い名前）を確認し、その後、従来の場所を確認します。

~/.matlab/agentic-toolkits/bin/matlab-mcp-server --version 2>/dev/null
~/.matlab/agentic-toolkits/bin/matlab-mcp-core-server --version 2>/dev/null
~/.local/bin/matlab-mcp-core-server --version 2>/dev/null

いずれかの場所で見つかった場合は、パスとバージョンを記録します。いずれかの場所で古い名前（matlab-mcp-core-server）の下に見つかった場合は、フェーズ 3 で名前を変更する対象として記録します。従来のディレクトリ（~/.local/bin/）でのみ見つかった場合は、ディレクトリの移行も必要として記録します。また、GitHub から最新バージョンを照会します。

curl -sL https://api.github.com/repos/matlab/matlab-mcp-core-server/releases/latest | grep '"tag_name"' | head -1 | sed 's/.*"\(v[^"]*\)".*/\1/'

1e. 既存のエージェント設定を確認する

Claude Code の場合：

claude plugin list 2>&1

その他のプラットフォームの場合は、グローバル設定ファイルに matlab MCP サーバーのエントリがすでにあるか確認します（パスについては、プラットフォーム固有のリファレンスファイルを参照してください）。

1f. エージェントプラットフォームを検出する

環境と CLI ツールを確認します：claude --version（Claude Code）、codex --version（Codex）、amp --version（Amp）、gemini --version（Gemini CLI）、$VSCODE_*（Copilot）。判断が難しい場合は、ユーザーに尋ねます。

1g. 従来のアーティファクトを確認する

プラットフォーム固有のリファレンスファイルを読み、その Legacy Artifacts セクション（存在する場合）に記載された項目があるか確認します。見つかった項目を記録します。これらはプランに表示され、フェーズ 3 でクリーンアップされます。

リファレンスファイルの解決： 再実行時（~/.matlab/agentic-toolkits/config.json または ~/.matlab-agentic-toolkit/config.json が存在する場合）は、その設定内のツールキットソースパスからリファレンスファイルを解決します。新しいスキーマでは、これは toolkits.matlab.source（ローカルパスであり、"release" ではない場合）です。従来のスキーマでは、toolkitRoot です。例：<source>/skills-catalog/toolkit/matlab-agentic-toolkit-setup/reference/<filename>。これにより、スキルがプラグインキャッシュから読み込まれた場合に、古いキャッシュ済みバージョンを参照することを防げます。

1h. 従来の設定ファイルの場所を検出する

~/.matlab-agentic-toolkit/config.json に設定ファイルが見つかり、~/.matlab/agentic-toolkits/config.json には見つからなかった場合は、移行が必要であることを記録します。古い設定ファイルはフラットスキーマを使用しているため、フェーズ 3 で複数のツールキットに対応するスキーマへ変換する必要があります。

---

フェーズ 2：プラン

見つかった内容と提案する操作を1 つのメッセージにすべて提示します。エージェントに対話型の情報収集ツールがある場合は、それを使用してもかまいません。ない場合は、プランを表示して通常のユーザー返信を待ちます。次の形式でプランを作成します。

MATLAB Agentic Toolkit — Setup Plan
====================================

Platform:  macOS arm64

MATLAB installations found:
  [1] R2025b  /Applications/MATLAB_R2025b.app
  [2] R2024b  /Applications/MATLAB_R2024b.app

MCP server:
  Installed:  not found
  Latest:     v0.7.0

Agent platform:  Claude Code (detected)
  Status:        Tested

Proposed actions:
  MATLAB:        Use R2025b (/Applications/MATLAB_R2025b.app)
  MCP server:    Download v0.7.0 to ~/.matlab/agentic-toolkits/bin/matlab-mcp-server
  Display mode:  desktop (full MATLAB desktop visible)
  Agent config:  Configure MCP server globally (available in all sessions)
  Migration:     (none)

Proceed with this plan? You can adjust any choice:
  - Pick a different MATLAB: "use 2" or provide a path
  - Keep existing server: "use server at /path/to/binary"
  - Change display: "use nodesktop" (MATLAB runs headless; windows still open for plots)
  - Configure a different agent: "use Codex" or "use Amp"

MATLAB のインストールが見つからなかった場合は、代わりに次の内容を表示します。

MATLAB installations found:
  (none detected)

Options:
  [1] Provide the path to an existing MATLAB installation
  [2] Install MATLAB using the matlab-install-products skill

プランの残りを確定する前に、ユーザーが選択するのを待ちます。

Migration 行には、フェーズ 1g、1h、1d で見つかった従来のアーティファクトを表示します。見つからなかった場合は (none) と表示します。例：

• Remove ~/.claude/.mcp.json (migrated to claude mcp add)
• Migrate config from ~/.matlab-agentic-toolkit/ to ~/.matlab/agentic-toolkits/
• Move binary from ~/.local/bin/ to ~/.matlab/agentic-toolkits/bin/

Claude 以外のプラットフォームでは、「EXPERIMENTAL — untested, provided as-is」と明記し、自動セットアップに失敗した場合は手動での代替手順を提示することも伝えます。

OpenAI Codex の場合、プランには次の両方を含める必要があります。

• ~/.codex/config.toml のグローバル MCP 設定
• セットアップ後、どのリポジトリからでもツールキットを使用できるようにするための、~/.agents/skills/ のグローバルスキル参照

判断項目

判断項目	デフォルト	変更方法
MATLAB の選択	見つかった中で最も新しいリリース	ユーザーが番号を選ぶか、パスを指定
MCP サーバー	最新版を ~/.matlab/agentic-toolkits/bin/ にダウンロード	ユーザーが「既存のものを使用」と指示するか、パスを指定
表示モード	desktop	ユーザーが「nodesktop を使用」と指示
エージェントプラットフォーム	自動検出	ユーザーが「[platform] を使用」と指示

MATLAB が見つからない場合

MATLAB が見つからなかったことを報告し、ユーザーに次の 2 つの選択肢を提示します。

1. 既存の MATLAB インストールへのパスを指定します。続行する前に検証してください。
2. matlab-install-products スキルを使用して MATLAB をインストールします（必要に応じて、追加のツールボックスやサポートパッケージもインストールできます）。インストールするバージョンは R2021a 以降である必要があります。それより古いリリースは MCP サーバーに対応していません。

ユーザーが選択肢 2 を選んだ場合は、matlab-install-products に引き継ぎます（R2021a 以降であることを確認してください）。検証済みの MATLAB パスが報告されたら、新しくインストールされたルートを使用してフェーズ 3 から再開します。

ユーザーが確認した場合

ユーザーが確認したら、フェーズ 3 に進みます。選択内容が変更された場合はプランを更新し、変更が重要な場合に限り、再確認を求めます。

---

フェーズ 3：実行

開始前に、次の短いステータスメッセージを表示します。「了解しました。これからプランを実行します。ダウンロード、設定ファイルの書き込み、スキルの登録を行います。権限の設定によっては、これらの操作の承認を求められる場合があります。」

承認済みのプランを実行します。このフェーズではユーザーに確認を求めないでください。判断はすべてフェーズ 2 で完了しています。プランに matlab-install-products を使用した MATLAB のインストールが含まれている場合は、最初にそれを実行してから、ステップ 3a に進みます。

3a. MCP サーバーをインストールする（必要な場合）

フェーズ 1d で、バイナリがレガシーの場所（~/.local/bin/matlab-mcp-core-server）にあり、すでに最新バージョンだった場合は、再ダウンロードせずに移動して名前を変更します。

mkdir -p ~/.matlab/agentic-toolkits/bin
mv ~/.local/bin/matlab-mcp-core-server ~/.matlab/agentic-toolkits/bin/matlab-mcp-server

フェーズ 1d で、バイナリが現在の場所（~/.matlab/agentic-toolkits/bin/matlab-mcp-core-server）に旧名であり、すでに最新バージョンだった場合は、名前を変更します。

mv ~/.matlab/agentic-toolkits/bin/matlab-mcp-core-server ~/.matlab/agentic-toolkits/bin/matlab-mcp-server

それ以外の場合は、curl（推奨）または wget を使用して、新しい名前で直接保存します。

mkdir -p ~/.matlab/agentic-toolkits/bin
curl -sL -o ~/.matlab/agentic-toolkits/bin/matlab-mcp-server \
  "https://github.com/matlab/matlab-mcp-core-server/releases/download/${LATEST_TAG}/${ASSET_NAME}"

ダウンロード後（または移動後）：chmod +x（macOS/Linux）、xattr -d com.apple.quarantine（macOS）、Unblock-File（Windows）を実行します。macOS Gatekeeper にブロックされた場合は、System Settings > Privacy & Security > Allow Anyway を選択します。

確認します：~/.matlab/agentic-toolkits/bin/matlab-mcp-server --version

ダウンロードに失敗した場合は、手動ダウンロード用の直接 URL を提示します。

旧名のバイナリを削除する： インストールまたは名前変更が正常に完了したら、旧名のバイナリを削除します。

rm -f ~/.matlab/agentic-toolkits/bin/matlab-mcp-core-server
rm -f ~/.local/bin/matlab-mcp-core-server

3b-migrate. レガシーの成果物をクリーンアップする

フェーズ 1g でレガシーの成果物が見つかった場合は、プラットフォームのリファレンスファイルにある Legacy Artifacts セクションの手順に従って、ここでクリーンアップします。新しい設定が正常に書き込まれた後にのみ成果物を削除してください（つまり、3b-platform の後に実行し、その前には実行しないでください）。

3b-shared. グローバルスキルを登録する（Copilot、Codex、Gemini）

~/.agents/skills/ からスキルを検出するプラットフォーム（GitHub Copilot、OpenAI Codex、Gemini CLI）では、ツールキットのリポジトリを参照するシンボリックリンクを作成します。この処理は、複数のプラットフォームを設定する場合でも一度だけ実行すれば十分です。

ツールキットには、クロスプラットフォーム対応のヘルパースクリプトが含まれています。

macOS / Linux：

bash "<TOOLKIT_ROOT>/skills-catalog/toolkit/matlab-agentic-toolkit-setup/scripts/install-global-skills.sh" "<TOOLKIT_ROOT>"

Windows PowerShell：

powershell -ExecutionPolicy Bypass -File "<TOOLKIT_ROOT>\skills-catalog\toolkit\matlab-agentic-toolkit-setup\scripts\install-global-skills.ps1" -ToolkitRoot "<TOOLKIT_ROOT>"

これらのスクリプトは、公開済みのすべてのスキル（manifest.yaml を含む skills-catalog/ 配下のすべてのディレクトリ）を自動検出し、~/.agents/skills/ にシンボリックリンクを作成します。作成または更新されたスキルリンクの一覧をユーザーに伝えます。

3b-platform. エージェントプラットフォームを設定する

プラットフォーム固有のリファレンスファイル（このスキルファイルと同じ場所にある reference/ ディレクトリ内）を読み、記載されている指示に正確に従ってください。パスの解決にはツールキットのルートを使用してください：<TOOLKIT_ROOT>/skills-catalog/toolkit/matlab-agentic-toolkit-setup/reference/<filename>。

プラットフォーム	リファレンスファイル
Claude Code	reference/claude-code-setup-guidance.md
GitHub Copilot	reference/copilot-setup-guidance.md
OpenAI Codex	reference/codex-setup-guidance.md
Sourcegraph Amp	reference/amp-setup-guidance.md
Gemini CLI	reference/gemini-cli-setup-guidance.md

各リファレンスファイルには、正確な設定形式、グローバル設定パス、マージ手順、手動での代替手順が記載されています。MCP サーバーは、ユーザーがどのワークスペースを開いてもすべてのセッションで利用できるよう、（プロジェクトごとではなく）グローバルに設定する必要があります。

設定ファイルを書き込んだ後は必ず、次の内容をユーザーに伝えてください：

1. 書き込んだファイルのパス
2. 書き込んだ正確な内容
3. ファイルを新規作成したのか、既存のエントリーを更新したのか

3c. レガシー設定を移行する（必要な場合）

Phase 1h で ~/.matlab-agentic-toolkit/config.json にレガシー設定が検出された場合は、ここで移行してください：

1. 古い設定を読み込む
2. フラットなスキーマを複数ツールキット対応のスキーマに変換する：
   • matlabRoot → matlab.root
   • mcpServerVersion → mcpServerVersion
   • mcpServerPath → mcpServerPath
   • displayMode → そのまま保持する（新しいスキーマでもこのフィールドは引き続きサポートされています）
   • configuredPlatforms: ["claude-code"] → configurations.global.claude_code.toolkits: ["matlab"]
   • toolkitRoot → toolkits.matlab.source（git クローンを指す場合は "local"、それ以外は "release" を使用）および toolkits.matlab.version（setupSkillVersion または "unknown" を使用）
3. 変換した設定を新しい場所に書き込む（下記の 3d を参照）
4. 古いディレクトリを削除する：rm -rf ~/.matlab-agentic-toolkit

3d. 状態を保存する

設定を ~/.matlab/agentic-toolkits/config.json に書き込みます：

mkdir -p ~/.matlab/agentic-toolkits

{
  "toolkits": {
    "matlab": {
      "version": "<TOOLKIT_VERSION_OR_CALVER_TAG>",
      "source": "<SOURCE_PATH_OR_release>"
    }
  },
  "mcpServerVersion": "<VERSION>",
  "mcpServerPath": "<FULL_PATH_TO_BINARY>",
  "matlab": {
    "root": "<MATLAB_ROOT>",
    "version": "<MATLAB_RELEASE>"
  },
  "displayMode": "<DISPLAY_MODE>",
  "configurations": {
    "global": {
      "<AGENT_KEY>": {
        "toolkits": ["matlab"]
      }
    },
    "projects": {}
  },
  "setupSkillVersion": "<SKILL_VERSION>",
  "lastUpdated": "<ISO_8601_TIMESTAMP>"
}

注：toolkits は複数のエントリーに対応しています（例："matlab" と並べて "simulink"）。source は、GitHub からインストールした場合は "release"、開発用クローンの場合はローカルパスです。configurations のエージェントキーにはアンダースコアを使用します（例：claude_code、gemini_cli）。setupSkillVersion には、アップグレードの検出に使用する、このファイルのフロントマターに記載されたバージョンを記録します。

3e. 保存した設定を検証する

config.json を書き込んだ後、読み戻してパスが実在することを確認します：

cat ~/.matlab/agentic-toolkits/config.json
test -d "<matlab.root>" && echo "OK: matlab root exists" || echo "FAIL: matlab root not found"
test -x "<mcpServerPath>" && echo "OK: mcp server executable" || echo "FAIL: mcp server not found"
test -d "<toolkits.*.source>" && echo "OK: toolkit source exists" || echo "FAIL: toolkit source not found"

出力を確認します。JSON が正しい形式であること（括弧の対応、末尾のカンマがないこと、途中で切れていないこと）と、3 つすべてのパスチェックに合格していることを確認してください。問題があれば、設定を修正してから再検証し、その後に進んでください。

---

Phase 4：検証

簡潔なステータスメッセージを表示します：「セットアップが完了しました — MATLAB への接続を検証しています。」 検証手順はエージェントプラットフォームによって異なります。

Claude Code

（プラグイン経由で利用可能になった）MATLAB MCP ツールを使用して、次を実行します：

v = ver('MATLAB');
fprintf('MATLAB %s (%s) — ready.\n', v.Version, v.Release);

現在のセッションで MCP ツールを利用できない場合（初回セットアップ後によくあります）は、ユーザーに次のように伝えてください：

プラグインをインストールしたばかりです。MATLAB MCP ツールを有効にするには、新しい Claude Code セッションを開始してから、「実行中の MATLAB のバージョンは何ですか？」と尋ねて確認してください。

その他のプラットフォーム

Claude 以外のプラットフォームでは、可能な範囲で検証します：

1. バイナリが実行できること：

   ~/.matlab/agentic-toolkits/bin/matlab-mcp-server --version
   

2. 設定ファイルが存在し、matlab エントリーが含まれていること：

   cat <GLOBAL_CONFIG_PATH> 2>/dev/null | grep -l matlab
   

3. エージェントでの確認方法をユーザーに伝える：

   [platform name] を再起動して、「実行中の MATLAB のバージョンは何ですか？」と尋ねてください。 エージェントが detect_matlab_toolboxes または evaluate_matlab_code を呼び出せれば、セットアップは成功です。

検証に失敗した場合：

1. バイナリが存在し、実行可能であることを確認します：test -x ~/.matlab/agentic-toolkits/bin/matlab-mcp-server
2. 問題を診断するため、サーバーを手動で実行してみます：

   ~/.matlab/agentic-toolkits/bin/matlab-mcp-server --matlab-root <path> --matlab-display-mode desktop 2>&1 | head -20
   

3. 出力に「Application startup complete」があるか確認します

---

フェーズ 5：レポート

次の内容を含む最終的な概要を提示します：MATLAB のバージョンと場所、MCP サーバーのバージョンとバイナリのパス、表示モード、エージェントのプラットフォームと設定ファイルのパス、状態ファイルの場所。

• Claude Code の場合： インストールされているプラグインとそのスコープを一覧表示します。次の手順：新しいセッションを開始し、「実行中の MATLAB のバージョンは何ですか？」を試して、利用可能なスキルを一覧表示します。
• その他のプラットフォームの場合： 次の手順：エージェントを再起動し、「実行中の MATLAB のバージョンは何ですか？」を試します。トラブルシューティングとして、設定ファイルの確認、バイナリのテスト、Configuration_and_Troubleshooting.md および課題トラッカー（https://github.com/matlab/matlab-agentic-toolkit/issues）へのリンクを含めます。

---

再実行時の動作

セットアップを再実行するときは、~/.matlab/agentic-toolkits/config.json の既存の設定をデフォルトとして読み込み、すべての検出処理を実行し、現在の状態と提案する状態（例：「v0.6.0 → v0.7.0 にアップグレード」）を示す計画を提示し、変更された項目のみを実行して、検証と報告を行います。

---

規則

• 検証（Claude Code の場合はフェーズ 4）を除くすべての手順で、bash コマンドを使用します。検証には MATLAB MCP ツールを使用します。
• ツールキットのディレクトリ、~/.matlab/agentic-toolkits/、およびプラットフォームのグローバル設定パス以外のファイルは変更しません。
• フェーズ 1 ではすべての情報を無言で収集し、フェーズ 2 で判断事項をまとめて提示します。
• 失敗した場合は、具体的な対処方法を示します。説明なしに未加工のエラーを表示してはいけません。
• Claude 以外のプラットフォームでは、必ず手動での代替手順を提示します。
• Windows のパスのエスケープ： JSON と TOML ではどちらも \ をエスケープ文字として扱います。Windows のパスを設定ファイルに書き込むとき、または CLI コマンド（claude mcp add-json など）に渡すときは、スラッシュ（C:/Users/Name/...）を使うか、バックスラッシュをすべて二重にする（C:\\Users\\Name\\...）必要があります。エスケープされていないバックスラッシュを使うと、無効なエスケープシーケンスが生じ、設定ファイルが気付かないうちに破損します。Python の json.dump() はパスが文字列値として渡されると自動的に処理するため、文字列補間よりもプログラムによる書き込みを優先してください。

ガードレール

必ず行うこと

• ダウンロードする前に、既存のインストールを確認します。
• 続行する前に、MATLAB のルートを検証します。
• 変更を加える前に、計画全体を提示します。
• 設定ファイルに書き込んだ内容を、正確にそのまま表示します。
• 実験的または未テストのプラットフォーム対応には、明確にその旨を表示します。

事前に確認すること

• すべての判断事項はフェーズ 2 でまとめて提示します。実行中に追加で確認してはいけません。
• MATLAB が複数インストールされている場合は、一覧を提示し、最新のものを推奨します。

絶対に行わないこと

• MATLAB を bash／ターミナル経由で起動してはいけません。MCP ツールのみを使用します（Claude Code の場合はフェーズ 4 でのみ使用）。
• MATLAB を直接インストールしてはいけません。「MATLAB が見つからない」フローでユーザーがその選択肢を選んだ場合に限り、matlab-install-products に委任します。
• 他の MCP サーバーの既存の設定項目を上書きしてはいけません（matlab 項目のみ追加または更新します）。
• 検証手順を省略してはいけません。
• フェーズ 1（検出）またはフェーズ 3（実行）中にユーザーに確認してはいけません。
• テストされていないプラットフォームを、完全にサポートされていると主張してはいけません。

---

Copyright 2026 The MathWorks, Inc.

---