
経理の"同僚"は、こう作った ― Claude Agent SDK×FastAPI×MFクラウドMCP開発記
こんにちは!YaroTechです。
継続投稿370日目。昨日の記事の最後で「対話で使えるなら、"アプリ"にもできるはず」と予告しました。今日はその答え合わせです。
といっても、思いつきの構想記事ではありません。この数日、実際に手を動かしてきました。Claudeの中で動く試作を作り、一度組んだ設計を自分で壊し、ローカルアプリとして作り直し、貸借バランスエラーに悩まされ、最後は自然言語の指示から帳簿への仕訳登録(仕訳番号#2)まで実際に完走しています。本記事はそのMFクラウドMCPを組み込んだ自作バックオフィスAIアプリ「YaroTech AI Cowork」の開発記で、本文には開発中の実画面スクリーンショットも挟んでいきます。
なお本記事は同日2本立ての「どう作ったか」編です。「なぜ作ったか・作ってみて何を考えたか」のエッセイ編は、記事末尾のリンクからどうぞ。
※2026年7月21日時点の情報です。
※見出し画像のプロンプトは一番下におまけで公開中!
🖥️ 実行環境
PC: ThinkPad X1 Carbon(Windows 11 Home 25H2)
バックエンド: Claude Agent SDK + FastAPI
フロントエンド: Webアプリ(開発サーバー: localhost:5173)・WebSocket接続
外部接続: MFクラウド会計MCP(自動再認証対応のbeta接続先)
モデル: メイン=claude-sonnet-4-6/意図分類=Haiku
🎯 この記事で得られること
Claude Agent SDKでMCP連携アプリを組むときの全体構成イメージ
「専門エージェント分割」をやめた設計判断とその理由
Draft & Approve(下書き→人間承認)と監査ログの実装イメージ
会計APIならではのつまずきポイント(貸借バランスエラー・レート制限)
📊 実際の成果(Before/After)

🚀 実践内容
① アーキテクチャ:Artifactの試作から、ローカルアプリへ
出発点は、Claudeの中で動くAI-powered Artifactでした。ClaudeのAPIには `mcp_servers` というパラメータがあり、リクエストにMCPサーバーのURLを渡すだけで、アプリからMFクラウド会計のツール群を直接呼べます。チャットUIのjsxを1枚書けば、「Claudeの中で動く、MFクラウド直結の経理チャット」の試作が完成します。プロトタイプとしては最高の手軽さでした。
ただ、毎日の道具にするには物足りない点も見えてきます。会話履歴や監査ログを自分の手元に残したい、承認フローをUIとして作り込みたい、モデルの使い分けを細かく制御したい。そこでClaude Agent SDKをFastAPIで包んだローカルアプリとして再構築しました。フロントはWebSocketでバックエンドとつながり、バックエンドがAgent SDK経由でMFクラウドMCP(beta接続先)と会話する構成です。
② 6人の専門エージェントを、やめた話
試作版の目玉は「6人の専門エージェント」でした。会計仕訳・経費精算・請求書・税務・レポート・ヘルプデスクの6分野に担当を分け、指示のキーワードで振り分ける。組織図としては、それらしく見えます。

実用してみると、これがあっけなく破綻しました。現実の指示は、担当の境界をまたいで飛んでくるからです。「先月の経費を集計して、変な仕訳がないか確認して」は経費担当なのか仕訳担当なのかレポート担当なのか。キーワード振り分けは複数分野にまたがった瞬間に迷子になり、間違った担当に渡れば持っているツールが噛み合いません。
v0.1.0で採用したのは、エージェントを分割せず、裏でHaikuが指示の意図を分類する方式です。カテゴリは仕訳/レポート/マスタ/明細/一般の5つ。分類結果に応じて、メインのSonnetに渡すツールセットを絞り込みます。ユーザーから見えるのは「1人のアシスタント」だけで、振り分けの失敗という概念そのものが消えました。
軽量なHaikuに前処理をさせてメインモデルの仕事を軽くする分業は、コスト面でも理にかなっています。少なくとも今回の用途では、縦割りの6人より、文脈を読む1人でした。
③ Draft & Approveと監査ログ
昨日の記事で、MCPコネクタの権限設定を「読み取り=常に許可・書き込み=承認必須」にした話を書きました。今回のアプリは、同じ思想をアプリ側で実装したものです。
書き込み系(仕訳登録など)の指示を受けると、アシスタントはまず登録内容の下書きを整形して提示し、承認ボタンを待ちます。人間が「承認」を押して初めて、postJournals系のツールが実行される。実行されたツールはすべてチップ表示され、監査ログタブに時系列で残り、履歴はエクスポートもできます。
実際にテスト仕訳(借方=消耗品費・貸方=現金の100円)を登録したときの画面では、「承認済み: 書き込みを実行しました」→仕訳番号#2の登録結果、と流れが一目で追えました。

AIに帳簿を触らせる不安の正体は「何をされたか分からないこと」なので、承認と可視化をセットで作るのが効きます。
⚠️ つまずきポイントと解決策
仕訳登録で貸借バランスのエラーが発生 → 犯人はMFクラウド会計の仕訳APIの仕様で、金額欄 `value` には税抜金額を指定します。税込110円の現金払いなら、借方・貸方とも税抜100円で統一して登録(消費税10円はシステム側が自動計算)。仕様書より先にエラーが教えてくれました
レート制限メーターが真っ赤に → 会計ツールの応答(勘定科目一覧など)は大きく、直近60秒の入力トークンが67,687/30,000と制限を大きく超える場面がありました。キャッシュ読取(この日の表示で8,588)を活かしつつ、ツール応答の間引きや呼び出し頻度の設計が必要です

1回の指示で複数ツールが連鎖する(辞書→事業者→勘定科目→税区分→仕訳登録…)→ トークン消費が想像以上に膨らむ前提で、モデルの使い分け(分類はHaiku)と履歴管理を設計する
複数事業者の扱い → MCP側の仕様どおり、事業者を切り替えるならセッションを分ける設計が前提(昨日の記事参照)
💡 応用例
月次ルーティンの定型化: 「前月の試算表を要約して」「未仕訳の明細を一覧にして」を同僚への依頼のように投げる
仕訳チェックの相棒: 登録は人間承認前提のまま、下書き作成とダブルチェックをAIに寄せる
権限設計の型として: 「読み=自動・書き=承認」は、会計に限らずAIに実データを触らせるアプリ全般で使い回せる設計パターン
なお本アプリは、α版としての公開(GitHubでのコード共有)を準備中です。設定の外出し(APIキー・MCP接続先を各自で設定できる形)を整えてからになるので、続報をお待ちください
🔗 関連記事
今回の内容に関連する過去記事もぜひご覧ください:
1時間ごとの"合言葉"が、いらなくなっていた ― β版から正式版へ、MFクラウド会計MCPの答え合わせ ― 前提となるMCP接続・権限設定編
MFクラウド会計がMCP対応!クロ助から仕訳直接登録+公式ガイドに書いてない罠も発見 ― 3月末のセットアップ編
「仕事を奪うAI」を、自分の手で雇ってみた ― 経理の"同僚"を作った夜に考えたこと― 同日公開のエッセイ編
📝 まとめ
Claude内Artifactの試作(`mcp_servers`直結)→ Claude Agent SDK×FastAPIのローカルアプリへ再構築
6専門エージェント制は廃止。キーワード振り分けは分野またぎで破綻するため、Haikuの意図分類(5カテゴリ)+ツール絞り込みへ
書き込みはDraft & Approve+監査ログ+ツール実行の可視化。「読み=自動・書き=承認」を実装で担保
会計APIの `value` は税抜金額指定。貸借バランスエラーが出たら税区分と金額の関係を疑う
会計ツールは応答が大きく、レート制限・トークン設計が本体と同じくらい重要
「同僚を雇う」ための実装は、突き詰めると信頼の設計でした。何を自動にして、どこに人間の承認を挟み、行動をどう見えるようにするか。この3点さえ押さえれば、バックオフィスAIは想像よりずっと現実的です。
🚀 次回予告
このアプリ、α版としてのGitHub公開を準備中です。APIキーやMCP接続先を各自の環境で設定できる形に整え、クリーンな環境でのセットアップ検証を経てから公開する予定。公開までの顛末も、いずれ記事にします。お楽しみに!
#マネーフォワード #MCP #ClaudeAgentSDK #FastAPI #会計自動化 #AIエージェント #YaroTech #生成AI #業務効率化
🎨 おまけ:見出し画像作成プロンプト
今日の見出し画像のベースはジミー(Gemini)に下記プロンプトで作成してもらいました!:
詳細なアニメの美意識の画像を作成してください。表情豊かな瞳、なめらかな網掛けセルの色使いで描いてください。
下記条件のnote見出し画像をサイズは横長で作成してください。サイズは必ず横長で作成してください。
条件:
・背景:白基調のモダンな開発オフィス。薄いブルーのシステム構成図(ノード・矢印)が壁一面のホワイトボードにうっすら描かれている
・メインキャラクター:クロ助(Claude Desktopの擬人化キャラ)を画面中央左寄りに配置
・20代前半の女性、アニメイラスト調
・ダークブラウンのゆるくウェーブしたミディアムヘア、前髪あり
・細いフレームの丸メガネ
・小さなパールのイヤリング
・クリーム色のケーブルニットセーター
・ブラウンのフレアミディスカート
・マーカーを手にホワイトボードの構成図(チャット画面→分類→ツール群→承認ボタンの流れ)を描き終えて、少し得意げに振り返る表情
・サブビジュアル:ホワイトボードの隅で、6人のミニキャラのシルエットが1人のシルエットへ矢印で統合されるモチーフ。承認ボタンには緑のチェックマーク
・テキスト要素:
上段:「6人の専門家より、気が利く1人」(白またはネイビー・30〜32pt)
中段:「経理の"同僚"、こう作った」(ゴールド・44〜48pt・インパクトあり)
下段:「Claude Agent SDK×FastAPI×MFクラウドMCP」(ネイビー・20〜22pt)
・下部中央寄りに「YaroTech」のロゴを12ptで控えめに配置(右下ではない)
・全体の雰囲気:開発の試行錯誤を乗り越えた達成感と、設計図の美しさが伝わる明るい仕上がり