メインコンテンツへスキップ
見出し画像

経理の"同僚"は、こう作った ― 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)

    Before(構想時点)After(v0.1.0)操作MFクラウドの画面をポチポチ自然言語の指示→仕訳登録まで完走(テスト仕訳#2)安全性AIの書き込みが怖くて任せられない読み=自動/書き=必ず人間承認のDraft & Approveが画面上で成立可視性AIが何をしたか分からない監査ログタブ+使用ツールのチップ表示で全実行が追跡可能\begin{array}{|l|l|l|} \hline \text{} & \text{Before(構想時点)} & \text{After(v0.1.0)} \\ \hline \text{操作} & \text{MFクラウドの画面をポチポチ} & \text{自然言語の指示→仕訳登録まで完走(テスト仕訳\#2)} \\ \hline \text{安全性} & \text{AIの書き込みが怖くて任せられない} & \text{読み=自動/書き=必ず人間承認のDraft \& Approveが画面上で成立} \\ \hline \text{可視性} & \text{AIが何をしたか分からない} & \text{監査ログタブ+使用ツールのチップ表示で全実行が追跡可能} \\ \hline \end{array}

    画像
    v0.1.0の実行画面全景

    🚀 実践内容

    ① アーキテクチャ: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分野に担当を分け、指示のキーワードで振り分ける。組織図としては、それらしく見えます。

    画像
    試作版(Artifact)の6エージェント選択UIの画面

    実用してみると、これがあっけなく破綻しました。現実の指示は、担当の境界をまたいで飛んでくるからです。「先月の経費を集計して、変な仕訳がないか確認して」は経費担当なのか仕訳担当なのかレポート担当なのか。キーワード振り分けは複数分野にまたがった瞬間に迷子になり、間違った担当に渡れば持っているツールが噛み合いません。

    v0.1.0で採用したのは、エージェントを分割せず、裏でHaikuが指示の意図を分類する方式です。カテゴリは仕訳/レポート/マスタ/明細/一般の5つ。分類結果に応じて、メインのSonnetに渡すツールセットを絞り込みます。ユーザーから見えるのは「1人のアシスタント」だけで、振り分けの失敗という概念そのものが消えました。

    軽量なHaikuに前処理をさせてメインモデルの仕事を軽くする分業は、コスト面でも理にかなっています。少なくとも今回の用途では、縦割りの6人より、文脈を読む1人でした。

    ③ Draft & Approveと監査ログ

    昨日の記事で、MCPコネクタの権限設定を「読み取り=常に許可・書き込み=承認必須」にした話を書きました。今回のアプリは、同じ思想をアプリ側で実装したものです。

    書き込み系(仕訳登録など)の指示を受けると、アシスタントはまず登録内容の下書きを整形して提示し、承認ボタンを待ちます。人間が「承認」を押して初めて、postJournals系のツールが実行される。実行されたツールはすべてチップ表示され、監査ログタブに時系列で残り、履歴はエクスポートもできます。

    実際にテスト仕訳(借方=消耗品費・貸方=現金の100円)を登録したときの画面では、「承認済み: 書き込みを実行しました」→仕訳番号#2の登録結果、と流れが一目で追えました。

    画像
    「承認済み: 書き込みを実行しました」〜仕訳登録結果(仕訳番号#2)の実画面

    AIに帳簿を触らせる不安の正体は「何をされたか分からないこと」なので、承認と可視化をセットで作るのが効きます。


    ⚠️ つまずきポイントと解決策

    • 仕訳登録で貸借バランスのエラーが発生 → 犯人はMFクラウド会計の仕訳APIの仕様で、金額欄 `value` には税抜金額を指定します。税込110円の現金払いなら、借方・貸方とも税抜100円で統一して登録(消費税10円はシステム側が自動計算)。仕様書より先にエラーが教えてくれました

    • レート制限メーターが真っ赤に → 会計ツールの応答(勘定科目一覧など)は大きく、直近60秒の入力トークンが67,687/30,000と制限を大きく超える場面がありました。キャッシュ読取(この日の表示で8,588)を活かしつつ、ツール応答の間引きや呼び出し頻度の設計が必要です

    画像
    レート制限メーターが真っ赤(67,687/30,000)になっている画面
    • 1回の指示で複数ツールが連鎖する(辞書→事業者→勘定科目→税区分→仕訳登録…)→ トークン消費が想像以上に膨らむ前提で、モデルの使い分け(分類はHaiku)と履歴管理を設計する

    • 複数事業者の扱い → MCP側の仕様どおり、事業者を切り替えるならセッションを分ける設計が前提(昨日の記事参照)


    💡 応用例

    • 月次ルーティンの定型化: 「前月の試算表を要約して」「未仕訳の明細を一覧にして」を同僚への依頼のように投げる

    • 仕訳チェックの相棒: 登録は人間承認前提のまま、下書き作成とダブルチェックをAIに寄せる

    • 権限設計の型として: 「読み=自動・書き=承認」は、会計に限らずAIに実データを触らせるアプリ全般で使い回せる設計パターン

    • なお本アプリは、α版としての公開(GitHubでのコード共有)を準備中です。設定の外出し(APIキー・MCP接続先を各自で設定できる形)を整えてからになるので、続報をお待ちください


    🔗 関連記事

    今回の内容に関連する過去記事もぜひご覧ください:


    📝 まとめ

    • 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で控えめに配置(右下ではない)
    ・全体の雰囲気:開発の試行錯誤を乗り越えた達成感と、設計図の美しさが伝わる明るい仕上がり
     
     
    生成AIの感動を共有したいYaroTechです✨ 常識より実験。正解より行動。 生成AI時代を、先に試す傾奇者。 📝 470日間継続投稿中| 🎉 フォロワー1900名突破!🤝 質問大歓迎!みんなで「AIと共に羽ばたく」コミュニティを作りましょう🚀

    あなたへのおすすめ