AIツール2026年5月更新

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

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

この記事のポイント

freee MCPでクレジットカード仕訳を登録する手順・消込問題の解決パターン4種・セキュリティ注意点を実務視点で解説。2026年5月時点の最新情報(v0.26.6・freeeサイン対応・API約330本)に更新。

freee MCPは、Claude DesktopやClaude CodeなどのAIエージェントから、freee会計の仕訳登録・帳簿確認・請求書作成を自然言語で操作できる公式ツールです。「法人カードでAWS利用料12,000円を通信費で登録して」と話しかけるだけで仕訳が完了します。

ただし、クレジットカード明細と取引の紐付け(消込)はfreee APIの仕様上、直接実行できません。 これがfreee MCP活用における最大のハードルであり、知らずに使うと二重計上のリスクがあります。

この記事では、freee MCPのセットアップからクレジットカード仕訳の登録方法、そしてAI革命が推奨する消込問題の具体的な解決パターンまで、実務で必要なフローを体系的に整理します。対象バージョンは2026年5月11日リリースのv0.26.6(freeeサイン対応・API約330本)です。

この記事でわかること:

  • freee MCPの初期設定手順(リモート版・OSS版)
  • クレジットカード仕訳をAIで登録する具体的なプロンプト例
  • 消込がAPI経由でできない理由と、AI革命推奨ワークフロー+3つの解決パターン
  • freee標準機能とMCPの最適な役割分担
  • セキュリティ設計と運用上の注意点
  • 全体の費用感(freee会計 + AIクライアント)

想定読者: freee会計を利用中の個人事業主・中小企業の経理担当者で、AIによる経理業務の効率化を検討している方。会計の基礎知識(仕訳・勘定科目)がある前提で進めます。freee MCPがどのようなAIエージェントとして機能するのか、基本から理解したい方にはAIエージェントとは? 仕組み・種類・活用事例をわかりやすく解説もあわせてご覧ください。


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

freee MCPの概要 — AIエージェントからfreeeの基幹業務を操作可能にする公式ツール

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

freee MCPは、フリー株式会社が2026年3月に公開した、AIエージェントとfreee会計を接続するための公式ツールです。MCP(Model Context Protocol)という標準規格を使い、約330本のfreee APIを自然言語で操作できるようにします。AIコーディングツールやチャットAIをfreeeの「手足」として機能させる仕組みと捉えるとわかりやすいでしょう。

基本情報

項目

内容

開発元

フリー株式会社(freee K.K.)

初回公開

2026年3月2日(OSS版)

リモート版提供開始

2026年3月27日

freeeサイン対応

2026年4月10日(OSS版のみ)

最新バージョン

v0.26.6(2026年5月11日リリース)

ライセンス

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

freee MCP自体の料金

無料

対応AIクライアント

Claude Desktop、Claude Code、Claude Cowork、Cursor など

対応API領域(2026年5月時点)

会計・人事労務・請求書・工数管理・販売・サイン(電子契約)

APIツール総数

約330本

認証方式

OAuth 2.0 + PKCE

何ができるのか

freee MCPで実行できる主な操作は以下のとおりです。

  • 仕訳・取引の登録: 「タクシー代2,800円を旅費交通費で登録して」のように自然言語で入力
  • 帳簿の参照・確認: 試算表の取得、登録済み仕訳の一覧表示、前月比分析
  • 請求書の作成: 取引先登録から請求書発行まで一連の操作
  • 経費申請の管理: レシート画像のファイルボックスへのアップロード(OSS版のみ)
  • 経営分析: 月次レポート生成、BS/PL分析、変動要因の抽出
  • 勤怠管理: 打刻操作、給与明細の確認
  • 電子契約(freeeサイン)の操作: 文書・フォルダ・テンプレートの管理(OSS版のみ)
  • 複数事業所の切り替え: company_id指定で複数拠点を動的に操作

2026年4月以降の主なアップデート

freee MCPは公開から2ヶ月あまりで急速に機能拡張されています。

時期

内容

2026年3月2日

OSS版(ローカル版)公開。会計・人事労務・請求書・工数管理・販売の5領域、約270本のAPI対応

2026年3月27日

リモート版の提供開始。URL入力のみで接続可能に。非エンジニアでも導入しやすくなった

2026年4月10日

freeeサイン(電子契約)対応を追加。 API数が約270本→約330本に拡大。販売データとの連携した契約管理が可能に(OSS版のみ、リモート版は今後対応予定)

2026年4月22日〜5月11日

v0.25.0〜v0.26.6まで2週間で複数回の更新。活発なメンテナンスが続いている

freeeサイン対応の追加により、見積・受注から契約締結まで一連の営業プロセスをfreee MCPで操作できるようになりました。ただし、現時点ではリモート版はfreeeサインに非対応です。電子契約機能を利用したい場合はOSS版での接続が必要になります。

MCP単体では不十分 — Agent Skillsの併用が必須

freee MCPを正しく使うには、MCP本体に加えて「Agent Skills」の設定が必要です。Agent Skillsは、APIリファレンスと操作レシピを段階的にAIのコンテキストへ注入する仕組みで、75ファイル以上の知識ベースを含みます。

Agent Skillsなしで使うと、約330本のAPI定義がコンテキストウィンドウを圧迫し、AIが試行錯誤を繰り返してRate Limitに到達するリスクが高まります。公式でもMCPとAgent Skillsの併用が推奨されています。


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

freee MCPリモート版の概要 — ローカル設定不要でURL接続のみで利用可能

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

freee MCPには2つの導入方法があります。現時点では、設定が簡単なリモート版が推奨です。

リモート版 vs OSS版の比較

比較項目

リモート版(推奨)

OSS版(ローカル)

設定の手間

URL入力のみ

npm install + 環境変数設定

サーバー管理

freeeがホスト

自分のマシンで稼働

アップデート

自動反映

手動で npm update

接続URL

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

localhost

カスタマイズ性

低い

高い(ソースコード編集可能)

freeeサイン対応

今後対応予定(未対応)

対応済み

ファイルアップロード

不可

可能

向いている人

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

電子契約対応・高度なカスタマイズが必要な開発者

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

Step 1: freeeアカウントとプランの確認

freee会計のスタンダードプラン以上に加入していることを確認します。一般的な取引登録・帳簿参照はスタンダードプランで利用可能です。高度なAPI連携(詳細なレポート連携等)にはアドバンスプランが必要な場合があります。プランとAPI連携の詳細な対応範囲はfreee公式の料金ページで最新情報をご確認ください。

Step 2: AIクライアントにMCPサーバーを追加

Claude Desktopの場合、設定ファイル(claude_desktop_config.json)に以下を追加します。

{
  "mcpServers": {
    "freee": {
      "url": "https://mcp.freee.co.jp/mcp"
    }
  }
}

Step 3: Agent Skillsの導入

Claude Codeの場合、以下のコマンドでAgent Skillsをインストールします。

npx skills add freee/freee-mcp

Claude Desktopの場合は、公式GitHubリポジトリ(https://github.com/freee/freee-mcp)のREADMEに記載された手順に従い、プロジェクトナレッジとしてSkillファイルを追加します。

Step 4: OAuth認証

初回接続時にfreeeのOAuth認証画面が表示されます。ログインして「許可」をクリックすれば、AIクライアントからfreee会計へのアクセスが有効になります。

Step 5: 動作確認

セットアップ完了後、以下のようなプロンプトで正常動作を確認します。

freeeの認証状態を確認して
事業所の情報を取得して

正常に応答が返ればセットアップ完了です。

OSS版のセットアップ

OSS版はnpmパッケージとしてインストールします。Node.js v24.3.0以上が必要です(2026年5月時点)。

npm install -g freee-mcp
freee-mcp configure

freeeアプリ登録の手順(OSS版のみ必要):

  1. freee開発者向けサイトでプライベートアプリを作成
  2. コールバックURL: http://127.0.0.1:54321/callback に設定
  3. Client IDとClient Secretを取得(後から再表示不可のため必ず保存)

テスト事業所を使って安全に検証する

本番freeeに直接接続されることに不安を感じる場合、freee開発者ページでテストアカウントを登録するとテスト事業所が約15〜30分で自動作成されます。 サンプルデータ入りの別環境で動作確認してから本番運用に移行できるため、初期設定に不安がある方はまずテスト事業所で試すことを推奨します。

詳細な手順はfreee公式GitHubリポジトリのREADMEおよびZenn等の公開セットアップガイドを参照してください。

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

ケース

問題

対処法

勘定科目が曖昧

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

用途を明記する(「オフィス用の文房具」など)

消費税区分

海外サービス(AWS等)の税区分

「課税仕入10%」「対象外」などを明示する

口座の選択

複数カード登録時にどのカードか不明

カード名を具体的に指定する(「JCB法人カード」など)

日付のずれ

利用日と計上日の違い

「利用日は3月28日、計上は3月分で」と指定する

登録後の確認プロンプト

仕訳の登録後は、必ず内容を確認する習慣をつけてください。

今日登録した仕訳を一覧で確認して
今月のクレジットカード関連の取引を一覧表示して

金額・勘定科目・消費税区分に誤りがないかを目視チェックし、問題があれば修正指示を出します。


「消込」問題の正体 — freee MCP最大のハードルを理解する

freee MCP — AIエージェントからfreee会計を自然言語で操作できる公式ツールの概要」 width=

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

freee MCPでクレジットカード仕訳を扱う際、最も注意すべきなのが「消込(けしこみ)」の問題です。現時点では、freee APIにこの処理を直接実行するエンドポイントが存在しないため、MCP経由だけでは完結しません。

そもそも消込とは何か

消込とは、freeeに同期されたクレジットカードや銀行口座の明細データと、帳簿上の取引データを紐付ける操作のことです。

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

  • 明細(wallet_txn): クレジットカード会社や銀行から自動取得される入出金データ
  • 取引(deal): ユーザーまたはAPIが登録した仕訳データ

この2つを紐付けること=「消込」です。消込が完了して初めて、freee上で「この明細は処理済み」として扱われます。

なぜfreee MCPでは消込ができないのか

freee APIには、明細(wallet_txn)と取引(deal)を直接紐付けるエンドポイントが存在しません。 これはfreee APIの仕様上の制約であり、freee MCPの不具合ではありません。

そのため、以下のような状況が発生します。

  1. freee MCPで仕訳を登録する(POST /api/1/deals → 成功)
  2. 帳簿上には取引が記録される
  3. しかし、「自動で経理」画面に表示されるクレジットカード明細は未処理のまま残る
  4. 未処理の明細を放置すると、別の担当者が同じ取引を重複登録してしまう恐れがある

結果: 二重計上のリスクが発生します。

例えば以下のようにプロンプトを入力しても、法人カードのウォレットトランザクションが消し込まれることなく、独立した旅費交通費のdealが作られてしまいます。

法人カードで支払った新幹線代32,000円を旅費交通費で登録して

この問題はGitHub Issue #313として報告されており、2026年5月時点でもオープン(未解決)の状態です。実務者からも「明細と取引を直接紐づけるエンドポイントが存在しない」という報告が複数あがっています。対応時期は公式から発表されていないため、以下の解決パターンで運用するのが現実的な対応です。


消込を解決する実践パターン — AI革命推奨ワークフロー+3つの方式

freee MCPの利用フロー — AIエージェントからfreee会計への操作イメージ

freee APIの消込制約を乗り越える方法は複数ありますが、まずは当メディアが実務で検証済みの最も効率的なワークフローを紹介します。

AI革命推奨:仕訳待ちURL+仮払金ワークフロー

消込のAPI制約を回避しながら、すべての仕訳操作をMCP経由で完結させる方法です。 freee管理画面への手動操作を最小限に抑えられるため、AI活用の効果を最大化できます。

手順:

  1. AIに「支出の未仕訳一覧URL」「収入の未仕訳一覧URL」をそれぞれ出してもらう(freee管理画面のフィルタリングURL、「自動で経理」のページ)
  2. そのURLを確認しながら、未確定の取引を「仮払金」(支払い側)または「仮受金」(収入側)で一時的に仕訳する(ここだけ人間の手作業)
  3. MCPを通じてAIに、仮払金と仮受金を正式な勘定科目(通信費、売上高など)に振り替えるよう依頼する(MCP経由)

活用プロンプト例:

① まず未仕訳一覧URLを取得する

freee管理画面で「支払い待ち」の仕訳を絞り込めるURLを出して。
同様に「収入待ち」の仕訳一覧URLも作成して

(URLは変わらないので、覚えさせておくことを推奨)

② URLを確認しながら、手作業で仮払金・仮受金に一括仕訳(プロンプトは打たない)

③ 振替をAIに依頼する

仮払金と仮受金となっている取引について適切に仕分けして。不明なところはリストにして出して。

メリット:

  • freeeのAPI制約(消込が直接できない)を回避しながら、すべての仕訳操作をMCP経由で完結できる
  • 仕訳待ちURLで確認漏れ・二重計上を防止できる
  • 月末の消込作業が大幅に削減される

デメリット:

  • 仮払金→正式科目への振替作業が発生する(ただしMCP経由で自動化可能)
  • 仮計上中は科目が正式ではないため、月次レポートで注意が必要

このワークフローが有効な理由: 他のパターンでは「消込のためにfreee管理画面を操作する」手順が残りますが、この方式はfreee管理画面での消込操作自体を不要にするアプローチです。仮払金・仮受金という会計上の正規の処理を活用するため、帳簿の正確性も維持できます。


その他の解決パターン

上記のAI革命推奨ワークフローに加え、以下の3つのパターンも状況に応じて活用できます。

パターン1: CSVインポート方式

AIに仕訳の判定を任せつつ、freeeへの登録は「自動で経理」経由で行う方法です。消込も同時に完了するため、二重計上リスクがありません。

手順:

  1. クレジットカード明細をCSVでエクスポート(またはfreeeの「自動で経理」画面から一覧取得)
  2. freee MCPまたはAIに明細を渡し、各行の勘定科目・取引先・税区分を判定してもらう
  3. AIが判定結果を自動登録ルール用のCSVとして出力
  4. freee管理画面からCSVをインポート
  5. 「自動で経理」画面で一括登録 → 明細と取引が自動で紐付き、消込も完了

メリット:

  • 消込が自動で完了する
  • 二重計上リスクがない
  • AIの判定ミスを一括確認画面でチェックできる

デメリット:

  • CSVエクスポート・インポートの手作業が発生する
  • リアルタイム性がない(バッチ処理型)
  • CSVはShift-JISまたはUTF-8 BOM形式が必要。全角・半角の不一致が自動登録ルールのマッチングを失敗させることがある

活用プロンプト例:

以下のクレジットカード明細のCSVデータについて、
各行の勘定科目・税区分・取引先を判定して、
freee自動登録ルール用のCSV形式で出力して

[CSVデータを貼り付け]

パターン2: MCP登録 + 手動消込の併用

仕訳の登録はfreee MCPで行い、消込だけfreee管理画面で手動処理する方法です。

手順:

  1. freee MCPで仕訳を登録(日常の経費入力を自然言語で実行)
  2. 週次または月次で、freee管理画面の「自動で経理」を開く
  3. 未処理明細と既存取引を手動で照合・紐付け
  4. 紐付け済みの明細を「既存取引の消込」として処理

メリット:

  • 日常の仕訳入力はAIで効率化できる
  • 消込の頻度を自分でコントロールできる

デメリット:

  • 消込が自動化できず、手作業が残る
  • 未処理明細が溜まると照合が煩雑になる
  • 二重計上リスクを常に意識する必要がある

運用のコツ: 明細と取引の照合作業は週1回以上行い、未処理明細を溜めすぎないことが重要です。

パターン3: 自動登録ルール + MCP分析の組み合わせ

freeeの「自動登録ルール」機能を活用し、定型的なクレジットカード取引は自動処理。イレギュラーな取引のみfreee MCPで判断・登録する方法です。

手順:

  1. freee MCPで過去の取引パターンを分析してもらう
  2. AIが提案する自動登録ルールをfreeeに設定
  3. 定型取引(毎月のSaaS利用料・定期的な仕入れなど)は自動登録ルールで自動処理
  4. イレギュラーな取引は「自動で経理」画面で個別判断。必要に応じてfreee MCPに勘定科目を相談

メリット:

  • 定型取引は完全自動化できる
  • 消込も自動登録ルール経由で完了する
  • freee MCPの出番を「判断が必要な場面」に限定できる

デメリット:

  • 自動登録ルールの初期設定に手間がかかる
  • ルールに該当しない取引は手動対応が必要

活用プロンプト例:

今月の法人カード明細を取得して、
毎月繰り返し発生しているパターンを抽出して。
自動登録ルールに設定すべき候補を一覧にして

全パターンの比較

比較項目

AI革命推奨: 仮払金方式

パターン1: CSV

パターン2: MCP + 手動消込

パターン3: 自動ルール + MCP

消込の完了

不要(仮計上→振替)

自動

手動

定型は自動・非定型は手動

二重計上リスク

低い(URL確認で防止)

低い

高い(要注意)

中程度

MCP完結度

高い(全操作MCP可)

低い(CSV手作業あり)

中程度

中程度

リアルタイム性

高い

低い(バッチ型)

高い

高い

手作業の量

振替指示のみ

CSV操作

消込の手動照合

初期設定

向いている場面

MCP活用を最大化したい

月次の一括処理

即時の経費入力

定型取引が多い事業者

推奨度

最も推奨

安全

要注意で運用可

長期的に最適

実務での推奨: AI革命推奨の仮払金ワークフローを基本とし、定型取引はパターン3(自動登録ルール)と組み合わせるのが最も効率的です。freee管理画面の操作を極力減らしたい場合は仮払金方式、消込の確実性を最優先したい場合はパターン1のCSV方式を選択してください。


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

freee MCPリモート版セットアップ — URL接続のみでAIエージェントとfreeeを連携する手順」 width=

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

freee MCPですべてを自動化しようとすると、消込問題のほか、さまざまな制約に直面します。freee標準機能とMCPの得意分野を理解し、適材適所で使い分けるのが成功のポイントです。

機能別の役割分担表

業務

freee MCP(AI)

freee標準機能

仕訳の勘定科目判定

得意 — 自然言語で判断・提案

自動登録ルールで対応可

取引の登録

可能 — APIで直接登録

手入力 or 自動登録

明細との消込

不可 — API未対応

「自動で経理」で処理

口座振替の登録

可能 — transfers API

手動入力

試算表・帳簿の確認

得意 — 自然言語で抽出・分析

画面で確認

前月比分析・異常検知

得意 — AIの強み

レポート画面で確認

請求書の作成

可能 — APIで作成

画面で作成

請求書のメール送信

不可 — API未対応

freee上で送信

レシートのアップロード

可能(OSS版のみ) — ファイルボックスAPI

アプリで撮影・送信

電子契約(freeeサイン)

可能(OSS版のみ) — 文書・フォルダ管理

freeeサインのWeb画面で操作

自動登録ルールの管理

AIが候補を提案

管理画面で設定

配賦計算の自動トリガー

不可 — 計算後の振替伝票として手動登録は可

設定画面で実行

freeeサインについての補足: 電子契約の操作はOSS版のfreee MCPでのみ利用可能です。リモート版ではfreeeサイン対応が今後実装予定のため、現時点では利用できません。

推奨ワークフロー(AI革命流)

日常(毎日〜随時):

  • freee MCPで経費の仕訳登録(自然言語入力)
  • 未確定の取引は「仮払金」「仮受金」で一時計上(MCP経由)
  • freee MCPで登録済み仕訳の確認・修正

週次:

  • AIに生成してもらった「仕訳待ちURL」で未振替の仮払金・仮受金を確認
  • 確定済みの取引をMCP経由で正式な勘定科目に振り替え
  • freee MCPで週次の試算表取得・異常値チェック

月次:

  • freee MCPで月次レポート生成・前月比分析
  • 仮払金・仮受金の残高を確認し、未振替分がないかチェック
  • freee管理画面で口座振替(クレジットカード引き落とし分)の確認

費用の全体像 — 何にいくらかかるのか

中小企業の経理担当者がfreeeとAIクライアントの費用を検討している様子」 width=

freee MCP自体は無料ですが、実際にはfreee会計の契約とAIクライアントの費用が必要です。

コスト内訳(2026年5月時点の概算)

費用項目

月額目安(税抜)

備考

freee MCP

0円

OSS版・リモート版ともに無料

freee会計(個人・スターター)

980円〜

個人事業主向けの最低プラン

freee会計(法人・スターター)

5,480円〜

基本3ユーザー + 従量課金

freee会計(法人・スタンダード)

8,980円〜

API連携が可能なプラン

freee会計(法人・アドバンス)

39,780円〜

高度なAPI連携が必要な場合

Claude Pro(Claude Desktop利用時)

約3,000円($20)

AI側の月額サブスク

Claude Max(大量利用時)

約15,000円〜($100〜)

上限緩和プラン

Claude Code(従量課金)

利用量による

APIトークン消費ベース

Cursor Pro

約3,000円($20)

Cursorで利用する場合

最小構成の費用感

ケース

月額合計(概算)

個人事業主 + Claude Pro

約4,000円〜

法人(小規模)+ Claude Pro

約11,500円〜(スタンダードプラン想定)

法人(中規模)+ Claude Code

約9,000円〜 + 従量課金

freee会計の契約プランは、APIの利用範囲に影響します。一般的な取引登録・取得はスタンダードプランで利用できますが、高度なAPI連携にはアドバンスプラン以上が必要です。料金・プラン内容は変更されることがあるため、freee公式の料金ページで最新情報を必ず確認してください。


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

freee MCPの財務データ保護とセキュリティ対策のイメージ」 width=

freee MCPは本番のfreee会計に直接接続されます。テスト環境は原則存在しないため(OSS版でのテスト事業所活用は可能)、以下のセキュリティ対策が重要です。

freee公式が警告している3つのリスク

1. URL取り違えによる情報漏洩

公式ヘルプでは「誤ったURLを追加すると情報漏洩の可能性がある」と明記されています。リモート版のURL(https://mcp.freee.co.jp/mcp)を正確に入力し、第三者のMCPサーバーURLを誤って設定しないよう注意してください。

2. 第三者MCPサーバーのリスク

freee公式以外のMCPサーバーを利用する場合、通信経路の安全性や情報の秘匿性は当該ツール提供者の規約に準じます。財務データを扱う以上、公式のリモート版またはOSS版のみ使用することを推奨します。

3. 権限管理の不備

freee MCPは、ログインしているfreeeユーザーの権限範囲で動作します。管理者権限でAIを接続すると、すべてのデータにアクセスできる状態になります。専用の経理担当アカウントを用意し、必要最小限の権限でAIを接続するのが安全な運用です。

OSS版固有の注意点: Client SecretとアクセストークンはJSONファイル(~/.config/freee-mcp/config.json)に平文で保存されます。本番環境での使用時はファイルのアクセス権限を適切に制限してください。

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

いきなり全機能を有効にするのではなく、段階的に権限を拡大していく運用が安全です。

ステップ1: 読み取り専用で運用開始

  • 試算表の取得、仕訳の確認など、参照系の操作のみを実行
  • AIの応答精度や操作感を把握する期間(1〜2週間)

ステップ2: 少額取引の登録を許可

  • 少額の経費登録をAIで実行し、必ず人間が確認
  • 「AIが提案 → 人間が承認 → freeeへ登録」のダブルチェックフロー

ステップ3: 定常業務への展開

  • 運用実績と監査体制が整った段階で、日常的な仕訳登録に活用
  • 金額が大きい取引や初回取引先は引き続き人間が確認

内部統制との整合性

freee MCPによる完全自動化は、内部統制の観点から推奨されていません。以下の運用ルールを社内で整備することを推奨します。

  • AIが登録した仕訳は、人間が承認してから確定する
  • 一定金額以上の取引は、必ず上長の承認を経る
  • 全件の監査ログを記録する
  • 定期的に登録内容と明細の照合を実施する

トラブルシューティング — よくあるエラーと対処法

freee MCPの利用中に発生しやすい問題と、その対処法を整理します。

Agent Skills未設定時の症状

症状: AIが大量のAPIを一度に読み込もうとして、応答が極端に遅くなる。または「Rate Limitに達しました」というエラーが返る。

原因: Agent Skillsが未設定のため、約330本のAPI定義がコンテキストウィンドウを圧迫している。

対処: Agent Skillsを正しくインストールする。Claude Codeなら npx skills add freee/freee-mcp を実行。Claude Desktopは公式GitHubのREADMEを参照。

OAuth認証エラー

症状: 「認証に失敗しました」「トークンが無効です」などのエラー。

対処:

  1. freeeにブラウザでログインし、セッションが有効か確認
  2. 一度ログアウト→再ログインしてからMCP接続をやり直す
  3. OAuth連携の許可設定がfreee管理画面で有効になっているか確認

二重計上の検知と修正

症状: 同じ取引が2件登録されている。または帳簿残高が明細と合わない。

対処:

  1. freee MCPで「今月の取引を一覧表示して」と指示し、重複がないか確認
  2. 重複している場合は、freee管理画面から一方を削除
  3. 「自動で経理」画面で未処理明細が残っていないか確認
  4. 消込のフローを見直し、パターン1(CSV方式)またはパターン3(自動登録ルール)への移行を検討

勘定科目の誤判定

症状: AIが不適切な勘定科目を選択している。

対処: プロンプトに用途を明記する。「Amazonで買い物」ではなく「Amazonでオフィス用の文房具(ボールペン10本)を消耗品費で登録して」のように具体的に指示。

APIのRate Limit(429エラー)

症状: 「リクエスト数が上限に達しました」というエラー。

対処:

  • Agent Skillsが正しく設定されているか再確認(未設定の場合、APIが大量に呼び出される)
  • 一度に大量の操作を実行せず、数件ずつ処理する(1事業所あたり1分間に最大120リクエストの制限あり)
  • 時間を置いてから再試行する

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

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

  • freee会計を導入済みで、毎月の経費入力に時間がかかっている方 — 自然言語入力で入力スピードが大幅に向上
  • 勘定科目の判断に迷うことが多い方 — AIが文脈から適切な科目を提案してくれる
  • 月次の帳簿確認や試算表分析を効率化したい方 — 「前月比で変動が大きい科目を教えて」と聞くだけで分析
  • クレジットカード取引が月に20件以上ある方 — 一括登録やパターン分析の効果が大きい
  • すでにClaude ProやClaude Codeを利用している方 — 追加費用なしでfreee MCPを導入できる
  • freeeサインを使って電子契約も効率化したい方(OSS版) — 受注から契約締結まで一元管理が可能

おすすめしない方

  • freee以外の会計ソフト(弥生・マネーフォワード等)を使っている方 — freee専用のツールです
  • 消込まで含めた完全自動化を求める方 — 現時点ではAPIの制約で消込は直接自動化できません
  • 経理の基礎知識がまったくない方 — AIの提案が正しいか判断するには最低限の会計知識が必要
  • 本番環境でのリスクを避けてテスト環境で十分試してから導入したい方 — リモート版はテスト環境なし。ただしOSS版ならfreee開発者ページのテスト事業所を活用できます
  • 社内の承認フローが厳格な企業で、AI利用の許可が下りていない方 — 財務データへのAI接続は社内規定の確認が先です
  • freeeサインをリモート版で今すぐ使いたい方 — 現時点ではOSS版のみ対応。リモート版での利用は今後の対応を待つ必要があります

よくある質問(FAQ)

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

freee MCP自体は無料です(OSS版・リモート版とも)。ただし、freee会計の有料プラン(個人は月額980円〜、法人はスタンダード月額8,980円〜が目安)とAIクライアント(Claude Pro 月額約3,000円など)の費用が別途かかります。

Q2. クレジットカードの消込はいつAPI対応しますか?

現時点で公式からのタイムライン発表はありません。GitHub Issue #313として報告・リクエストされており、2026年5月時点でオープンのままです。対応されるまでは、本記事で紹介した4つの解決パターンで対処してください。

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

freee MCPはfreeeのAPIを通じて仕訳を登録するため、freee会計のインボイス制度対応機能がそのまま適用されます。ただし、適格請求書発行事業者番号や税区分はAIが自動判定するため、登録後に正確性を確認することを推奨します。

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

Claude Code、Claude Cowork、Cursorなど、MCPに対応したAIクライアントであれば利用可能です。freee MCPはMCP標準規格に準拠しているため、特定のAIクライアントに依存しません。

Q5. 複数の事業所を切り替えて使えますか?

はい。freee MCPにはcompany_id検証機能があり、複数事業所の動的切り替えに対応しています。「事業所を○○に切り替えて」と指示するだけで操作対象を変更できます。

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

リモート版であれば、設定はURL入力のみで完了します。日常の操作も自然言語で行うため、プログラミング知識は不要です。ただし、Agent Skillsの導入やOSS版の設定には、最低限のコマンドライン操作が必要です。

Q7. 誤って登録した仕訳は修正・削除できますか?

はい。freee MCPで「さっき登録した旅費交通費を3,300円に修正して」のように指示すれば、APIを通じて修正できます。削除もAPI経由で可能です。ただし、消込済みの取引の修正は、先に消込を解除する必要があります。

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

2026年4月10日のアップデートでOSS版のみ対応が追加されました。文書・フォルダ・テンプレートの管理が約8本のAPIで操作できます。ただし、リモート版では現時点で未対応のため、freeeサインを利用したい場合はOSS版(ローカル版)での接続が必要です。リモート版への対応時期は公式から発表されていません。


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

freee MCPは、クレジットカード仕訳を含む日常の経理業務をAIで大幅に効率化できるツールです。2026年4月以降のfreeeサイン対応追加・v0.26.6への継続的なアップデートで機能は着実に拡張されており、今後の利便性向上も期待できます。ただし、消込の制約を正しく理解し、freee標準機能と組み合わせた運用設計が欠かせません。

ポイント1: 消込問題の正体を理解してから使い始める

freee MCPで仕訳を登録しても、クレジットカード明細(wallet_txn)との消込はAPIで直接完了しません。AI革命推奨の仮払金ワークフローや、自動登録ルールとの組み合わせで回避してください。消込のAPI対応はGitHub Issue #313として報告中(2026年5月時点で未解決)です。

ポイント2: Agent Skillsを必ず設定してから運用を開始する

MCP単体ではAIが約330本のAPI定義を処理しきれずRate Limitに到達するリスクがあります。Claude Codeなら npx skills add freee/freee-mcp を実行してから利用してください。

ポイント3: 段階的に導入し、ダブルチェックフローを維持する

最初は読み取り専用(帳簿の確認・分析)から始め、運用に慣れてから仕訳登録に移行してください。金額の大きい取引や初回取引先は必ず人間が確認するフローを維持することで、AI利用のリスクを管理できます。


関連記事:

AIツールの導入でお困りですか?

お客様のビジネスに最適なAIツールをご提案します。まずは無料相談から。

この記事の著者

AI革命

AI革命

編集部

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

AI活用ならAI革命にお任せ。サービスを見てみる
AI Revolution Growth Arrow

AIでビジネスを革新しませんか?

あなたのビジネスにAIがどのような価値をもたらすかをご提案いたします。