コンテンツにスキップ

MCP（AI連携）

Zume Editor は zume-mcp という別プログラムを同梱しています。これは MCP（Model Context Protocol）サーバー として動作し、対応する AI クライアント （Claude Desktop や Claude Code など）が起動して、ファイルの読み取り・作成・編集、 アプリで設定済みのデータベースへの問い合わせ、保管した API キーでの外部サービスへの HTTPS 到達を、すべてエディター本体の実績あるエンジン経由で行えます。

zume-mcp は stdio（標準入出力）上で JSON-RPC 2.0 を話します。ウィンドウは持たず、自身で ネットワークポートを開くこともありません。アプリと同じ場所にインストールされます （Windowsは実行ファイルの隣、Linuxは bin/、macOSはアプリフォルダー内）。

ツール一覧

ファイル / テキスト / Hex / 検索 / 差分（ローカルディスク）:

ツール 内容
read_file_range ファイルの指定バイト範囲を読む（超大容量でも可）
file_info ファイルの有無とバイトサイズ
write_file 新規作成、または既存ファイルの上書き / 追記（テキスト or hex）
search_in_file リテラル / 正規表現検索。オフセット・行付きで一致を返す
extract_strings 印字可能ASCIIの連なりをバイトオフセット付きで抽出
hex_dump 指定バイト範囲の 16進 + ASCII ダンプ
find_bytes 16進バイト列の全出現オフセット（先頭 64 MiB）
patch_bytes 既存ファイルの指定オフセットをバイト上書き
replace_in_file 既存ファイルのリテラル / 正規表現一致を全置換し保存
detect_encoding 文字コードと改行コードの判定
diff_files 2ファイルの行差分（追加 / 削除行）
search_in_files ディレクトリ配下の全テキストファイルをリテラル / 正規表現検索
replace_in_files ディレクトリ横断の置換。既定はプレビュー、適用は1トランザクション
search_large_file 任意サイズのファイルをストリーム検索（オフセット＋プレビュー）
compare_folders 2つのフォルダーツリーを比較（同一 / 相違 / 左のみ / 右のみ）
list_symbols ソースの定義（関数・型など）を行番号付きで一覧
markdown_to_html Markdown（GFM テーブル・インライン装飾）を HTML 文書に変換

地理データ / 変換 / アーカイブ / パッチ / スクリプト:

ツール 内容
geo_convert 地理データを GeoJSON / WKT / KML / GPX / CSV 間で変換
geo_measure GeoJSON / WKT の測地長（m）/ 面積（m²）
geo_point geohash、地図タイル＋quadkey＋bbox、平面直角座標系、DMS ⇄ 十進
geo_reproject GeoJSON を EPSG 間で再投影（PROJ）
convert_list / convert_run 変換ツールボックスの一覧 / 実行（base64、JSON ⇄ CSV、タイムスタンプ 等）
archive_list / archive_extract / archive_create zip / tar / 7z の一覧・展開・作成
patch_bin バイナリパッチの適用 / 作成（IPS / BPS / UPS / bsdiff / VCDIFF）
run_script サンドボックス Lua をファイルに実行（プレビュー、または save で書き戻し）

セキュリティ解析（バイナリ診断 / 変換 / シグネチャ）:

ツール 内容
entropy Shannon エントロピー（全体＋窓ごとのスパークライン）とバイトヒストグラム — パック/暗号化領域の検出
transform CyberChef 風レシピ：XOR / ROT / RC4 / base58・85 / hex ＋ convert ツールボックスを 1 本に合成
yara_scan ファイル / ディレクトリ / インラインを、実用的な YARA ルールのサブセットで走査
pe_info Windows の EXE / DLL（PE32 / PE32+）の構造：マシン種別、サブシステム、タイムスタンプ、リンカー、ASLR / DEP / CFG フラグ、.NET と Authenticode の有無、セクションとそのエントロピー、インポート（遅延ロード含む）とエクスポート（フォワーダー含む）、リソースツリーとバージョン文字列・文字列テーブル・ダイアログのキャプションとコントロール・メニュー項目・マニフェスト、PDB パス、オーバーレイ。構造の読み取りのみで逆アセンブルはしません
elf_info ELF 実行ファイル / 共有オブジェクト（ELF32 / ELF64、両エンディアン）の構造：種別、マシン、エントリ、インタープリター、セグメントとセクション（エントロピー付き）、動的セクション（必要なライブラリ、soname、rpath / runpath）、バージョン付きのインポート / エクスポートシンボル、GNU ビルド ID、ハードニング（PIE、NX スタック、RELRO、スタックカナリア、FORTIFY）
macho_info Mach-O イメージまたは fat / ユニバーサルバイナリ（全スライスを列挙し slice で選択）の構造：CPU、ファイル種別、ヘッダーフラグ、全ロードコマンド、セグメント / セクション（エントロピー付き）、バージョン付き dylib、rpath、UUID、プラットフォーム / 最小 OS / SDK、エントリ、インポート / エクスポートシンボル、コード署名と暗号化の有無

データベース（アプリで設定済みの接続、または SQLite ファイル）:

ツール 内容
db_list_connections 保存済み SQL 接続の一覧（名前のみ・パスワードなし）
db_schema 接続のテーブル / ビューと列を一覧
db_query 接続に対して SQL を実行し結果行を返す
nosql_list_connections 保存済み Redis / MongoDB 接続を一覧（名前のみ）
nosql_command Redis / MongoDB のコマンドを実行し結果を JSON で返す

Git（ローカルリポジトリ・読み取り専用）:

ツール 内容
git_status 現在のブランチとステージ済み / 未ステージの変更
git_log コミット履歴（id・要約・作者・日時）を新しい順に
git_branches ローカルブランチ（現在ブランチ・ahead / behind）
git_diff 1ファイルの差分（ステージ済み / 未ステージ）

リモートファイル（FTP / FTPS / SFTP）（アプリで設定済みの接続）:

ツール 内容
remote_list_connections 保存済み FTP / FTPS / SFTP 接続を一覧（名前のみ）
remote_ls リモートディレクトリの一覧
remote_get リモートファイルをダウンロード（ローカル保存 or 内容を返す）
remote_put ローカルファイル or インラインテキストをアップロード
remote_delete リモートのファイル / 空ディレクトリを削除
remote_rename リモートファイルのリネーム / 移動
remote_mkdir リモートにディレクトリ作成

クラウドストレージ（アプリ、または zume-cli でサインイン済みのアカウント）:

ツール 内容
cloud_ls Dropbox / Google Drive / OneDrive / Box のフォルダーを一覧
cloud_get 接続済みクラウドからファイルをダウンロード
cloud_put ローカルファイル or インラインテキストをアップロード

生成AIハブ:

ツール 内容
list_credentials ローカル保存された API キーの名前一覧
http_request 任意の HTTPS API へリクエスト。保存キーで認証も可

AI が触れる範囲を制限する（サンドボックス）

zume-mcp プロセスに設定する 2 つの環境変数で、ファイル系ツールの範囲を絞れます。 どちらも任意で、未設定なら従来どおり全アクセス可能（既定）です。エージェントを 限定したいときは、MCP クライアントのサーバー設定（env ブロック）で指定します。

変数 効果
ZUME_MCP_ROOTS 許可ディレクトリの一覧（区切りは Windows ;、その他 :）。パスがいずれかのフォルダー配下でなければ拒否。シンボリックリンクや .. は先に解決するため、外へは抜けられません。
ZUME_MCP_READONLY 1 / true / yes / on でサーバーを読み取り専用に。ファイルを変更するツール（書き込み・patch・replace・展開・作成・アップロード、save 付き run_script）を拒否。読み取りは可能。 
{
  "mcpServers": {
    "zume": {
      "command": "C:\\Tools\\Zume\\zume-mcp.exe",
      "env": { "ZUME_MCP_ROOTS": "C:\\work\\project", "ZUME_MCP_READONLY": "1" }
    }
  }
}

拒否は通常のツールエラーとして返り、クラッシュしません。サンドボックスはローカル ファイル系ツールに適用され、データベース / リモート / クラウド / http_request はそれぞれ独自の規則（保存済み接続、読み取り専用 DB プロファイル、HTTPS 限定）を 持ちます。

AI にできること・できないこと

AI は上記ツール経由でのみ動作します。

できること:

  • あなたのアカウントが読めるファイルの読み取り・調査（テキスト・ログ・バイナリ）。
  • ファイルの作成・上書き・追記・バイト書き換え（write_file / replace_in_file / patch_bytes）。実際の書き込みです。
  • データベースへの問い合わせ。アプリで設定済みの SQL 接続を一覧 （db_list_connections）、スキーマ参照（db_schema）、SQL 実行（db_query）できます。 保存済み接続は名前で、SQLite はファイルパスで指定します。パスワードは OS の資格情報 ストアから取得され、AI には見えません。
  • FTP / FTPS / SFTP でのリモートファイル操作。アプリで設定済みの接続を使い、 remote_ls / remote_get / remote_put / remote_delete / remote_rename / remote_mkdir が可能です。パスワードは OS の資格情報ストアから取得します。SFTP は、 サーバーのホスト鍵が既に信頼済みである必要があり（エディターで一度接続）、未知・変更 された鍵は拒否されます（ヘッドレスではフィンガープリントを確認できないため）。
  • HTTPS で外部へ送信・取得（http_request、GET/POST/PUT/PATCH/DELETE/HEAD）。 ローカル保管の API キーで認証でき、キーは名前指定（秘密値は zume-mcp が付与し、 AI 側には返りません）。

できないこと（仕様）:

  • アプリに未設定の DB へ任意接続すること - db_query は保存済み接続か、指定された SQLite パスのみを使います。
  • SQL 以外の経路での DB 到達 - http_request は HTTPS API 用で、DB ツールはエディターの SQL エンジン（SQLite / MySQL・MariaDB / PostgreSQL / SQL Server）を使います。
  • 専用のクラウドドライブ操作 - クラウドの upload / download は zume-cli cloud コマンドやエディターの クラウドドライブ、または各社 HTTPS API を http_request で叩く形で行います。
  • http://・ループバック・ローカルネットワーク URL への到達 - https:// のみ許可。

セットアップ

MCP クライアントの起動コマンドに zume-mcp を指定します。JSON 設定を使うクライアント （Claude Desktop など）の場合:

{
  "mcpServers": {
    "zume-editor": {
      "command": "zume-mcp"
    }
  }
}

Windows で zume-mcp が PATH に無い場合はフルパスを指定します。例: "command": "C:\\Program Files\\Zume Editor\\zume-mcp.exe"

Microsoft Store（MSIX）版について

Microsoft Store 版は MCP サーバーとして利用できません。zume-mcp は 保護された C:\Program Files\WindowsApps\… 配下（更新のたびに変わる バージョン別パスで、PATH にも登録されません）にインストールされるため、 MCP クライアントから起動できません。Windows で MCP サーバー（や CLI）を使うには、代わりにポータブル ZIP（またはインストーラー版） を導入し、任意の安定フォルダーに展開して、そこの zume-mcp.exe をクライアントに 指定してください。例:

{ "mcpServers": { "zume": { "command": "C:\\Tools\\Zume\\zume-mcp.exe" } } }

Claude Code CLI の場合:

claude mcp add zume -s user -- "C:\Tools\Zume\zume-mcp.exe"

DB ツールは、アプリの データベース ワークスペースで設定した接続を参照します。 http_request 用の API キーは zume-cli aikey set <name> で保存します（CLI）。 AI 側は list_credentials で名前を確認できます。

業務ワークフローの例

いずれも AI への1つの依頼で、AI 自身がツールを組み合わせて実行します。

1. コードベース全体の検索と修正

「src 配下で legacy_init( を呼んでいるファイルをすべて見つけて、init( に変えて」

search_in_file + replace_in_file を使用。

2. DB のテーブルを CSV に出力

「reporting データベースに接続して、今月の orders を orders.csv に出力して」

AI は保存済みの reporting 接続に db_query（パスワードは資格情報ストアから）を実行し、 write_file で orders.csv を作成します。アプリで読み取り専用に設定した接続では、 読み取りクエリ以外は拒否されます。

3. Web API でファイルを補完

「orders.csv の各行について REST API からステータスを取得し、orders_enriched.csv に書いて」

AI はファイルを読み、保存キーで認証した http_request で API を呼び、write_file で新しい ファイルを書き出します。

4. クラウドドライブへアップロード

「report.pdf を Dropbox の /reports にアップロードして」

AI はファイルを読み、Dropbox のコンテンツ API へ保存トークン付きで http_request します。 （対話的な参照は zume-cli cloud やエディターの クラウドドライブ で。）

5. 保管キーで外部 LLM / API を呼ぶ

「notes.md を OpenAI で要約して summary.md に保存して」

一度キーを保存（zume-cli aikey set openai）すれば、AI は http_request で LLM を呼び、 write_file で結果を書き出します。キーの値はローカルの資格情報ストアに留まり、AI には 見えません。

6. サーバー上のファイルを扱う

「staging の SFTP 接続から /var/log/app.log を取得し、エラーを抽出して、整形版を /var/log/app.clean.log としてアップロードして」

AI は保存済み staging 接続で remote_get し、テキストを処理して remote_put で書き戻します。 staging のホスト鍵はエディターで事前に信頼済みである必要があります（SFTP）。

AI に Lua スクリプトを書かせる（エディターのカスタマイズ）

強力な使い方: 繰り返し作業用の Zume Luaスクリプト を AI に書かせ、 エディターで実行します。

「選択行の = を揃える Zume の Lua スクリプトを書いて、align_equals.lua に保存して」

AI は zume API を使ってスクリプトを作成し、write_file で align_equals.lua を作成します。 あとは Script → Run Lua File で実行し、思いどおりになるまで AI と調整します。

Note

zume-mcp は Lua を実行しません。実行するのはエディター（編集はすべて取り消し 可能）です。スクリプトはあなたが確認して実行するため、AI にエディターを拡張させつつ、 主導権はあなたに残ります。

利用上の注意

一部のツールはディスク上のファイルを変更します

write_file / patch_bytes / replace_in_file はファイルを作成・上書き・変更します。 これらの書き込みは MCP 側からは取り消せません（エディター画面での編集とは異なります）。 信頼できるフォルダーでのみ使い、バックアップやバージョン管理を併用してください。

DB・リモート・ネットワークはあなたの名義で実行されます

db_query は設定済み DB の読み取りと（読み取り専用でなければ）書き込みができ、 remote_* は設定済みの FTP / SFTP サーバー上のファイルの読み取り・アップロード・削除・ リネームができ、http_request は保存キーを使って任意の HTTPS エンドポイントへの送受信 ができます。パスワードやキーの値が AI に渡ることはありませんが、操作はあなたの資格情報で 実行されます。到達させたい接続とキーだけを設定し、信頼できるクライアントにのみ MCP を 接続し、AI の動作を確認してください。

  • あなたの権限で動作します。 zume-mcp は、あなたのアカウントが読み書きできるファイルを すべて操作でき、設定済みの DB に到達できます。
  • HTTPS 専用・ボディ上限。 http_request は https:// 以外を拒否し、応答ボディは 1 MiB で打ち切られます（body_truncated で通知）。