Claudeでマネーフォワード クラウド会計の仕訳をチェックする — 指示文とスコープ設計
マネーフォワード クラウド会計のMCPサーバーを使い、Claudeで仕訳のチェックや月次決算前の確認を進める手順です。指示文の書き方と権限設計の注意点をまとめます。
Claudeでマネーフォワードの仕訳をチェックするとは
マネーフォワード クラウド会計とClaudeを接続する基本的な設定はClaudeマネーフォワード連携 — 2つの接続方法と設定手順で扱いました。本記事はその先、接続したあとに仕訳を実際にどうチェックさせるかに絞って手順を確認します。
仕訳チェックとは、Claudeにマネーフォワード クラウド会計のデータを読み込ませ、税区分の誤りや重複登録、放置された仮払金・仮受金といった「あとで経理担当者が困るパターン」を事前に洗い出す作業です。月次決算の前に人手でひとつずつ確認する代わりに、チェック観点をあらかじめ言語化して依頼すれば、確認作業の下ごしらえをAIに任せられます。最終的な承認や修正の実行は人が行う前提で使うと、事故が少なくなります。
AIに会計データを渡す前に確認すること
仕訳チェックはマネーフォワード クラウド会計のデータをClaudeに読み込ませる作業です。取得したデータはClaude側のコンテキストに含まれ、AIアプリケーションとその提供事業者のサーバーへ送信される場合があります。公式のベストプラクティスは、次の2点を連携前に確認するよう求めています。
- 利用するAIアプリケーションが取得データをモデルの学習に利用するかどうかを、各サービスの利用規約・設定で確認する
- 給与、個人情報など外部に送信すべきでないデータが混ざっていないか、連携前に確認する
仕訳データそのものは金額や取引先名が中心ですが、摘要欄に氏名や個人的な事情を書き込む運用の会社もあります。組織のセキュリティポリシーと照らし合わせたうえで、読み込ませる範囲を決めておくと安全です。
仕訳チェックで使うAPIスコープ
マネーフォワード クラウドのMCPサーバーは、OAuth 2.0の認可フローで発行されたスコープの範囲でしかデータにアクセスできません。公式ドキュメントが示すクラウド会計向けのスコープは次の通りです。
| スコープ | 用途 |
|---|---|
| journal.read / journal.write | 用途仕訳の取得・作成・更新 |
| report.read | 用途試算表・推移表の取得 |
| taxes.read | 用途税区分マスタの取得 |
| trade_partners.read / write | 用途取引先マスタの取得・更新 |
| connected_account.read | 用途連携した金融機関の口座情報を取得 |
| transaction.read / write | 用途取引データの取得・更新 |
| accounts.read / departments.read / offices.read | 用途勘定科目・部門・事業所の情報を取得 |
チェックだけが目的なら、journal.writeやtransaction.writeのような書き込み系スコープは本来不要です。クラウド会計側が要求するスコープはmfc/accounting/で始まるものだけです。
公式のトラブルシューティングでも、MCPクライアントが必要以上のスコープを要求してしまう事例が報告されています。契約していない別サービス(人事管理など)のスコープまで要求し、認可画面で権限不足エラーになることがある、という事象です。原因はマネーフォワード側ではなくMCPクライアント側の実装差で、契約サービスを増やさずに解消する方法は基本的にありません。
Claude側のOAuth認可画面でスコープを個別に選び直す設定は確認できていません。読み取りだけに絞りたい場合は、Claude Code側の権限設定で書き込み系ツールを個別に「確認」や「拒否」にする運用が次善策になります。この設定方法はClaude Code MCP設定ガイドにまとめています。
Claude Codeから手動でリモートMCPサーバーとして登録する場合は、次のように接続します。
claude mcp add --transport http moneyforward \
https://beta.mcp.developers.biz.moneyforward.com/mcp/ca/v3 \
--header "Mf-Api-Key: mf_api_xxxxxxxx..."Mf-Api-Keyにはマネーフォワード クラウドのアプリポータルで発行したAPIキーを指定します。ディレクトリコネクタ経由でOAuth接続する場合は、この手動登録は不要です。
このAPIキーの扱いには注意が必要です。公式のベストプラクティスは、Client Secret・APIキー・トークンをソースコードへハードコードしないこと、バージョン管理システムにコミットしないことを求めています。連携を終了する際はアプリポータルから連携を解除してトークンを失効させ、権限が残ったままにならないよう、アプリポータル上の連携状況と付与権限を定期的に棚卸しすることも推奨されています。
指示文の書き方 — チェック観点を先に絞る
仕訳チェックで結果がぶれる最大の原因は、「今月の仕訳を確認して」のような曖昧な依頼です。何を、どの期間で、どんな基準に照らして見るのかを先に決めてから依頼すると、Claudeが拾う項目が安定します。
2026年8月に登録された仕訳のうち、次の観点で確認が必要なものを一覧にしてください。
- 対象期間: 2026年8月1日〜8月31日
- チェック観点:
1. 税区分が未設定、または税額の計算が金額と合わない
2. 同じ取引先・同じ金額の仕訳が重複して登録されている疑い
3. 「仮払金」「仮受金」勘定のまま1か月以上動きがない
- 出力形式: 仕訳ID・取引先・金額・該当した観点・簡単な理由
- 判断に迷うものは「要確認」として残し、仕訳の修正や削除は実行しない最後の1行が要です。マネーフォワード クラウドのMCPサーバーは仕訳の新規作成・更新まで実行できるため、確認のつもりで出した指示が曖昧だと、そのまま書き換えが実行されてしまうことがあります。
月次決算前の確認フローに組み込む
チェックを1回だけ実行して終わりにするより、月次決算の前に必ず通す確認手順として固定するほうが効果が出ます。「毎月末、締め処理の前に、仮払金・仮受金の滞留と税区分の不整合をClaudeに一覧化させる」という手順を経理担当者間で共有しておけば、担当者が変わっても同じ基準でチェックが回ります。属人化しない仕組みです。
試算表・推移表の取得(report.read)を組み合わせれば、個別の仕訳だけでなく、勘定科目ごとの月次推移から異常な増減を見つける依頼もできます。「先月と比べて残高が大きく動いた勘定科目を、金額と主な仕訳とあわせて教えて」といった依頼は、決算前の異常検知として実用的です。粒度を変えた二段構えの確認になります。
仕訳の作成・修正までAIに任せる場合の注意
チェックだけでなく、連携した金融機関明細から仕訳を登録する操作にも対応しています。未仕訳の明細を取得し、そのまま仕訳として作成する操作です。記帳の自動化まで踏み込む場合、公式のベストプラクティスが挙げる2点を運用に組み込む必要があります。
1つは、破壊的操作の前に人間の確認を挟むことです。マネーフォワード クラウドのMCPサーバーは、削除や重要な更新を伴うツールについて、実行前の確認を促す仕組み(Instructions)をクライアントに渡します。ただしこの指示を実際にどこまで反映するかはMCPクライアント側の実装次第で、Claude Codeがどれだけ厳密に扱うかは接続のたびに確認しておくと安全です。
もう1つは、権限を必要最小限に保つことです。マネーフォワード クラウド側の「全権管理」権限を持つ担当者が、実際に操作する利用者へどの範囲まで権限を渡すかを決めます。仕訳の新規作成まで任せたい担当者と、閲覧チェックだけで十分な担当者を同じ権限で扱わない区別が、事故を減らします。
複数事業所を扱う場合の注意
1つの契約で複数の事業所を扱っている場合、仕訳チェックの依頼をする前に対象の事業所を明示しておく必要があります。事業所情報はoffices.readスコープで取得できますが、依頼文で事業所名を省略すると、Claudeがどの事業所のデータを見ているのか利用者側で確認しづらくなります。
「A事業所の8月分の仕訳をチェックして」のように、依頼の冒頭で対象を固定する運用が有効です。複数事業所を横断して作業する担当者でも、誤った事業所のデータをチェック対象にしてしまう事故を避けやすくなります。決算期がずれている事業所を並行して扱っているチームでは、特に効果があります。
freeeの仕訳確認との違い
freee会計にも同種のMCPサーバーがあり、Claudeとfreee会計の連携 — Claude Codeで仕訳・記帳を確認する手順で仕訳確認の指示文の書き方を扱っています。観点を先に絞ってから依頼する、書き込み系ツールを都度確認する、という基本的な考え方は共通ですが、接続方式は異なります。freee-mcpはリモートMCP・ローカルMCPサーバー・Claude Code Pluginの3方式から選びます。両サービスのMCP対応を横並びで比較した内容はfreee vsマネーフォワードのMCP対応を比較するにまとめています。
よくあるつまずき
認可後にDesktopが接続できない
公式のトラブルシューティングが報告している事象です。マネーフォワード側のログに異常がなければClaude Desktop側の問題である可能性が高く、ブラウザー版のClaudeで一度認証したうえでDesktopを再起動すると解消することがあります。
接続先URLを間違えて権限不足エラーになる
https://api.biz.moneyforward.com/mcp/sseのような、公式が提供していないエンドポイントを設定すると起きます。契約していないサービスの権限要求で止まるためです。接続先URLは必ず公式ドキュメントに記載されたものを使います。
チェック結果と画面の表示がずれる
MCPサーバーはAPI経由でデータを取得するため、基本的には画面の表示と一致します。大量の仕訳を一度に確認させると、レスポンスが途中で切り詰められることがあります。件数が多い月は、期間を分けて依頼すると取りこぼしを防げます。
チェック中にエラーで止まる
MCPサーバーは内部でマネーフォワード クラウドのAPIを呼び出しており、APIのレート制限を超えるとツール呼び出しがエラーとして返されます。1回の依頼で扱う期間や件数を絞る、あるいは一定時間おいてから再試行する運用にしておくと、繰り返し止まる状況を避けられます。
よくある質問
freeeとマネーフォワード、両方を同時にチェックさせられますか
技術的には両方のMCPサーバーを同時に接続できます。ただし依頼のたびにどちらのサービスを対象にするか明示しないと、Claudeが参照先を取り違える可能性があるため、依頼文に対象サービス名を明記する運用をおすすめします。
まとめ
マネーフォワード クラウド会計の仕訳チェックは、確認したい期間と観点を先に決めてから依頼することで結果が安定します。書き込み系のスコープはClaude側で個別に選び直せないため、チェック目的の依頼では「修正や削除は実行しない」と明示し、必要ならClaude Code側の権限設定で書き込み系ツールを制限します。データの送信範囲と認証情報の扱いも、あわせて確認しておく事項です。月次決算前の確認フローとして固定し、抽出結果を元の帳簿と突き合わせる工程までセットで運用する。これが事故を減らす基本の型です。