メインコンテンツへスキップ
見出し画像

Claude Code×freeeで請求・入金の確認を自動化する──未決済の一覧、公式MCPの権限、消込は人が押す線

    この記事は、Claude Code×freeeで、請求と入金の確認を自動化する手順を扱います。

    入金の確認を、月末に社長がまとめてやっていないか

    「あの会社、先月分はもう入ってたっけ」


    通帳とfreeeの画面と、請求書の控えを行き来する。この確認を、社長が月末にまとめてやっている制作会社は少なくありません。


    確認が遅れると督促が遅れ、資金繰りの谷が深くなります。


    入金の確認は、判断の仕事ではなく、照合の仕事です。照合は、機械に任せられます。

    Claude Code×freeeの自動化とは、未決済の取引と入金の明細を機械に突き合わせさせ、人は「合っているか」を確かめて押すだけにする仕組みである

    黒字化の外科医です。freeeの公式の仕組みを使って、入金の確認を「読むだけ」にする手順を解剖します。


    なお私は税理士ではありません。実務の指針として読み、個別の判断は専門家や公的な窓口に確認してください。


    この形が向いている理由は、三つあります。


    第一に、freeeが公式のMCPサーバーを出しているから。
    freeeは「freee-mcp」を公開しており、Claude Codeにはプラグインとして入れる手順が案内されています。リモート版のURLは `https://mcp.freee.co.jp/mcp` で、公式以外のURLを入れないよう注意書きがあります(freee-mcp 公式README、2026年11月2日確認)。


    第二に、APIで「未決済」の取引だけを取り出せるから。
    freee会計APIの取引一覧は、決済状況(未決済・完了)、収支の区分、支払期日の範囲などで絞り込めます。口座の明細も、口座と日付の範囲で取り出せます(freee会計API 公式スキーマ、2026年11月2日確認)。


    第三に、消込のAPIが増えたから。
    2026年10月26日付で、口座の明細を未決済の取引と紐づけて消し込むAPIなどが追加されました(freee Developers 公式のお知らせ、2026年11月2日確認)。


    ただし、この記事では、消込は人が画面で確かめて押す前提にします。理由は「構造的なリスク」で書きます。

    今すぐ試せる:未決済の請求を一覧にするプロンプト

    freee-mcpをつないだClaude Codeに、次のように頼みます。最初は読み取りだけです。

    freeeの事業所〔事業所名〕について、読み取りだけで次の一覧を作ってください。
    書き込み・更新・削除のツールは使わないこと。
    
    1. 収入の取引のうち、決済状況が「未決済」のものを取得する
       (支払期日:〔開始日〕〜〔終了日〕)
    2. 取引先、発生日、支払期日、金額、未決済の残高を表にする
    3. 支払期日を過ぎているものに「期日超過」、7日以内のものに「期日間近」と印をつける
    4. 同じ期間の口座の入金の明細を取得し、金額と取引先名が近い組み合わせを
       「消込候補」として並べる(確定はしない)
    5. 候補が見つからない未決済の取引を、最後にまとめる
    
    金額が一致しない候補は、差額を書くこと。推測で取引先を決めないこと。


    出てきた表を、経理の担当か社長が見て、freeeの画面で消し込みます。

    入金確認工場:権限、手順、点検表

    1. Claude Codeに渡す権限の線

    freee-mcpのツールは、HTTPのメソッドごとに分かれています(取得・作成・更新・削除など。freee-mcp 公式README、2026年11月2日確認)。
    Claude Codeの権限ルールで、読み取りは許可し、書き込みは毎回確認、削除は禁止にします。

    (.claude/settings.json の例。サーバー名を freee として追加した場合)
    {
      "permissions": {
        "allow": ["mcp__freee__freee_api_get"],
        "ask":   ["mcp__freee__freee_api_post",
                  "mcp__freee__freee_api_put",
                  "mcp__freee__freee_api_patch"],
        "deny":  ["mcp__freee__freee_api_delete"]
      }
    }


    Claude Codeの権限ルールは「拒否→確認→許可」の順に評価されます(Claude Code 公式ドキュメント、2026年11月2日確認)。
    プラグインで入れた場合はツール名が変わるため、`/mcp` で確かめてから書いてください。

    2. 毎週の手順

    月曜 9:00 未決済の一覧を作る(上のプロンプト)
    月曜 9:15 消込候補を人が確認し、freeeの画面で消し込む
    月曜 9:30 期日超過の取引先に、連絡の下書きを作らせる(送るのは人)

    3. 使う前の点検表

    □ freeeのアプリやMCPに渡す権限を、必要なものだけにしたか
    □ 接続先のURLが、freee公式のものか確かめたか
    □ 書き込みのツールを「毎回確認」にしたか
    □ 削除のツールを禁止にしたか
    □ 消込を確定するのは人、と社内で決めたか
    □ 1日のAPI呼び出しの上限を確かめたか(下記)


    freee会計APIには、契約のプランごとに、事業所とアプリごとの1日の呼び出し回数の上限があります。法人エンタープライズは10,000回、法人アドバンス(旧法人プロフェッショナルを含む)は5,000回、それ以外は3,000回です。短時間に呼びすぎると制限がかかり、10分ほどで解除されるとされています(freee会計API 公式スキーマ、2026年11月2日確認)。


    請求書そのものは、freee会計からfreee請求書に機能が移っており、APIも別になっています(同上)。請求書の作成まで自動化するときは、どちらのAPIかを先に確かめてください。


    請求書の作り方と、入金の予定表の型は、別の記事にまとめています。

    ▶ 請求書の作成を自動化する制作会社へ、AIは「下書き」と「点検」に使う──見積書から請求書まで同じ案件番号でつなぎ、インボイスの記載事項を毎回そろえる型

    ▶ 入金確認と督促を、制作会社は「社長の記憶」で回すのをやめる──入金予定表、週1回の消込、期日の前後に送る連絡の型と、AIに任せてよい作業

    構造的なリスク

    逆説を指摘しておきます。


    消込のAPIがあると、「全部自動で消し込めばいい」と考えたくなります。
    けれど、同じ金額の請求が2件ある、振込の名義が会社名と違う、手数料が引かれている。こうした入金は、機械の候補がよく外れます。


    間違って消し込むと、未入金の取引が「入金済み」に見え、督促が止まります。
    自動化で一番怖いのは、遅れることではなく、間違いに気づかなくなることです。だから、確定は人が押します。


    顧客の会社のfreeeを、受託として操作する場合は、さらに線を引きます。
    権限は必要な範囲だけにし、触ってよい操作を契約に書き、顧客の同意を書面で残してください。APIキーと権限の社内ルールは、こちらで扱っています。

    ▶

    よくあるQ&A

    Q. freee-mcpは、どのプランでも使えるのか?


    APIで使える機能は、freee会計のWeb版で使える機能と同じで、プランによって異なるとされています。自社のプランで使える範囲を、freeeの公式ページで確かめてください。


    Q. Claude Codeでなく、freeeの自動登録ルールだけでよいのでは?


    明細の自動登録ルールで足りる入金は、それで十分です。Claude Codeは、ルールで拾えない入金と、期日超過の一覧と、連絡の下書きに使います。

    最後に

    入金の確認は、判断ではなく照合の仕事です。


    照合を機械に任せ、確定だけを人が押す線を引いた会社だけが、督促を遅らせずに、月末の社長の時間を取り戻せるのです。

    これまでの記事は、メンバーシップ「黒字化オペ室」でまとめて読めます。月額1,980円、記事2本分の金額です。詳しくはプロフィールから。


    #Web制作会社 #ClaudeCode #freee #入金確認 #経理の自動化 #MCP #制作会社経営 #中小企業 #バックオフィス #資金繰り

     
     
    Web制作・開発会社の「労働集約という病」をAIで冷徹に切除し、利益率を極限化する組織ハッキング術を公開。 人間の感情と作業を排除し、社長一人で莫大な富を搾取する「完全無人ファクトリー」を構築する覚悟を持つ経営者のみ、有料記事で圧倒的な暴利と勝利を手に入れてください。

    あなたへのおすすめ