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

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

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

この記事では、freee MCPのセットアップからクレジットカード仕訳の登録方法、そしてAI革命が推奨する消込問題の具体的な解決パターンまで、実務で必要なフローを体系的に整理します。

この記事でわかること：

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

想定読者： freee会計を利用中の個人事業主・中小企業の経理担当者で、AIによる経理業務の効率化を検討している方。会計の基礎知識（仕訳・勘定科目）がある前提で進めます。

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

freee MCPは、フリー株式会社が2026年3月に公開した、AIエージェントとfreee会計を接続するための公式ツールです。MCP（Model Context Protocol）という標準規格を使い、約270本のfreee APIを自然言語で操作できるようにします。

基本情報

何ができるのか

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

• 仕訳・取引の登録: 「タクシー代2,800円を旅費交通費で登録して」のように自然言語で入力
• 帳簿の参照・確認: 試算表の取得、登録済み仕訳の一覧表示、前月比分析
• 請求書の作成: 取引先登録から請求書発行まで一連の操作
• 経費申請の管理: レシート画像のファイルボックスへのアップロード
• 経営分析: 月次レポート生成、BS/PL分析、変動要因の抽出
• 勤怠管理: 打刻操作、給与明細の確認

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

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

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

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

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

リモート版 vs OSS版の比較

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

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

freee会計の有料プランに加入していることを確認します。スターター以上のプランでAPIの基本機能が使えます。

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パッケージとしてインストールします。

npm install -g freee-mcp

設定ファイルでローカルサーバーを指定し、環境変数にfreee APIのクライアントIDとシークレットを設定します。詳細な手順は公式GitHubリポジトリのREADMEを参照してください。

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

登録後の確認プロンプト

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

今日登録した仕訳を一覧で確認して

今月のクレジットカード関連の取引を一覧表示して

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

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

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

そもそも消込とは何か

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

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

• 明細（ウォレットのトランザクション）: クレジットカード会社や銀行から自動取得される入出金データ
• 取引（deals）: ユーザーまたはAPIが登録した仕訳データ

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

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

freee APIには、明細（ウォレットのトランザクション）と取引（deals）を直接紐付けるエンドポイントが存在しません。 これはfreee APIの仕様上の制約です。

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

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

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

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

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

この問題は、freee MCPの不具合ではなく、freee APIの設計に起因するものです。実際に多くのユーザーがこの問題に直面しており、技術ブログでも「消込」問題としてたびたび取り上げられています。

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

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

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

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

手順:

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

活用プロンプト例:

①　

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

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

②

※URLから手作業で仮払金と仮受金に一括仕訳。プロンプトは打たない。

③

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

メリット:

• 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データについて、
各行の勘定科目・税区分・取引先を判定して、
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革命推奨の仮払金ワークフローを基本とし、定型取引はパターン3（自動登録ルール）と組み合わせるのが最も効率的です。freee管理画面の操作を極力減らしたい場合は仮払金方式、消込の確実性を最優先したい場合はパターン1のCSV方式を選択してください。

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

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

機能別の役割分担表

推奨ワークフロー（AI革命流）

日常（毎日〜随時）:

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

週次:

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

月次:

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

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

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

コスト内訳

最小構成の費用感

freee会計の契約プランは、APIの利用範囲に影響します。基本的な取引登録・取得はスタータープランで利用できますが、「高度なAPI連携」と明記されている機能はアドバンスプラン以上が必要です。料金は変更される場合があるため、freee公式サイトで最新のプラン内容を確認してください。

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

freee MCPは本番のfreee会計に直接接続されます。テスト環境は存在しないため、以下のセキュリティ対策が重要です。

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

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

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

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

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

3. 権限管理の不備

freee MCPは、ログインしているfreeeユーザーの権限範囲で動作します。管理者権限でAIを接続すると、すべてのデータにアクセスできる状態になります。

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

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

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

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

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

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

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

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

内部統制との整合性

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

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

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

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

Agent Skills未設定時の症状

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

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

対処: Agent Skillsを正しくインストールする。Claude Codeなら npx skills add freee/freee-mcp を実行。

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

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

対処:

• Agent Skillsが正しく設定されているか再確認
• 一度に大量の操作を実行せず、数件ずつ処理する
• 時間を置いてから再試行する

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

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

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

おすすめしない方

• freee以外の会計ソフト（弥生・マネーフォワード等）を使っている方 — freee専用のツールです
• 消込まで含めた完全自動化を求める方 — 現時点ではAPIの制約で消込は自動化できません
• 経理の基礎知識がまったくない方 — AIの提案を正しいか判断するには最低限の会計知識が必要
• テスト環境で試してから本番運用したい方 — freee MCPにはテスト環境がなく、すべて本番反映されます
• 社内の承認フローが厳格な企業で、AI利用の許可が下りていない方 — 財務データへのAI接続は社内規定の確認が先です

よくある質問（FAQ）

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

freee MCP自体は無料です（OSS版・リモート版とも）。ただし、freee会計の有料プラン（月額980円〜）とAIクライアント（Claude Pro 月額約3,000円など）の費用が別途かかります。

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

現時点で公式からのタイムライン発表はありません。freee APIの明細と取引の紐付けエンドポイントは、開発者コミュニティでもリクエストされている機能です。対応されるまでは、本記事で紹介した3つの解決パターンで対処してください。

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

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

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

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

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

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

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

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

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

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

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

freee MCPは、クレジットカード仕訳を含む日常の経理業務をAIで大幅に効率化できるツールです。ただし、消込の制約を正しく理解し、freee標準機能と組み合わせた運用設計が欠かせません。

ポイント1: 消込はfreee標準機能で処理する

freee MCPで仕訳を登録しても、明細との消込はAPIでは完了しません。「自動で経理」や自動登録ルールと組み合わせて運用してください。

ポイント2: 段階的に導入する

最初は読み取り専用（帳簿の確認・分析）から始め、運用に慣れてから仕訳登録に移行。金額の大きい取引は必ず人間が確認するダブルチェックフローを維持してください。

ポイント3: Agent Skillsを必ず設定する

MCP単体ではAIがAPI定義の処理で詰まります。Agent Skillsを正しく導入してから運用を開始してください。

関連記事:

• AIエージェントとは？ 仕組み・種類・活用事例をわかりやすく解説
• Claudeとは？ 機能・料金・使い方・ChatGPTとの違いを整理
• Claude Codeとは？ できること・料金・使い方を解説
• AIコーディング初心者ガイド｜始め方・ツール選び・注意点