Claude Code×freee-mcpで実現する申告準備DX：AIが資料整理・仕訳・チェックを劇的効率化

法人決算や確定申告の準備において、経理実務者が直面する最大の壁は「散在する資料の整理」と「膨大な仕訳の整合性チェック」です。本稿では、Anthropicが提供するエンジニア向けCLIツールClaude Codeと、会計ソフトfreeeを接続するfreee-mcpを活用し、これらを手作業から解放する次世代のアーキテクチャを解説します。

Claude Codeとfreee-mcpを組み合わせた申告準備アーキテクチャ

従来のAI活用は、ブラウザにデータをコピペして回答を得る「点」の作業でした。しかし、Claude CodeとMCP（Model Context Protocol）を組み合わせることで、AIが直接会計データにアクセスし、実行可能なコードを生成・適用する「線」の自動化が可能になります。

MCP（Model Context Protocol）が変える会計実務のインターフェース

MCPは、AIモデルが外部ツールやデータソース（この場合はfreee API）と対話するための共通規格です。これにより、Claude Codeは「freeeから直近1ヶ月の旅費交通費を抽出して、インボイス登録番号がないものをリストアップして」という自然言語の指示を、即座にAPIリクエストへと変換します。

なぜVS Codeやブラウザではなく「Claude Code（CLI）」なのか

GUIツールとの決定的な違いは、「ローカルファイルとクラウドAPIの同時操作性」にあります。例えば、ローカルにある大量の請求書PDF（OCR結果）を読み取りながら、freee上のマスタ情報と照らし合わせ、不一致があればその場で修正コードを書いて実行する、といった一連のプロセスがターミナル上で完結します。

実務導入ステップ：環境構築からAPI連携まで

実際にこの環境を構築するための、具体的かつ公式情報に基づいた手順を解説します。

Step 1：freee APIの認可設定とアクセストークンの取得

まず、freeeアプリストアの「開発者マイページ」にて、アプリケーションを作成します。

• 【公式URL】freee Developers Community
• 必要なスコープ：read（参照）、write（更新）の「会計」権限

Step 2：Claude Codeのインストールと初期設定

Node.js環境下で以下のコマンドを実行し、Claude Codeをインストールします。

npm install -g @anthropic-ai/claude-code

初回起動時に claude auth コマンドでAnthropicアカウントとの認証を行います。

Step 3：freee-mcpサーバーの構築と設定ファイルの記述

Claude Codeにfreeeを認識させるため、claude_desktop_config.json（またはMCP設定ファイル）に以下の定義を追加します。

config.jsonの具体的な記述テンプレート

{
"mcpServers": {
"freee": {
"command": "npx",
"args": ["-y", "@freee/mcp-server"],
"env": {
"FREEE_ACCESS_TOKEN": "あなたのアクセストークン"
}
}
}
}

AIによる申告準備DXの具体的事例と手順

環境が整ったら、具体的な実務タスクをAIに委ねます。ここでは、ミスの許されない申告準備において特に有効な3つのユースケースを紹介します。

証憑データの構造化と自動仕訳提案

「このフォルダにあるPDFの金額と日付を読み取り、freeeの取引明細と照合して、未登録のものだけ推論仕訳を作成して」というプロンプトを実行します。AIはOCRエンジンと連携し、構造化されていないデータから会計的な「取引」を復元します。

勘定科目・タグの整合性チェックと自動修正

過去の仕訳パターンを学習したAIが、「旅費交通費」の中に「接待交際費」に該当するものが混入していないかをスキャンします。特に、税務調査の対象になりやすい交際費の5,000円基準や、役員賞与認定リスクのある支出を重点的にチェックさせることが可能です。

関連記事：【完全版・第4回】freee会計の「月次業務」フェーズ。給与連携・月次締めを爆速化し、決算の精度を高める手順

前受金・前払費用の期間按分計算の自動生成

SaaS利用料などの前払費用について、契約期間を元に月次按分仕訳を自動生成します。Claude Codeは計算ロジック（Pythonスクリプト等）をその場で書き、freeeの振替伝票APIを叩いて反映させます。

主要な会計DXツールとClaude Codeの比較

既存の自動化ツールと、Claude Codeを用いたMCP連携の特性を比較表にまとめました。

例えば、複雑なCSVの加工が必要な場合は、以下のガイドも参考にしてください。

関連記事：楽楽精算×freee会計の「CSV手作業」を滅ぼす。経理の完全自動化とアーキテクチャ

トラブルシューティングと運用上の留意点

実務で運用する上で避けて通れないのが、APIの制約とセキュリティです。

APIのレートリミット（429 Too Many Requests）対策

freee APIには一定時間あたりのリクエスト上限があります。大量の仕訳を一度に流し込むと 429 Error が発生します。Claude Codeに指示を出す際は、「100件ごとに5秒の待機時間を設けて実行して」と条件を付けることで、この制限を回避できます。

• 参考数値：freee APIのレートリミットは、エンドポイントごとに異なりますが、一般的に1分間に数十件〜数百件程度です。詳細は公式ヘルプを確認してください。

データセキュリティとプライバシー保護の設定

AIに財務データを送る際、機密情報の漏洩を懸念される場合があります。Claude Codeの設定（config.json）で、トレーニングへの利用をオフにする設定を必ず有効にしてください。また、アクセストークンは環境変数に格納し、コード内にハードコードしないのが鉄則です。

このような高度なAPI連携による自動化は、単なるツールの導入ではなく、会計データのアーキテクチャ設計そのものです。

関連記事：【完全版・第5回】freee会計の「経営可視化・高度連携」フェーズ。会計データを羅針盤に変えるBIとAPI連携術