メインコンテンツへスキップ

# 「仕訳登録して」と言わなくても動くようになった——Claude Agent SDKで作るマイエージェント、最初の一歩

    はじめに

    前回の記事で、こう書きました。

    「仕訳登録して」
    Claude Desktopにそう打ち込んだら、5件¥23,411分の仕訳がMoneyForwardに自動登録されていました。

    あれから1つ、ずっと気になっていることがありました。

    「仕訳登録して」という1行、まだ私が打っています。

    レシートをフォルダに入れる。それだけで翌朝には仕訳が終わっている。そういう世界はまだ先の話だと思っていました。

    Anthropicが公開しているAgent SDKを触り始めて、考えが変わりました——というより、正確には「考え方」の半分が変わりました。

    結論を先に書きます。今回実現したのは「逐次的に指示を出さなくても、目標を渡すだけでエージェントが自律的に計画・実行する」ことです。「Googleドライブを見て」「解析して」「登録して」と1工程ずつ指示する必要はなくなりました。

    一方で、「いつ動かすか」というトリガーは今回もまだ人間(私)が握っています。「仕訳登録して」という日本語の指示は不要になりましたが、代わりにターミナルでコマンドを1つ叩く必要があります。「レシートを入れておけば翌朝には終わっている」という完全無人化は、次回の記事で扱います。今回はその手前、「指示の中身」を自律化した記録です。

    これは、その記録です。


    前回との違い

    画像


    前回(MoneyForward×MCPサーバー自作) 今回(Agent SDK) 起動トリガー Claude Desktopに「仕訳登録して」と打つ ターミナルでコマンドを1つ実行する 判断 Claudeが逐次ツールを呼ぶ エージェントが自律的に計画・実行 スケジュール 手動実行 手動実行(自動実行は次回の記事で完成)

    起動するのはまだ私です。変わったのは「起動した後、何をどう判断するか」をエージェントに委ねられるようになったことです。


    Agent SDKとは何か——MCPとの違い

    前回の記事では、MCPサーバーを「委任状が必要な専用トンネル」と説明しました。Claudeから見えなかったGoogle DriveやMoneyForwardの世界に、「ここなら入ってもいいよ」という委任状付きの通路を開通させる役割です。

    この説明は今でも正しいです。でも今回、もう一歩踏み込んで言い換えます。

    MCPサーバーは「トンネル+道具箱」です。トンネルの向こうにある道具(Drive上のファイルを読む、MFに仕訳を登録する、など)を、Claudeが取り出して使えるようにする仕組み、という意味です。前回の記事では「Claudeに『仕訳登録して』と頼むと、Claudeが道具箱から必要な道具を順番に取り出して動かす」という形でした。でも『いつ』『どの順番で』使うかは、私が毎回Claude Desktopに口頭で指示していた、というのが前回までの状態です。

    Agent SDKは、ここから次の段階に進みます。

    「目標」だけ渡すと、エージェント自身が計画を立て、道具を選び、実行し、結果を判断して次の行動を決める。

    料理で言えば——

    • 前回(MCP):道具(包丁、フライパン)と材料がキッチンに揃っている状態。「包丁を取って」「フライパンを熱して」と1工程ずつ口頭で指示すれば料理できる

    • 今回(Agent SDK):そのキッチンに自分で考えて動く料理人を立たせる。「朝ごはんを作っておいて」と言って寝るだけで、あとは料理人が冷蔵庫を開け、メニューを決め、調理し、盛り付けまでやってくれる

    会計業務に当てはめると、「Googleドライブのレシートを確認して」「解析して」「登録して」と毎回指示するのではなく、ターミナルでコマンドを1つ叩けば、後は全部エージェントが判断して進める状態を今回実現します。「朝起きたら仕訳が終わっている」という完全無人化はまだ先(次回の記事)の話です。


    このシリーズで「何が」進化していくのか

    ここまで読んで、「で、結局それで私の作業はどう変わるの?」と思った方へ。正直にお答えします。

    今回だけを見ると、劇的に便利になったわけではありません。 むしろ、日本語で「仕訳登録して」と打つだけだった前回より、ターミナルでコマンドを叩く今回のほうが、一見ハードルは上がっています。

    それでもこれをやる理由は、「完全自動化」というゴールに必要な土台を、今回作っているからです。料理に例えると、こういう進化です。

    • 前回まで:道具と材料は揃ったキッチン。「包丁を取って」「フライパンを熱して」と1工程ずつ口頭で指示すれば料理ができる。便利だが、毎回キッチンに立って指示する必要がある。

    • 今回:そのキッチンに自分で考えて動く料理人を立たせる。「朝ごはん作っておいて」と一言渡せば、あとは料理人が冷蔵庫を開け、メニューを決め、調理し、盛り付ける。ただし料理人に声をかけるのはまだ自分です。

    • 次回:その料理人に、時間が来たら勝手に動き出すようにしてもらう。これで朝起きたら料理ができている=レシートを入れておけば翌朝には仕訳が終わっている、が完成する。

    つまり今回の本当の意味は、「人が逐一指示しないと動かないもの」から「目標だけ渡せば自律的に動くもの」へ作り変えたことです。次の段階で「人が話しかけなくても時間で動く」ようになると、完全無人化が完成します。

    なぜこれが重要かというと、「朝起きたら仕訳が終わっている」を実現するには、人間が介在しないキッカケ(トリガー)が必要だからです。チャットアプリは人が画面を開かないと動きません。でも独立したプログラム+自律的に判断するエージェントなら、時間が来たら勝手に動かせます。今回はその「勝手に動かせる形」に作り変えた、いわば完全自動化の一歩手前の回です。

    あわせて、今回は「飲食代で社外の人がいれば会議費」といった会計の判断ルールを、その都度指示するのではなく、あらかじめ書き込んで固定しました。これは将来、顧問先ごとにルールを変えたり、チームで同じ基準を共有したりするときの基盤になります。

    地味な回に見えるかもしれませんが、ここを通らないと「翌朝には終わっている」世界には辿り着けません。今回はその土台を、実際に手を動かして作り、コストまで測った記録です。


    Agent SDKと「課金」「これからのMF AI Cowork」の関係

    Agent SDKを触る前に、押さえておきたい2つの背景があります。

    ① 課金体系について(2026年6月17日時点)

    Anthropicは2026年6月15日に、「Agent SDK利用をサブスクリプション枠から切り離し、別枠の月額クレジット(Pro $20/Max 5x $100/Max 20x $200)に分ける」変更を予定していました。が、6月15日当日にこの変更は一時停止(paused)されました。Anthropic公式ヘルプセンターにも「現時点で何も変わっていません」と明記されており、Agent SDKの利用は引き続き各プランのサブスクリプション利用上限を使う形のままです。

    つまり「Agent SDKを動かすために月額別枠の課金が新たに発生する」ということは、現時点ではありません。Pro/Max等を使っている方は、これまでと同じ財布で動かせます。

    なお、本記事の後半(有料パート)で公開する実測コストは、サブスクリプション枠ではなくAnthropic ConsoleのAPIキー(従量課金)経由でAgent SDKを動かした実費です。これはサブスクリプション枠とは別の、利用量ごとに直接請求される独立した契約です。会計事務所での本番運用を見据えるなら、サブスクリプションとは別にAPI従量課金キーを持っておくのが現実的、という話も後半で具体的な金額付きで扱います。

    ② MoneyForwardの新サービス「MF AI Cowork」との関係

    2026年7月、MoneyForwardは新サービス「MF AI Cowork」をリリース予定です。これは経理・労務・法務の業務をMFクラウド内で自律実行させるサービスで、Claude Agent SDKをベースに構築されています。

    MF AI Coworkには、3種類のエージェントが用意される構造になっています。

    1. マネーフォワード提供エージェント — MoneyForward公式が用意する標準エージェント。仕訳チェック、月次レポート作成など、汎用的なタスクに対応します。設定するだけで動きます。

    2. サードパーティ提供エージェント — 外部ベンダーが開発したエージェントをマーケットプレイス的に選んで使う形態。会計事務所向け特化機能、業種別テンプレートなどが今後出てくると見込まれます。

    3. ユーザーが自作する「マイエージェント」 — 自分の事務所・顧問先固有のルールを組み込んだ、オリジナルのエージェント。ここがClaude Agent SDKの知識を直接活かせる領域です。

    3つ目の「マイエージェント」が、今回学ぶAgent SDKと直結します。マイエージェントを自作するには、Agent SDKでシステムプロンプトを書き、ツール(MCPサーバー)を呼び出し、判断ルールをコード化する技術が必要です。つまり今回agent_runner.pyを実装した経験は、そのままMF AI Coworkのマイエージェント開発スキルになります。

    「マネーフォワード提供エージェント」を使うだけの人と、「マイエージェント」を自分で設計して提供する側に回れる人で、これから先の立ち位置が大きく変わります。会計事務所が顧問先ごとに違う仕訳ルールを持っている以上、汎用エージェントだけで全部済むことはまずありません。自分で書ける、もしくは自分で書く外注先を選定・評価できる人が、AI時代の会計事務所には必要になります。

    私が今回作っているagent_runner.pyは、まさにその「マイエージェント」を非エンジニアが手を動かして作った最初の記録です。本記事はAI Cowork時代に「設計できる側」に回りたい人のための、最初の一歩の記録です。


    Before / After

    Before(前回の記事まで)

    毎回:
    1. Claude Desktopを開く
    2. 「仕訳登録して」と打つ
    3. 処理が終わるのを見届ける
    

    After(今回)

    ターミナルでコマンドを1つ実行する。
    (起動するのはまだ私です)
    
    あとはエージェントが自律的に:
      → Google Driveを確認
      → 未処理レシートを検出
      → OCRで内容を解析
      → 勘定科目を判断
      → MoneyForwardに仕訳登録
      → 完了ログを出力
    

    「仕訳登録して」と日本語で逐次指示する必要はなくなりましたが、起動のトリガーは依然として人間の操作です。「レシートを入れておけば翌朝には終わっている」という完全無人化(時間がトリガーになる状態)は、次回の記事で初めて実現します。


    実装の全体像

    前回作ったmf_mcp_server.py(4ツール)はそのまま使います。今回新たに作るのはエージェントの司令塔部分だけです。

    agent_runner.py(新規)
        ↓ 目標を渡す
    Agent SDK
        ↓ 自律的にツールを選んで呼び出す
    mf_mcp_server.py(前回の記事で作成済み)
        ├── list_drive_receipts
        ├── analyze_receipt
        ├── get_mf_accounts
        └── register_journal
    

    既存資産を活かした設計なので、実装量は思ったより少ないです。


    実際に動いた証拠

    📸 ①

    画像
    起動直後、AIが自律的にlist_drive_receiptsとget_mf_accountsを同時呼び出し。

    📸 ②

    画像
    5件のレシートをanalyze_receiptで全件同時並行解析。✅が5つ並ぶ。

    📸 ③

    画像
    確定仕訳2件・要確認3件に自律分類。MoneyForwardへの登録は未実施。

    📸 ④

    画像
    AIが会計的な曖昧さを自律検出し、確認事項を自分でリストアップ。

    「マイエージェント」を自作できる側に回るために

    冒頭で触れた通り、MF AI Coworkには3種類のエージェント(公式・サードパーティ・マイエージェント)が用意されます。汎用的な仕訳チェックや月次レポートは公式エージェントで足りるでしょう。でも、顧問先ごとに違う勘定科目運用、業種特有の取引パターン、事務所独自の判断ルール——こういった「公式エージェントでは届かない領域」は、マイエージェントを自作するしかありません。

    マイエージェントを自作できる人は、これから次のような立ち位置になります。

    • 自分の事務所のルールを完全に反映した、世界に1つしかない仕訳エージェントを持てる

    • 顧問先ごとに専用エージェントを用意して、付加価値サービスとして提供できる

    • AI Cowork時代に「使うだけ」ではなく「作って提供する」側に回れる

    そして、マイエージェントを自作するために必要な技術が、まさに今回のagent_runner.py実装そのものです。Agent SDKでシステムプロンプトを書き、MCPサーバーで道具を渡し、勘定科目の判断ルールをコード化する——この一連の流れを通しでやった経験は、MF AI Coworkのマイエージェント開発にそのまま転用できます。

    どちらが正解かではなく、どちらを選ぶかの話です。この記事は「マイエージェントを自分で設計できる側に回りたい」人のための記録です。


    この仕組みを作るのに使ったもの

    • Claude Agent SDK(claude-agent-sdk 0.2.101)

    • mf_mcp_server.py(前回の記事で実装したMCPサーバー4ツールをそのまま再利用)

    • Claude API(claude-sonnet-4-6モデル)

    • Python 3.11(Homebrew経由)

    • Google Drive API(レシートPDF取得)

    • MoneyForward クラウド会計API(OAuth2.0認証)

    • MacBook M4 MAX(ローカル実行環境)

    費用面:Claude API(従量課金)で、レシート5件処理1回あたり約$0.31(約45円)。3日間の実装・試行錯誤を含めた実測値は$1.18(agent-sdkキー)。詳細は有料パート「5. 課金体系の最新整理とコスト実測」で全公開しています。

    ※サブスクリプション枠(Pro/Max等)からAgent SDKを動かす場合の課金構造は2026年6月15日時点で動きがあり、最新情報も有料パート内で整理しています。



    このシリーズの今後の予定

    会計事務所職員×非エンジニアという視点で、クラウド会計×AI自動化の実装記録を連載しています。次回以降の記事候補です(順次公開予定)。

    ※各記事のタイトルは意図的に抽象化しています。具体的な技術名・ツール名・実装手段は有料パートに閉じ込めているため、記事タイトルだけでは「何を使って実現するか」はわかりません。これは先行者利益を守るためのポリシーです。中身は記事ごとにコード付きで全て公開します。

    〔自動化レベルアップ系〕

    • 朝起きたら仕訳が終わっている環境を作った

    • 「完全放置」で仕訳が終わる仕組みを作った

    • 複数の顧問先を同時に処理できるようにした

    • 他の人でも使えるようにWebで公開した

    〔エージェント設計・運用系〕

    • マネーフォワードの新サービスを使い倒してみた——会計事務所目線でレビュー

    • 公式エージェントと自作エージェントを比べてみた

    • 自作エージェントの設計ルールを文書化した

    • 自席を空けても仕訳が進む承認フローを設計した

    〔精度・コスト検証系〕

    • 有料APIとタダで動くAIのOCR精度を比較してみた

    • 自分のPCだけで完結する仕訳自動化を試してみた

    • AIモデルの選び方——会計事務所目線で比較した

    • AIエージェント基盤の選び方——会計事務所目線で比較した

    〔制度・実務対応系〕

    • インボイス番号の確認作業をなくした

    • 電子帳簿保存法の要件をAIで自動対応した

    • 消費税区分の判定をAIに任せたらどうなったか

    〔他ソフト対応系〕

    • シェアNo.1の別クラウド会計ソフトでも同じことをやってみた

    • APIがない会計ソフトでも自動化できた

    〔経理業務拡張系〕

    • 銀行明細・クレカ明細の自動仕訳を試した

    • 月次の数字の異常をAIに検知させた

    • 相続財産の書類整理をAIで自動化した

    • 顧問先からスマホで送ってもらったレシートを自動仕訳した

    〔税務シミュレーション系〕

    • 役員報酬の最適額をAIに計算させた

    • 節税対策をAIに提案させるアプリを作った

    • 簡易課税と原則課税どちらが有利かをAIに判定させた

    • 相続税申告のチェックリストをAI化した

    • 住宅ローン購入の判断材料をAIに整理させた

    • 法人・個人どちらで不動産を持つべきかAIに比較させた

    〔学習・資格系〕

    • AI関連の公式無料講座を全部受けてみた——会計職員の視点でレビュー

    • 会計×AIのキャリアに役立つ資格を取り続けた記録

    • クラウド系の公式資格を会計職員が取得してみた

    〔マネタイズ系〕

    • 作ったツールを売ってみた——受注から納品まで

    • 会計事務所向けサービスの価格設定をどう考えたか




    ここから先は有料パートです

    以下の内容を有料パートに収録しています。

    ▼ 有料パートの内容

    1. 環境構築(Agent SDK追加インストール手順)

    2. agent_runner.py 全コード(コメント付き完全掲載)

    3. システムプロンプトの書き方(勘定科目判断をどう委ねるか)

    4. つまずきポイント7選と解決策(←ここが最大の価値です)

    5. 課金体系の最新整理とコスト実測(3日間の実測値・月間試算付き)

    6. 次回予告:完全無人化への道

    非エンジニアが実際につまずいた箇所を全部書きました。「動かない」「エラーが出る」で詰まっている方、有料APIのコスト感をリアルな数字で知りたい方に、特に読んでいただきたい内容です。

    以上が無料パート全文です。

    このラインより上のエリアが無料で表示されます。

     
    会計事務所に約7年勤務→会計×AI自動化の道へ。プログラミング経験ゼロから、クラウド会計×AIの業務自動化ツールを独学で開発中。非エンジニアが実際に手を動かした記録を、つまずきポイントも含めてそのまま書きます。動くコードと、動かなかった記録。両方書きます。

    あなたへのおすすめ