AIツール2026年10月更新

freee MCP 使い方 完全ガイド|クレジットカード仕訳・消込の実務フローを解説

公開日: 2026/04/07
更新日: 2026/10/28
freee MCP 使い方 完全ガイド|クレジットカード仕訳・消込の実務フローを解説

この記事のポイント

freee MCPでクレジットカード明細を仕訳・消込する手順を、2026年10月に追加された消込API(reconcile・create_deal・create_transfer等)に合わせて整理。初期設定、使えるかどうかの確かめ方、二重計上を防ぐ運用、使えない環境での代替パターンまでまとめました。

freee MCPは、ClaudeやClaude CodeなどのAIエージェントから、freee会計の仕訳登録・明細の処理・帳簿確認を自然言語で操作できる、フリー株式会社の公式ツールです。2026年10月26日にfreee会計APIへ口座明細の消込用エンドポイントが追加され、freee MCP(v0.37.8以降)からもクレジットカード明細の消込を呼び出せるようになりました。

ただし、9月のfreeeの発表では「Public API・freee-mcpでの消込は、まずfreee認定アドバイザー向けに順次提供」とされており、すべての利用者がすぐ使えるかは公式情報だけでは断定できません。使えるかどうかは少額の明細1件で試せば確かめられ、使えない環境でも仮払金方式などの代替手順で二重計上を防ぎながら運用できます。

この記事でわかること

  • freee MCPの初期設定(リモート版・ローカル版・Claude Codeプラグイン)
  • クレジットカード明細を「取得 → 種類で分ける → 登録・消込 → 確認」する実務フロー
  • 新しい消込API 7本の使い分け(reconcile/create_deal/create_transfer など)
  • 二重計上が起きる仕組みと、防ぐための確認手順
  • 消込APIを使えない環境向けの代替パターン(仮払金方式・自動登録ルール等)
  • セキュリティ・権限設計と費用の考え方

想定読者: freee会計を使っている個人事業主・中小企業の経理担当者、会計事務所の方で、AIでカード明細の処理を効率化したい方。仕訳・勘定科目の基礎知識がある前提で進めます。MCPそのものの仕組みはMCPとは?仕組みとできることを解説、AIエージェント全般はAIエージェントとは? 仕組み・種類・活用事例をわかりやすく解説で詳しく扱っています。


freee MCPとは? AIで会計業務を自然言語操作できる公式ツール

freee MCPの概要。AIエージェントからfreeeの基幹業務を操作できる公式ツール

出典: フリー株式会社 公式プレスリリース

freee MCPは、MCP(Model Context Protocol)という共通規格を使って、AIエージェントにfreeeのPublic APIを呼び出させるための公式サーバーです。2026年10月時点のREADMEでは、会計・人事労務・請求書など12のAPIとfreeeサインを合わせて587操作に対応しています。

個別のAPIを1本ずつツールにするのではなく、freee_api_get・freee_api_post のようなHTTPメソッド別の汎用ツールにAPIのパスを渡す作りです。そのため、freee側にAPIが追加されてスキーマが更新されれば、新しい操作もそのまま呼び出せます。今回の消込APIもこの仕組みで取り込まれました。

基本情報

項目

内容(2026年10月時点)

開発元

フリー株式会社

初回公開

2026年3月2日(OSS版)

リモート版提供開始

2026年3月27日

最新バージョン

v0.37.9(2026年10月27日)

ライセンス

Apache-2.0(オープンソース)

freee MCP自体の料金

無料

対応AIクライアント(README記載)

Claude / Claude Desktop、Claude Code、Cursor、OpenCode、GitHub Copilot、Codex、Gemini CLI など

対応領域

会計・人事労務・請求書・工数管理・販売・IT管理・固定資産・業務委託管理・サーベイ・開業・人事評価・申告(法人税)+サイン(電子契約)

対応操作数

587(サイン含む。READMEの自動更新値)

ツール構成

freeeサーバー15ツール(管理9・API6)+ freee-sign-mcp 8ツール

認証方式

OAuth 2.0 + PKCE(トークンは自動更新)

バージョンや操作数は頻繁に更新されます。最新値はGitHubのfreee/freee-mcpで確認してください。

何ができるのか

クレジットカードまわりで使う主な操作は次のとおりです。

  • カード明細の取得: カード口座の未処理明細を一覧にし、AIに勘定科目を判定させる
  • 明細からの取引登録と消込: 明細1件を経費として登録し、同時に処理済みにする(2026年10月追加)
  • 未決済取引との消込: 請求書払いなど、先に登録してある未決済取引とカード明細を紐付ける(2026年10月追加)
  • カード代金の引き落とし処理: 銀行口座からカード口座への口座振替として登録する(2026年10月追加)
  • 私用分・対象外明細の処理: プライベート取引として登録、または「無視」にする(2026年10月追加)
  • 自動登録ルールの管理と一括適用: ルールの作成・更新と、未適用ルールの一括適用(適用APIは2026年10月追加)
  • 帳簿の確認: 試算表・総勘定元帳の取得、未承認仕訳の確認、前月比の分析
  • 複数事業所の切り替え: freee_set_current_company で操作対象の事業所を切り替える

カード以外では、請求書の作成、経費申請、勤怠、freeeサイン(ローカル版のみ)なども同じ要領で扱えます。

2026年のおもなアップデート

日付

内容

2026年3月2日

OSS版を公開

2026年3月27日

リモート版の提供開始

2026年4月10日

freeeサインに対応(ローカル版のみ)

2026年6月8日

freee IT管理に対応(リモート・ローカル両方)

2026年夏〜秋

freee申告(法人税)・freee固定資産のPublic APIに対応

2026年9月15日

freeeが「入出金明細の消込に対応するPublic API・MCPを順次提供開始」と発表

2026年10月26日

freee会計APIに口座明細の消込系7本を追加

2026年10月27日

v0.37.8でスキーマに反映、同日v0.37.9をリリース

出典: freee プレスリリース一覧、freee Developers Community、GitHub Releases

MCP単体では不十分なため、Agent Skillsの併用を推奨

freee MCPは、MCP本体に加えて「freee-api-skill」(Agent Skills)を入れて使うのが公式の推奨です。スキルはAPIリファレンスと操作レシピを、作業に必要な分だけAIに読み込ませます。スキルが無いと、AIがAPIの使い方を手探りし、呼び出しの失敗や回数が増えがちです。

導入方法は次のいずれかです(2026年10月時点のREADME)。

npx skills add freee/freee-mcp
gh skill install freee/freee-mcp freee-api-skill

GitHub CLIを使う方法はv2.90.0以上が必要です。ほかに apm install freee/freee-mcp/skills/freee-api-skill や、ClaudeのSkills設定に freee-api-skill.zip をアップロードする方法もあります。

なお、2026年10月時点のスキルには、明細消込のAPIリファレンスはありますが、消込専用の操作レシピはまだありません。AIへの指示を具体的に書くほど、処理が安定します。


freee MCPの初期設定とリモート版・OSS版の違い

freee MCPリモート版の概要。ローカルの設定なしでURLを追加して使える

出典: フリー株式会社 公式プレスリリース(リモート版)

初めて使うなら、freeeがサーバーを運用するリモート版(Remote MCP)がおすすめです。領収書のアップロードやfreeeサインを使いたい場合、新しいスキーマを自分のタイミングで取り込みたい場合はローカル版を選びます。

リモート版 vs ローカル版(OSS版)の比較

比較項目

リモート版(推奨)

ローカル版(OSS・stdio)

設定の手間

カスタムコネクタにURLを追加するだけ

freeeアプリストアでアプリ登録 → npx freee-mcp configure

サーバー管理

freeeがホスト

自分のPCで起動

接続先

https://mcp.freee.co.jp/mcp

自分のPC(コールバック http://127.0.0.1:54321/callback)

認証

ブラウザでfreeeにログイン

自分で登録したOAuthアプリで認証

新しいAPIの反映

freee側の更新を待つ(反映時期は公表されていない)

新しいバージョンを使えば即反映

ファイルアップロード(領収書等)

不可

可能(freee_file_upload)

freeeサイン

準備中(未提供)

対応(freee-sign-mcp)

サーベイ・開業・人事評価

対応

非対応

こんな人におすすめ

すぐ試したい人・非エンジニア

領収書の取り込みや電子契約も扱いたい人、開発者

リモート版のセットアップ手順

Step 1: 接続先のクライアントを決める

Claude(Web/デスクトップアプリ)、Claude Code、Cursorなど、MCPに対応したクライアントを用意します。Claudeの機能や料金はClaudeとは? 機能・料金・使い方・ChatGPTとの違いを整理にまとめています。

Step 2: カスタムコネクタとしてfreeeを追加する

Claudeの場合は、コネクタの設定から「カスタムコネクタを追加」を選び、名前を freee、URLを https://mcp.freee.co.jp/mcp にします。freeeヘルプでは、カスタムコネクタでの設定のほかに「Claude公式コネクタを使った設定」も案内されています。

URLは必ず公式の値を手で確認してから入力してください。freeeは「freee公式以外のURLを入力しないように」と注意を呼びかけています。

Step 3: Agent Skillsを入れる

Claude Codeなら npx skills add freee/freee-mcp、Claudeのアプリなら freee-api-skill.zip をSkills設定にアップロードします。

Step 4: freeeにログインして許可する

初回接続時にブラウザでfreeeの認証画面が開きます。ログインして許可すると、AIからfreeeを操作できるようになります。

Step 5: 動作確認

最初は読み取りだけの指示で確かめます。

freeeで今操作している事業所の名前とIDを教えて
クレジットカードの口座を一覧にして、口座IDと最終同期日時を出して

事業所名が正しく返ってくれば接続完了です。複数の事業所がある場合は、この時点で操作対象を必ず確認してください。

ローカル版(OSS版)のセットアップ

ローカル版はNode.jsで動きます。必要なNode.jsのバージョンはREADMEで確認してください。

  1. freeeアプリストア(開発者向け)で自分用のアプリを作成し、コールバックURLを http://127.0.0.1:54321/callback に設定する
  2. 発行されたClient IDとClient Secretを控える
  3. ターミナルで次を実行し、案内に従って認証情報を設定する
npx freee-mcp configure

Claude Desktopの設定ファイルには、次のようにローカルサーバーを登録します。

{
  "mcpServers": {
    "freee": {
      "command": "npx",
      "args": ["freee-mcp"]
    }
  }
}

古い記事で見かける npm install -g freee-mcp は、現在のREADMEの手順ではありません。グローバルに入れた古い版を使い続けると、消込APIが入る前のスキーマのまま動くことがあるので注意してください。ターミナル操作に不慣れな方はAIコーディング初心者ガイド|始め方・ツール選び・注意点が参考になります。

Claude Code・Codexのプラグインで入れる

Claude Codeでは、プラグインとして導入する方法も用意されています。

claude plugin marketplace add freee/freee-mcp
claude plugin install freee-mcp@freee-mcp-marketplace

プラグインにローカルサーバーは含まれません。ファイルアップロードなどローカル版だけの機能を使うときは、ローカル版を別に設定します。Codexでも codex plugin marketplace add freee/freee-mcp を実行し、/plugins からインストールできます。Claude CodeでのMCP連携全般はClaude Code MCP連携ガイド、ツールの概要はClaude Codeとは? できること・料金・使い方を解説で解説しています。

本番データで試す前に

freee MCPの書き込み操作は、接続した事業所の本番データにそのまま反映されます。最初は少件数で試すか、検証用の事業所を用意してください。開発者向けのテスト事業所の作り方は、freeeの開発者向け情報で最新の手順を確認するのが確実です。

AIが判断に迷いやすいケースと対処法

ケース

問題

対処法

勘定科目が曖昧

「Amazonで買い物」→ 消耗品費か、新聞図書費か

用途を書く(「オフィス用の文房具」など)

消費税区分

海外SaaS(AWS等)の税区分

「課税仕入10%」「対象外」などを指示に書く

口座の選択

カードを複数登録していると、どのカードか不明

カード名か口座IDを指定する

日付のずれ

利用日・計上日・引き落とし日の違い

「発生日は明細の利用日」など基準を決めて伝える

金額の差

請求額と明細額が年会費・手数料の分だけ違う

差額の勘定科目を先に決めておく


freee MCP最大のハードル「消込」問題の正体

freee MCPの公開告知。AIエージェントからfreee会計を自然言語で操作できる

出典: フリー株式会社 公式プレスリリース

カード明細を扱うときの最大の注意点は、「取引を登録しただけでは、明細は処理済みにならない」ことです。2026年10月26日より前は、APIで明細と取引を紐付ける手段が無く、これが二重計上の原因になっていました。現在は消込用のAPIが追加されていますが、使い方を誤ると同じ問題が起きます。

そもそも消込とは何か

freeeでは、次の2つのデータが別々に存在します。

  • 明細(wallet_txn): カード会社や銀行から同期された入出金データ。「自動で経理」に並ぶもの
  • 取引(deal): 帳簿に載る仕訳データ

この2つを紐付け、明細を「処理済み」にする操作が消込です。消込が終わっていない明細は「自動で経理」に残り続けます。

取引を登録しても明細が残る理由

従来からある POST /api/1/deals(取引の登録)は、明細とは無関係に取引を作るAPIです。そのため、次のことが起きます。

  1. AIに「法人カードで払った新幹線代32,000円を旅費交通費で登録して」と頼む
  2. AIが deals で取引を登録する(成功する)
  3. しかしカード口座の明細は「自動で経理」に未処理のまま残る
  4. 別の担当者や後日の自分が、その明細から同じ取引をもう一度登録してしまう

この事象はGitHubのIssue #313で報告され、2026年3月29日に「freee API側の要望」として案内のうえクローズされました。その後、freee会計API側に消込用のエンドポイントが追加され、2026年10月にようやく解消の道筋ができました。

2026年10月に追加された消込API 7本

やりたいこと

エンドポイント

カード実務での使いどころ

明細と未決済取引の消込

POST /api/1/wallet_txns/{id}/reconcile

先に「未決済」で登録した請求書払い・仕入をカード明細と紐付ける

明細から取引登録+消込

POST /api/1/wallet_txns/{id}/create_deal

カードで払った経費を、その明細から直接計上する(最も多い使い方)

明細を口座振替として登録

POST /api/1/wallet_txns/{id}/create_transfer

銀行口座からのカード代金の引き落とし

明細をプライベート取引として登録

POST /api/1/wallet_txns/{id}/create_private_deal

事業用カードで払った私用分

明細を「無視」にする

POST /api/1/wallet_txns/{id}/ignore

重複取り込み・対象外の明細

無視・消込済みを未消込に戻す

POST /api/1/wallet_txns/{id}/reset

処理を間違えたときのやり直し

未適用の自動登録ルールを一括適用

POST /api/1/user_matchers/apply

ルールを作った後、既存の未処理明細に当てる

出典: 【freee会計】口座明細の消込操作が可能になりました(freee Developers Community、2026年10月26日)

従来から使えた明細の一覧取得(GET /api/1/wallet_txns)、口座一覧(GET /api/1/walletables)、自動登録ルールの作成・更新と組み合わせると、カード明細の処理をほぼ一通りAIに任せられる構成になりました。

公式情報の食い違いと、いま自分の環境で使えるかの確かめ方

利用者の範囲について、公式の記述は次の2つで書きぶりが揃っていません。

  • 2026年9月15日のプレスリリース: 入出金明細の消込はfreee Agent Hubでは提供済み。Public API・freee-mcpは「2026年10月以降、freee認定アドバイザー向けに順次提供予定」で、その他の利用者への拡大時期は未定
  • 2026年10月26日の開発者向けお知らせ: 7本のAPIを追加したと告知。利用者の範囲には触れておらず、アプリストア公開申請するアプリは審査で「プラン限定アプリ」の対象になる一方、freee-mcpでの利用はその審査の対象外と記載

つまり「APIとfreee MCPのスキーマには入った」ことは確かですが、自分の事業所・プラン・権限で実行できるかは、実際に確かめるしかありません。会計事務所の方は、認定アドバイザーとしての提供状況もあわせて確認してください。会計事務所でのAI活用は税理士・会計事務所のAI活用事例でも取り上げています。

確かめ方(3ステップ)

  1. バージョンを確認する: ローカル版はv0.37.8以上で動いているか確認します。freee_server_info で確かめられます。リモート版のスキーマ反映時期は公表されていません
  2. パスが出るか確認する: AIに「freee_api_list_paths で wallet_txns に関するパスを一覧にして」と頼み、/api/1/wallet_txns/{id}/reconcile などが含まれるか見ます
  3. 1件だけ試す: 金額の小さいカード明細1件で create_deal を実行し、「自動で経理」で処理済みになったか確認します。権限や提供範囲のエラーが返るなら、この時点では代替パターンで運用します

新しい消込APIで消込を解決する実践パターンと代替パターン

Claudeのカスタムコネクタ追加画面にfreee MCPリモート版のURLを入力した様子

出典: フリー株式会社 公式プレスリリース(リモート版)

消込APIを使える環境なら、カード明細は「同期は画面、仕分けと登録はAI、最終確認は人」という分担で処理するのが現実的です。明細の同期(カード会社からの即時取り込み)はAPIで実行できないため、ここだけはfreeeの画面で行います。

基本フロー:カード明細を月次で処理する6ステップ

ステップ

担当

操作・API

ポイント

1. 明細を最新にする

人(freee画面)

口座の同期

同期APIは未提供(freee-api-schema Issue #637で要望中)

2. 未処理明細を取る

AI

GET /api/1/wallet_txns

walletable_type=credit_card と walletable_id を両方指定。1回100件まで

3. 種類で分けて一覧にする

AI

(判定のみ・登録しない)

経費/未決済取引あり/引き落とし/私用/対象外に分類し、科目・税区分案を付ける

4. 一覧を確認する

人

—

科目・税区分・按分を確認し、実行してよい行を決める

5. 種類ごとに登録・消込

AI

create_deal / reconcile / create_transfer / create_private_deal / ignore

少件数から。1件ずつ結果を返させる

6. 残りを確認する

AI+人

GET /api/1/wallet_txns(再取得)

due_amount(取引登録待ち金額)と未処理件数がゼロに近いか確かめる

ステップ2では絞り込み条件に注意が必要です。walletable_type と walletable_id は片方だけ指定すると条件が無視され、カード以外の明細まで返ってきます。

AIへの指示例(ステップ2〜3。数値は架空です)

freeeの事業所を確認してから、法人カード(口座ID: 123456)の未処理の明細を全件取得して。
まだ何も登録しないで、1件ずつ次の列の表にして。
日付/金額/摘要/分類(経費・未決済取引あり・引き落とし・私用・対象外)/勘定科目案/税区分案/判断に迷う理由

AIへの指示例(ステップ5。経費の登録)

さっきの表で「経費」に分類した行のうち、私がOKと書いた3件だけ、
明細からの取引登録(wallet_txns の create_deal)で処理して。
金額は明細の金額と一致させ、発生日は明細の利用日にして。
1件ごとに、作成された取引IDと明細の状態を報告して。

種類別のAPIの使い分け

① カードで払った経費 → create_deal

最もよく使う処理です。明細から取引を作り、同時に消込まで済ませます。deal_lines[].amount は税込の符号付き整数で、合計は明細金額と一致させる必要があります。税区分を省略すると勘定科目の既定の税区分、日付を省略すると明細の取引日が使われます。

② 先に未決済で登録した取引がある → reconcile

受け取った請求書を「まだ支払っていない」状態で登録しておき、後でカードで払ったケースです。明細と既存の取引を紐付けます。指定した取引の決済金額の合計(+差額調整の取引)が明細金額と一致するように指定します。

カード明細と請求額が年会費や手数料の分だけ違う場合は、adjustment_deal で差額の取引を同時に登録できます。同じ内容で再リクエストしても二重には処理されない(冪等)仕様です。

③ カード代金の引き落とし → create_transfer

銀行口座からカード口座への資金移動なので、経費ではなく口座振替として登録します。銀行側の出金明細から処理する場合は、振替元に明細の口座(銀行口座)を必ず含めます。振込手数料などは手数料行として同時に登録できます。処理後、カード口座側に対応する入金明細が未処理で残っていないかも確認してください。

④ 私用分 → create_private_deal

勘定科目や金額の指定は不要で、個人事業なら事業主貸/事業主借、法人なら役員貸付金/役員借入金として登録されます。

⑤ 重複・対象外 → ignore

すでに消込済みの明細は「無視」にできない点に注意が必要です。先に reset で未消込に戻してから処理します。

⑥ 間違えたとき → reset

無視・消込済みの明細を未消込に戻します。ただし、create_deal などで作られた取引が reset 後に自動で消えるかどうかは、公式資料では確認できていません。戻した後は取引一覧を確認し、不要な取引が残っていれば削除してください。

自動登録ルールとAIの役割分担

毎月同じ内容のカード明細(SaaSの利用料など)は、AIに1件ずつ登録させるより、freeeの自動登録ルールに任せるほうが速く確実です。

  1. AIに過去3か月分のカード明細から、繰り返し出てくる取引先・金額のパターンを抽出させる
  2. ルール案を一覧にして人が確認し、/api/1/user_matchers でルールを作成する
  3. POST /api/1/user_matchers/apply で、既存の未処理明細にも適用する

ルールを作っただけでは、すでに取り込まれている未処理明細には適用されません。user_matchers/apply は非同期処理で、レスポンスだけでは完了したかわからないため、少し時間を置いて明細を再取得して確かめます。

利用者からは次のような注意点も報告されています(GitHub Issue #529。公式見解ではありません)。

  • ルール更新APIは全項目を指定する方式で、書かなかった項目は消える
  • 登録タイプが「取引を推測する」のルールは、合致表示になるだけで明細は未処理のまま残る
  • EC連携の口座では、税区分が購入データ側の値で上書きされることがある

消込APIを使えない環境での代替パターン

提供範囲や権限の都合で消込APIをまだ使えない場合、または慎重に段階導入したい場合は、従来の運用が引き続き有効です。

代替A:仕訳待ちURL+仮払金ワークフロー

  1. AIに、freee画面で「自動で経理」の支出待ち・収入待ちを絞り込むURLを作らせる
  2. そのURLを見ながら、未確定の明細を人が「仮払金」(支出)・「仮受金」(収入)で登録する。画面から登録するので消込も同時に済む
  3. AIに、仮払金・仮受金の取引を正式な勘定科目へ振り替えさせる
仮払金と仮受金で登録した今月の取引を一覧にして、正式な勘定科目への振替案を出して。
判断できないものは理由つきで別のリストにして。私が確認してから登録して。

代替B:CSV・自動登録ルール方式

AIに明細を読ませて科目・税区分を判定させ、自動登録ルールの候補を作らせます。ルールの登録・適用は画面(またはルールAPI)で行い、消込はfreee側の「自動で経理」で完了させます。

代替C:MCP登録+画面での消込

経費の登録はAIで行い、週1回「自動で経理」の画面で既存取引との消込を人が行います。手軽ですが、未処理明細が溜まると二重計上の危険が高まるので、照合を後回しにしない運用が前提です。

パターンの比較

比較項目

消込API(基本フロー)

代替A: 仮払金方式

代替B: CSV・自動ルール

代替C: MCP登録+画面消込

消込の完了

APIで同時に完了

画面登録で完了(その後に振替)

ルール経由で完了

画面で手動

二重計上の危険

低い(明細から登録するため)

低い

低い

高い

人の手作業

一覧の確認・同期

仮払金での登録

ルールの確認・CSV操作

消込の照合

AIに任せられる範囲

判定〜登録〜確認まで

判定と振替

判定とルール案

判定と登録

前提条件

消込APIを実行できる環境

特になし

特になし

特になし

おすすめの場面

消込APIが使えるなら最優先

API提供を待つ間の主力

定型取引が多い事業者

件数が少ない場合

消込APIが使える環境では基本フローを主力にし、定型取引は自動登録ルールに任せる組み合わせが、手間と確実さのバランスが最も良くなります。


freee標準機能とMCPの最適な役割分担

freee MCPリモート版でAIエージェントとfreeeを接続する手順の告知画像

出典: フリー株式会社 公式プレスリリース(リモート版)

消込APIの追加で、AIに任せられる範囲は大きく広がりました。それでも「明細の同期」と「判断が要る仕訳の承認」は、人とfreeeの画面に残ります。

機能別の役割分担表(2026年10月時点)

業務

freee MCP(AI)

freee画面・標準機能

人の判断

カード明細の同期

不可(同期APIは未提供)

画面で同期

—

明細の取得・分類

得意(科目・税区分の案を作る)

「自動で経理」で一覧

案の確認

明細からの取引登録+消込

可能(create_deal。提供範囲は要確認)

「自動で経理」から登録

実行してよい行の承認

未決済取引との消込

可能(reconcile。提供範囲は要確認)

画面で消込

差額の扱い

カード代金の引き落とし

可能(create_transfer)

画面で口座振替

—

定型取引の自動処理

ルール案の作成・適用(user_matchers/apply)

自動登録ルール

ルールの承認

間違いの取り消し

可能(reset)

画面で取り消し

残った取引の削除判断

試算表・帳簿の確認

得意(抽出・前月比分析)

レポート画面

異常値の判断

領収書のアップロード

ローカル版のみ(freee_file_upload)

アプリで撮影・送信

—

電子契約(freeeサイン)

ローカル版のみ

freeeサインの画面

—

推奨する運用サイクル

随時:

  • 経費が発生したら、AIに科目案を聞いて判断材料を貯める
  • 領収書はローカル版ならAIからファイルボックスへ、リモート版ならfreeeアプリで送る

週次:

  • freeeの画面でカード口座を同期する
  • AIに未処理明細を取得・分類させ、確認した行だけ登録・消込させる
  • AIに due_amount と未処理件数を報告させる

月次:

  • カード代金の引き落としを口座振替で処理し、カード口座の残高と請求額が合うか確認する
  • 新しく繰り返し出てきた取引をルール化し、user_matchers/apply で適用する
  • 試算表を取得し、前月比で大きく動いた科目をAIに抽出させる

このツールを自社のシステムや業務にどう組み込むか、ご提案します

初回相談は無料・30分(オンライン)。要件が決まっていなくても大丈夫です。改修100万円〜・PoC300万円〜(税別)

freee MCPの利用にかかる費用の全体像

経理担当者がfreee会計とAIクライアントの費用を検討している様子

freee MCP自体は、リモート版・ローカル版とも無料です。実際にかかるのは、freee会計の契約料金と、接続するAIクライアントの料金です。

freee会計(法人)の料金

プラン

月額表示(2026年10月28日時点)

備考

ひとり法人

公式ページで確認

1人で運営する法人向け

スターター

5,480円/月+従量課金

スタンダード

8,980円/月+従量課金

アドバンス

39,780円/月+従量課金

「高度なAPI連携」「CRMシステム連携」の記載あり

エンタープライズ

問い合わせ

アドバンスの全機能を含む

年払いは「最大25%割引」と表示されています。税込・税抜の別や個人事業主向けプランの料金は、freee会計の料金ページで確認してください。

プランとfreee MCPの関係

プランごとにfreee MCPが使えるかどうかは、公式の料金ページでは明示されていません。アドバンスプランの「高度なAPI連携」は、CRMなど外部サービスとの連携機能を指すもので、freee MCPの利用条件を示すものではありません。

READMEでは、サーベイ・開業・人事評価・申告について「対応する接続環境、OAuthクライアント、契約プラン、利用者権限が必要」とされています。自分のプランで使えるかは、接続後に読み取り操作と少件数の書き込みを試して確認するのが確実です。

AIクライアントの料金

Claude、Cursor、Codexなどは、それぞれ無料枠や月額プラン、従量課金があります。料金と為替は変わるため、導入時に各サービスの公式料金ページで確認してください。カード明細の処理は1回の作業でAPIを何度も呼ぶため、上限の厳しいプランだと月末にまとめて処理するときに足りなくなることがあります。


セキュリティと運用上の注意点

freee MCPで財務データを守るセキュリティ対策のイメージ

消込APIは明細の状態を書き換える操作です。便利になった分、誤った紐付けがそのまま帳簿に残る危険も増えました。権限を絞り、AIには「一覧を作らせて人が承認してから実行」の順序を守らせることが基本です。

freee公式が注意を呼びかけている点

1. 公式以外のURLを入れない

READMEと告知では「freee公式以外のURLを入力しないように」と明記されています。誤ったMCPサーバーを追加すると、財務データが第三者に渡るおそれがあります。

2. 外部ツールは自己責任で使う

freeeヘルプのClaude設定例は、freeeが提供するサービスではなく、免責事項を確認したうえで利用者の責任で外部ツールを使う、という位置づけです。

3. 権限はログインユーザーの範囲で動く

freee MCPは、接続したfreeeユーザーの権限の範囲で操作します。管理者アカウントで接続すると、AIが広い範囲のデータを書き換えられる状態になります。経理用のアカウントを分け、必要な権限だけ付けて接続してください。

ローカル版の注意: 自分で登録したOAuthアプリのClient Secretやトークンが手元の設定ファイルに保存されます。共有PCで使わない、ファイルの権限を絞る、といった扱いが必要です。

消込APIを使うときの5つのルール

  1. 1枚のカード・少件数から始める: 最初は金額の小さい明細数件で結果を確かめる
  2. 登録前に一覧を作らせ、人が承認する: 「まだ登録しないで」と明示し、承認した行だけ実行させる
  3. 事業所を毎回確認させる: 作業の最初に freee_get_current_company で事業所名を確認させる。リクエストの company_id が現在の事業所と違うとエラーになる仕組みもある
  4. 処理後に残りを数える: 明細を再取得し、due_amount と未処理件数を報告させる
  5. deals での直接登録を混ぜない: カード明細がある取引は、明細側(create_deal など)から登録する。deals で登録すると明細が残り、二重計上の原因になる

推奨する段階的な導入ステップ

ステップ1: 読み取りだけで使う(1〜2週間)

試算表の取得や、カード明細の分類案の作成など、参照系の操作だけを使います。AIの判定の癖をつかむ期間です。

ステップ2: 少額の明細で消込を試す

承認した少額の明細だけ create_deal で処理し、画面で処理済みになったか、取引の中身が正しいかを確かめます。

ステップ3: 定常業務に広げる

カード1枚分の月次処理をAIに任せ、金額の大きい取引・初めての取引先・按分が必要な取引は、引き続き人が判断します。

内部統制との整合性

AIによる完全自動化は、内部統制の観点からおすすめしません。社内で次のルールを決めておくと安全です。

  • AIが登録した取引は、承認ワークフロー(approval_flow_status)や月次レビューで人が確認する
  • 一定金額以上の取引は上長の承認を経る
  • AIへの指示と実行結果(作成された取引ID)を記録に残す
  • 月次でカード会社の請求額とfreee上の残高を照合する

チームで試すだけでなく、自社の業務として承認・停止・再実行まで含めてエージェントを動かすなら、権限の分離や実行履歴の保存、失敗時のやり直し手順を仕組みとして用意する必要があります。どこまでを追加で作り込むべきかはAIエージェントの本番導入で追加する開発範囲で整理しています。


よくあるエラーと対処法

消込APIを呼ぶとエラーになる・パスが見つからない

原因の候補: 古いバージョンのfreee MCPを使っている/リモート版にまだ反映されていない/提供範囲・権限の対象外

対処:

  1. ローカル版はv0.37.8以上か確認する(グローバルに入れた古い版が残っていないかも確認)
  2. freee_api_list_paths で /api/1/wallet_txns/{id}/reconcile などが出るか確認する
  3. パスは出るのに実行で弾かれる場合は、提供範囲や権限の問題の可能性がある。当面は仮払金方式などで運用し、freeeの公式発表を確認する

二重計上の検知と修正

症状: 同じ支払いが2件計上されている。カード口座の残高が請求額と合わない。

対処:

  1. AIに「今月のカード口座の取引と、未処理の明細を並べて、金額と日付が一致するものを出して」と頼む
  2. deals で直接登録した取引と、明細から登録した取引が重なっていないか確認する
  3. 不要な取引は人が確認したうえで削除し、明細側の状態(未処理・消込済み)を確かめる
  4. 以後、カード明細がある取引は明細側から登録する運用に切り替える

自動登録ルールを作ったのに明細が処理されない

対処: 既存の未処理明細には user_matchers/apply での適用が必要です。非同期処理なので、時間を置いて再取得してください。登録タイプが「取引を推測する」のルールは、未処理のまま残るという利用者の報告もあります。

消込済みの明細を「無視」にできない

対処: 消込済みの明細は直接無視にできない仕様です。reset で未消込に戻してから ignore を実行します。戻した後に、作られていた取引が残っていないかも確認してください。

明細が最新にならない

対処: 明細の同期はAPIで実行できません。freeeの画面でカード口座を同期してから、AIに明細を取得させます。口座一覧の update_date は同期日時ではないという報告があるため、同期状態は with_last_synced_at を付けて確認します。

OAuth認証エラー

対処:

  1. ブラウザでfreeeにログインできるか確認する
  2. コネクタを一度切断し、接続と認証をやり直す
  3. ローカル版は、アプリのコールバックURLが http://127.0.0.1:54321/callback になっているか確認する

勘定科目の誤判定

対処: 指示に用途を書きます。「Amazonで買い物」ではなく「Amazonでオフィス用の文房具を購入。消耗品費、課税仕入10%」のように具体的に伝え、判定に迷う行は理由つきで分けて出させます。


こんな方におすすめ / おすすめしない方

freee MCPでのクレジットカード仕訳がおすすめな方

  • カード明細が月に数十件以上あり、「自動で経理」の処理に時間を取られている方: 分類と登録・消込をまとめてAIに任せられる
  • 勘定科目や税区分の判断に迷うことが多い方: AIが理由つきで案を出すので、確認に集中できる
  • すでにClaudeやClaude Codeを使っている方: freee MCP自体は無料で、追加の契約なしに始められる
  • 会計事務所で複数の顧問先を扱っている方: 事業所を切り替えて同じ手順を回せる。消込APIの提供状況は確認が必要
  • 定型のSaaS利用料などが多い事業者: ルール案の作成から一括適用までAIに手伝わせられる

経理部門でのAI活用の全体像は会計・経理のAI活用事例、非エンジニアがClaude Codeを業務に使う例はClaude Code 非エンジニア活用事例で紹介しています。

おすすめしない方

  • freee以外の会計ソフトを使っている方: freee専用のツールです
  • AIに確認なしで全部任せたい方: 消込は帳簿を書き換える操作で、人の承認を外す運用はおすすめできません
  • 経理の基礎知識がまったくない方: AIの判定が正しいかを判断できないと、誤りがそのまま帳簿に残ります
  • 今すぐ全利用者向けに消込APIが使える前提で計画したい方: 提供範囲は公式情報で断定できないため、代替パターンでの運用も想定しておく必要があります
  • 社内でAIを財務データに接続する許可が出ていない方: 先に社内規程の確認が必要です
  • リモート版でfreeeサインや領収書のアップロードを使いたい方: 2026年10月時点ではローカル版だけの機能です

よくある質問(FAQ)

Q1. freee MCPは無料で使えますか?

freee MCP自体は、リモート版・ローカル版とも無料です。別にfreee会計の契約と、接続するAIクライアントの料金がかかります。freee会計(法人)は、スターター5,480円/月、スタンダード8,980円/月(いずれも従量課金あり)などの料金が公式に表示されています。

Q2. クレジットカードの消込はAPIでできるようになったのですか?

2026年10月26日にfreee会計APIへ消込用のエンドポイントが追加され、freee MCPもv0.37.8で対応しました。一方で、9月のプレスリリースでは「まずfreee認定アドバイザー向けに順次提供、その他の利用者への拡大時期は未定」とされています。自分の環境で freee_api_list_paths にパスが出るか、1件試して実行できるかで確認してください。

Q3. リモート版でも消込APIは使えますか?

ローカル版(npm・GitHub)のスキーマ反映は確認できていますが、リモート版(mcp.freee.co.jp)への反映時期は公表されていません。リモート版でパスが見つからない場合は、ローカル版の最新バージョンで試すか、反映を待ってください。

Q4. freee MCPで登録した仕訳はインボイス制度に対応していますか?

freee MCPはfreeeのAPIで取引を登録するため、freee会計側のインボイス対応の仕組みがそのまま使われます。ただし、税区分や取引先の登録番号はAIの判定や指示の内容に左右されるので、登録後に確認してください。

Q5. Claude以外のAIクライアントでも使えますか?

READMEには、Claude Code、Cursor、OpenCode、GitHub Copilot、Codex、Gemini CLIなどが対応クライアントとして載っています。MCPに対応したクライアントなら接続できる設計です。ChatGPTからの具体的な接続手順は、2026年10月時点で公式資料では確認できていません。

Q6. 経理担当者がプログラミング知識なしで使えますか?

リモート版なら、URLを追加してログインするだけで使い始められます。日常の操作も日本語の指示で行えます。ローカル版やスキルの導入にはターミナルでのコマンド操作が必要です。

Q7. 消込を間違えたら元に戻せますか?

reset で、無視・消込済みの明細を未消込に戻せます。ただし、create_deal などで作られた取引が自動で消えるかは公式資料で確認できていません。戻した後に取引一覧を見て、不要な取引が残っていれば削除してください。

Q8. freeeサインの電子契約もfreee MCPで操作できますか?

ローカル版の freee-sign-mcp(8ツール)で、文書・フォルダ・テンプレートなどを操作できます。リモート版は2026年10月時点で「準備中」です。


freee MCPを安全に活用するための3つのポイント

freee MCPは、2026年10月の消込API追加によって、クレジットカード明細の取得から登録・消込・確認までをAIに任せられる段階に入りました。ただし提供範囲には公式情報の食い違いがあり、明細の同期は画面に残ります。

ポイント1: まず自分の環境で消込APIが使えるか確かめる

ローカル版はv0.37.8以上か確認し、freee_api_list_paths でパスが出るか、少額の明細1件で実行できるかを見ます。使えなければ、仮払金方式などの代替パターンで運用します。

ポイント2: カード明細がある取引は明細側から登録する

deals で直接登録すると明細が残り、二重計上の原因になります。経費は create_deal、未決済取引は reconcile、引き落としは create_transfer と、種類ごとに使い分けます。

ポイント3: 一覧の作成と実行を分け、人が承認する

AIには先に分類案を作らせ、人が承認した行だけ実行させます。処理後は due_amount と未処理件数で残りを確かめ、権限は必要な範囲に絞ってください。


関連記事:

このツールを自社のシステムや業務にどう組み込むか、ご提案します

この記事の著者

AI革命

AI革命

編集部

AI革命株式会社の編集部です。最新のAI技術動向から実践的な導入事例まで、企業のデジタル変革に役立つ情報をお届けしています。豊富な経験と専門知識を活かし、読者の皆様にとって価値のあるコンテンツを制作しています。

AI・システム開発は、開始価格を公開しています

既存システムの改修 100万円〜・PoC 300万円〜(税別)。相談内容を送っていただくと、2営業日以内に担当者からご返信します