Claude Code×freee-mcp 申告準備DX実装ガイド 2026:資料整理/仕訳/チェックの効率化
申告準備の煩雑さに終止符を。Claude Codeとfreee-mcpが連携し、資料整理から仕訳作成、チェックまでAIで自動化・高度化。業務効率を劇的に向上させ、ミスを削減する次世代の申告フローを設計します。
目次 クリックで開く
法人決算や確定申告の準備において、経理実務者が直面する最大の壁は「散在する資料の整理」と「膨大な仕訳の整合性チェック」です。本稿では、Anthropicが提供するエンジニア向けCLIツールClaude Codeと、会計ソフトfreeeを接続するfreee-mcpを活用し、これらを手作業から解放する次世代のアーキテクチャを解説します。
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 アプリケーションの登録
freee 公式の MCP サーバー freee-mcp の README(github.com/freee/freee-mcp)は、freee が提供する Remote MCP サーバーに接続する方法(推奨)と、自分で登録した freee アプリケーションの認証情報を使ってローカルで MCP サーバーを起動する方法の2つを載せています。ここではローカルで起動する手順を、README のとおりに示します。まず、freee アプリストアで新しいアプリを作成します。
- コールバックURL:
http://127.0.0.1:54321/callback - Client ID と Client Secret を取得
- 必要な権限にチェック
Step 2:Claude Codeのインストールと初期設定
Node.js環境下で以下のコマンドを実行し、Claude Codeをインストールします。
npm install -g @anthropic-ai/claude-code
初回起動時に claude auth コマンドでAnthropicアカウントとの認証を行います。
Step 3:freee-mcpサーバーの構築と設定ファイルの記述
次のコマンドを実行します。対話式ウィザードが認証情報の設定、OAuth認証、事業所選択を行います。
npx freee-mcp configure
設定ファイルの記述(README の例)
configure が出力する設定を、Claude Desktop の設定ファイルに追加します。README は、その他の MCP クライアントでは同じ command と args をそれぞれの MCP 設定に追加するよう書いています。
{
"mcpServers": {
"freee": {
"command": "npx",
"args": ["freee-mcp"]
}
}
}
なお Claude Code では、プラグインとしてインストールすると、freee の Remote MCP サーバー(https://mcp.freee.co.jp/mcp)と Agent Skills がまとめて使え、ローカルでのセットアップは要りません(README)。次の2つのコマンドを順に実行し、インストール後に /mcp で freee サーバーを選んで、ブラウザで freee にログインして認証します。ただし、プラグインにはローカルの MCP サーバー(freee-mcp、freee-sign-mcp)は含まれません。freee サイン(電子契約)を使う場合や、自分で登録した freee アプリケーションで接続する場合は、Step 1〜3 のローカルの手順を使います(README)。
claude plugin marketplace add freee/freee-mcp
claude plugin install freee-mcp@freee-mcp-marketplace
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連携の特性を比較表にまとめました。
| 比較項目 | RPA(汎用ツール) | 会計ソフト標準機能 | Claude Code × MCP |
|---|---|---|---|
| 導入コスト | 高(ライセンス+開発) | 低(標準月額内) | 中(API消費従量課金) |
| 対応の柔軟性 | 中(定義が必要) | 低(機能の範囲内) | 極めて高い(自然言語で指示) |
| 処理速度 | 中(画面操作を伴う) | 高(システム内処理) | 高(API直接駆動) |
| エラー復旧 | 困難(止まる) | 手動修正が必要 | 容易(AIが原因分析し修正) |
例えば、複雑なCSVの加工が必要な場合は、以下のガイドも参考にしてください。
関連記事:楽楽精算×freee会計の「CSV手作業」を滅ぼす。経理の完全自動化とアーキテクチャ
トラブルシューティングと運用上の留意点
実務で運用する上で避けて通れないのが、APIの制約とセキュリティです。
APIのレートリミット(429 Too Many Requests)対策
freee APIには一定時間あたりのリクエスト上限があります。大量の仕訳を一度に流し込むと 429 Error が発生します。Claude Codeに指示を出す際は、「100件ごとに5秒の待機時間を設けて実行して」と条件を付けることで、この制限を回避できます。
- 参考数値:freee APIのレートリミットは、エンドポイントごとに異なりますが、一般的に1分間に数十件〜数百件程度です。詳細は公式ヘルプを確認してください。
データセキュリティとプライバシー保護の設定
AIに財務データを送る際、機密情報の漏洩を懸念される場合があります。使っている Claude のプランで、入力したデータが学習に使われるかどうかを、Anthropic のプライバシーの設定と規約で確かめてください。また、Client Secret やアクセストークンをコード内に直書きしないでください。
このような高度なAPI連携による自動化は、単なるツールの導入ではなく、会計データのアーキテクチャ設計そのものです。
関連記事:【完全版・第5回】freee会計の「経営可視化・高度連携」フェーズ。会計データを羅針盤に変えるBIとAPI連携術
申告準備の完全自動化へ
Claude Codeとfreee-mcpの連携は、経理業務を「作業」から「管理」へとシフトさせます。最新のAPI活用やシステム連携に関するご相談は、以下のボタンよりお問い合わせください。
よくある質問(Claude Code × freee MCP 申告準備DX)
Q. Claude Codeとfreee MCPを連携して申告準備を自動化するとは具体的に何ができますか?
freee MCP(Model Context Protocol対応のAPIサーバー)をClaude Codeから呼び出すことで、①freeeの仕訳データや取引データをClaude Codeで読み込んで分析・集計②「先月の売上と経費の内訳を確認して」などの自然言語指示で帳票確認③freee上のデータを基にした申告書類作成補助などが実現できます。ただし税務申告への最終確認は税理士・会計士への確認が必要です。
Q. freee MCP連携でfreeeのデータは安全に扱えますか?
安全のためにいくつかの設定が重要です。①Claude Codeのpermissions設定でfreee APIの書き込み操作(仕訳作成・削除)を制限して読み取り専用にする②freee APIのOAuth認証で最小権限スコープを使用する③Claude CodeのTeam・Enterpriseプランでは入力データが学習に使われないことが保証されています。認証情報(Client Secret・OAuthトークン)はコードに直書きしないでください。
Q. Claude Code×freee MCP連携の導入に必要な技術スキルは?
最低限必要なスキルはfreee APIの認証設定(OAuth 2.0)とClaude Codeのインストール・MCP設定(settings.jsonへのMCPサーバー追記)です。Pythonやノード.jsの基礎知識があると自前のMCPサーバー構築やカスタマイズが可能です。freee 公式の MCP サーバー(freee-mcp)を使う場合は、公式の README の手順に沿えばセットアップできます。Aurantでは初期構築・セキュリティ設計のサポートを提供しています。
経理・会計DXと仕訳/請求/債権自動化のご相談
仕訳・請求・入金消込・債権管理といった経理業務の自動化と、会計データの可視化までを一気通貫で支援します。ツール選定や既存運用の見直しについて、導入前後のセカンドオピニオンとしてもご相談いただけます。
📚 関連資料
このトピックについて、より詳しく学びたい方は以下の無料資料をご参照ください:
導入前に確認すべき技術的・運用的チェックリスト
Claude Codeとfreee-mcpを実務に投入する前に、以下の3つのポイントを必ず確認してください。特に認証周りの仕様を誤解すると、予期せぬ実行エラーで業務が止まるリスクがあります。
- アクセストークンの有効期限と再発行:freee APIのアクセストークンには有効期限があります。CLI環境で長時間作業する場合、リフレッシュトークンによる更新処理が適切に行われているか、または有効期限が切れていないかを確認してください。
- 認可範囲(スコープ)の最小権限:セキュリティの観点から、まずは
read権限のみでチェック機能を試用し、仕訳の自動生成(write)を行う際のみ権限を昇格させる運用を推奨します。 - API消費コストの要確認:Claude Code自体の利用料に加え、AnthropicのAPI(Sonnet 5等)のトークン消費課金が発生します。大量のPDFをOCR処理し、複雑な推論を繰り返す場合は、コストが膨らむ可能性があるため、少量のデータからテストを開始してください。
AIによる会計処理の「限界」と責任分解
AIは極めて高い精度で仕訳を提案しますが、税務判断の最終責任は人間(または税理士)にあります。特に「按分比率の妥当性」や「インボイス制度の登録番号の有効性」については、AIの出力を鵜呑みにせず、必ずサンプリングチェックを行う工程をフローに組み込んでください。こうした設計思想は、SFA・CRM・MA・Webの違いを解説した「データ連携の全体設計図」における責務分解の考え方と共通しています。
主要なリソースと公式ドキュメント
実装の詳細や最新のAPI仕様については、以下の公式サイトを随時参照してください。特にMCPサーバーの仕様は更新が早いため、GitHubのリポジトリを直接確認することをお勧めします。
| リソース名 | URL / 参照先 | 確認すべき内容 |
|---|---|---|
| freee API リファレンス | developer.freee.co.jp/docs | 各エンドポイントのレートリミット、必須パラメータ |
| Anthropic MCP 公式ドキュメント | modelcontextprotocol.io | MCPサーバーのプロトコル仕様、設定ファイルの書き方 |
| freee-mcp (GitHub) | github.com/freee/freee-mcp | 最新の対応リソース(取引、事業所、勘定科目など) |
もし、既存の会計ソフトからの移行を含めた全体的なDXを検討されている場合は、勘定奉行からfreee会計への移行ガイドも併せて参照し、データ構造の差異を把握しておくと、AIへの指示出し(プロンプト)がより的確になります。
Claude Code 導入支援
領収書・請求書の読み取りから記帳・仕訳、Excel の集計まで。freee・マネーフォワード・バクラク・勘定奉行などと MCP でつなぐときは、AI に渡す情報・権限・操作を絞り、承認と操作ログを残す形で導入します。




