WebMCP - AIエージェント連携
WebMCPとは
e-shiwake は WebMCP（Web Model Context Protocol）に対応しています。WebMCP を使うと、AIエージェントがブラウザ上の e-shiwake に直接アクセスし、仕訳の検索・作成・帳簿の生成などを実行できます。
WebMCP は W3C で標準化が進められているブラウザAPIです。Webアプリが navigator.modelContext.registerTool() でツールを登録すると、AIエージェント（Chrome内蔵AIなど）がそのツールを認識・実行できるようになります。
従来のスクリーンショットベースの操作と比べて、トークン使用量が約89%削減され、高速かつ正確な操作が可能です。
前提条件
- Chrome 146 以上をインストール（2026年3月安定版リリース予定）
chrome://flags→「WebMCP for testing」を Enabled に設定- ブラウザ再起動後、e-shiwake を開く
Chrome 拡張「Model Context Tool Inspector」をインストールすると、サイドパネルからツールを直接実行できます。
ツール概要
e-shiwake は起動時に 17個のツール を自動登録します。データ操作型（12個）とUI操作型（5個）の2種類があります。
| 種別 | ツール数 | 説明 |
|---|---|---|
| データ操作型 | 12個 | データの読み書きを直接実行（検索、作成、削除、帳簿生成） |
| UI操作型 | 5個 | UIを操作してユーザーに確認させる（フォーム表示、ナビゲーション、削除確認） |
UI操作型ツールは Human-in-the-Loop パターンです。AIがフォームをプリフィルし、ユーザーが内容を確認してから確定します。
データ操作型ツール
仕訳管理
| ツール名 | 用途 | 主な引数 |
|---|---|---|
| search_journals | 仕訳検索（全年度横断） | query, fiscalYear? |
| get_journals_by_year | 年度別仕訳取得 | year |
| create_journal | 仕訳作成 | date, description, debitLines, creditLines |
| delete_journal | 仕訳削除 | id |
マスタ参照
| ツール名 | 用途 | 主な引数 |
|---|---|---|
| list_accounts | 勘定科目一覧 | type? |
| list_vendors | 取引先一覧 | query? |
帳簿生成
| ツール名 | 用途 | 主な引数 |
|---|---|---|
| generate_ledger | 総勘定元帳 | accountCode, fiscalYear |
| generate_trial_balance | 試算表 | fiscalYear |
| generate_profit_loss | 損益計算書 | fiscalYear |
| generate_balance_sheet | 貸借対照表 | fiscalYear |
税務・ユーティリティ
| ツール名 | 用途 | 主な引数 |
|---|---|---|
| calculate_consumption_tax | 消費税集計 | fiscalYear |
| get_available_years | 年度一覧 | （引数なし） |
UI操作型ツール
AIがUIを操作し、ユーザーが確認・確定するパターンです。
| ツール名 | 用途 | 主な引数 |
|---|---|---|
| navigate_to | ページ遷移 | page |
| open_journal_editor | 仕訳入力フォームをプリフィルして表示 | date?, description?, vendor?, debitLines?, creditLines? |
| set_search_query | 検索クエリをセット | query |
| confirm_delete_journal | 仕訳の削除確認ダイアログを表示 | journalId |
| open_invoice_editor | 請求書エディタをプリフィルして表示 | invoiceId, vendorId?, dueDate?, items? |
UI操作型ツールは直接データを変更しません。AIがフォームに値を入力し、ユーザーが確認して「確定」ボタンを押すまで保存されません。
仕訳の例
基本的な仕訳
電車代1,200円を現金で支払い：
create_journal({
date: "2026-02-22",
description: "電車代",
debitLines: [{accountCode: "5005", amount: 1200, taxCategory: "na"}],
creditLines: [{accountCode: "1001", amount: 1200, taxCategory: "na"}]
})消費税あり
Amazonで事務用品3,980円をクレジットカードで購入：
create_journal({
date: "2026-02-22",
description: "USBケーブル購入",
vendor: "Amazon",
debitLines: [{accountCode: "5011", amount: 3980, taxCategory: "purchase_10"}],
creditLines: [{accountCode: "2002", amount: 3980, taxCategory: "na"}]
})家事按分（複合仕訳）
携帯電話代10,000円（事業80%、家事20%）：
create_journal({
date: "2026-02-20",
description: "携帯電話代",
vendor: "NTTドコモ",
debitLines: [
{accountCode: "5006", amount: 8000, taxCategory: "purchase_10"},
{accountCode: "3002", amount: 2000, taxCategory: "na"}
],
creditLines: [{accountCode: "1003", amount: 10000, taxCategory: "na"}]
})消費税区分
| コード | 名称 | 用途 |
|---|---|---|
| sales_10 | 課税売上10% | 通常の売上 |
| sales_8 | 課税売上8% | 軽減税率対象の売上 |
| purchase_10 | 課税仕入10% | 通常の経費 |
| purchase_8 | 課税仕入8% | 軽減税率対象の仕入（書籍等） |
| exempt | 非課税 | 土地賃借料、社会保険料等 |
| out_of_scope | 不課税 | 給与、配当金等 |
| na | 対象外 | 事業主勘定、現金・預金の増減等 |
動作確認
e-shiwake を開いた状態でブラウザの DevTools Console を確認してください。WebMCPが有効な環境では以下のログが表示されます：
[e-shiwake] WebMCP: 17 ツールをAIエージェントに公開しましたWebMCPが無効な環境では、以下のメッセージが表示されます（アプリの動作に影響はありません）：
[e-shiwake WebMCP] navigator.modelContext が利用できません。WebMCP は無効です。