MCP の使い方｜方眼Diff

MCP とは

MCP（Model Context Protocol）は、AI アシスタントに外部ツールをつなぐための標準規格です。方眼Diff の MCP サーバ（hogandiff-mcp）を登録すると、AI が方眼Diff の比較エンジンを「道具」として自分で使えるようになります。比較の実行・結果の解釈・条件を変えての再比較まで、すべて対話で進められます。

セットアップ

配布 zip に含まれる hogandiff-mcp（Windows は hogandiff-mcp.exe）を、お使いのクライアントに登録します。

Claude Desktop

設定ファイル claude_desktop_config.json に追記します：

{
  "mcpServers": {
    "hogandiff": {
      "command": "C:\\tools\\hogandiff-win-x64\\hogandiff-mcp.exe"
    }
  }
}

Claude Code

claude mcp add hogandiff -- C:\tools\hogandiff-win-x64\hogandiff-mcp.exe

その他のクライアント

stdio 方式の MCP に対応したクライアント（Cursor、VS Code など）であれば、同じ要領でコマンドとして hogandiff-mcp のパスを登録するだけです。なお、ローカルのツールを登録できないサービス（リモートコネクタ方式のみのもの）では利用できません。

使ってみる

登録できたら、AI にファイルパスを添えて頼むだけです：

「C:\work\予算_2025.xlsx と C:\work\予算_2026.xlsx を比較して、何が変わったか教えて」
「差分が多いシートはどれ？一番変更が大きいところを要約して」
「150行目あたりの差分を詳しく見せて」
「D列は集計列だから無視して、もう一度比較して」
「着色したブックを Excel で開いて」

AI は比較を実行したうえで、結果の全体像から個別のセルまで必要な深さだけを取得して答えます。着色ブックとレポートも通常どおり生成されるので、最後は自分の目でも確認できます。

ツール一覧

AI が使える道具の見取り図です（利用者が直接呼ぶ必要はありません）。

分類	ツール	できること
比較する	`compare_workbooks`	2つのブックを全シート比較（シート対応は自動）
	`compare_sheets`	1シートずつ名指しで比較（同一ブック内も可）
	`compare_folders`	フォルダ直下の Excel をまとめて比較
	`compare_trees`	サブフォルダごと再帰的に比較
	`list_protected_files`	パスワード保護ブックを比較前に洗い出し
掘り下げる	`get_details`	比較結果を段階的にドリルダウン（対応表・差分明細・行/列の対応解決）
	`read_cells`	指定範囲のセル値・コメントを読む
	`list_sheets`	ブックのシート名一覧を取得
調整して再比較する	`adjust`	比較条件（オプション・列/行の重み・ピン留め）を変えて比較し直す
開く・片付ける	`open_in_excel`	着色ブック・レポートを Excel で開く
開く・片付ける	`delete_work_folders`	作業用フォルダを一括削除（全フロント共通）

AI ならではの使い方

比較条件の対話チューニング

「この列を重視して」「この行とこの行は必ず対応させて」といった指示を、AI が列・行の重み付けやピン留め（対応の強制・禁止）に翻訳して再比較します。自動の対応付けが惜しいときに、狙いどおりの突き合わせへ対話で寄せていけます。

GUI・CLI の結果を深掘りする

GUI や CLI で実行した比較にも比較 ID が付いており、AI はその ID から結果を開いて再実行なしに詳細を調べられます。「さっき GUI で比較した結果、なぜこの行が余剰になったの？」という聞き方ができます。