【第2部 本体】freee と MF を「同じ形」で返す本体アプリ

はじめに

AI に読ませて進める

進め方は第1部の冒頭（「このシリーズの進め方」）を参照してください。この記事と zip を AI に渡して、次のように頼みます。

この記事とzipを使って、第2部を最初から進めてください。
- 記事に書いていないことは推測で補わず、分からなければ私に聞いてください
- 一度に一つの手順だけ進め、結果を見てから次に進んでください
- 鍵の発行、.envへの記入、ブラウザでの「許可」は私がやるので、そこに来たら止まって、何をすればいいか教えてください
- 鍵やトークンを私に貼らせないでください

この回の進め方

第1部と同じく、完成したコード一式を zip で配り、それを動かしながら、なぜこう作ったのかを読み解いていきます。

• 使う zip: freee-mf-mcp-sample-v2.0.zip（この記事と同じ版。コードの版は zip の版で決まります）

• 第2部で使うファイル: app/（server.js ・ routes.js ・ adapters/）と、第1部の auth/ ・ env.js

• 前提: 第1部が終わっていること（npm run mf:check と npm run freee:check が通る状態）

第3部 MCP        Claude / ChatGPT から呼ぶ薄い口
   ↓ HTTP（同じパソコンの中だけ）
第2部 本体アプリ  freee と MF を「同じ形」で返す   ← この回
   ↓ 関数
第1部 認証        MF は API キー、freee は OAuth

筆者が本物で確かめた範囲

• Windows 11 ／ Node.js 24.15.0

• MF（筆者の事務所・読むだけ）: /health、試算表（貸借対照表と損益計算書）、1〜9 月の仕訳（全件で借方と貸方が一致）、勘定科目

• freee（検証用の事業所・読むだけ）: /health、試算表、今期の仕訳（全件で借方と貸方が一致）、勘定科目

• どちらも、この記事の「共通の形」の検め（contract.js）でエラー 0