freee Claude会計連携 — Claude Codeで仕訳・記帳を確認する手順

freee-mcpとは何か

freeeは2026年3月2日、freee会計をはじめとする基幹業務をAIエージェントから直接操作できるMCPサーバー「freee-mcp」を公式OSSとして公開しました。対応するのは会計・人事労務・請求書・工数管理・販売・IT管理の6領域で、約270本のfreee APIがMCPツールとして呼び出せます。Claude Codeから接続すれば、仕訳の内容確認や記帳漏れのチェックを、チャットの指示だけで進められます。

freee-mcpはMCPサーバー本体と「Agent Skills」の2つで構成されています。MCPサーバーがAPI呼び出し・認証・リクエスト検証を担当し、Agent SkillsがAPIリファレンスと操作レシピをAIのコンテキストに注入する役割です。この分担により、Claudeは会計・人事労務など101本のスキルファイルから必要な仕様だけを段階的に読み込み、正確なパラメータでAPIを呼び出せます。Claude / Claude Desktopを含めた接続方法全体の比較はClaude freee連携の設定手順 — Remote MCPとPluginの使い方にまとめており、本記事はClaude Codeでの仕訳・記帳確認に絞って扱います。

接続方法を選ぶ

Claude Codeからfreee-mcpを使う経路は3つあります。どれを選ぶかで、セットアップの手間と扱える範囲が変わります。

リモートMCPはfreeeが自前でホストするサーバーに接続する方式で、ローカルでの環境構築が要りません。URLはhttps://mcp.freee.co.jp/mcp固定で、これ以外のURLを追加しないよう公式が明記しています。まず使い勝手を確かめたい場合は、この方式から始めるのが手早い選択です。

ローカルMCPサーバーは、freeeアプリストアで自分のアプリケーションを登録し、Client ID・Client Secretを取得したうえでnpx freee-mcp configureを実行する方式です。対話式ウィザードが認証情報の設定・OAuth認証・事業所選択まで進めます。権限スコープを自分で絞り込みたい場合や、社内のセキュリティポリシー上リモートサーバー経由を避けたい場合はこちらを選びます。

Claude Code Pluginは、MCPサーバーとAgent Skillsをまとめて扱える方式です。この方式ではAPIリファレンスの参照も同じコマンド経路で管理できるため、あとから個別にスキルを追加する手間が省けます。

Claude Codeへの追加手順

Pluginとして導入する場合は、次の2つのコマンドを順に実行します。

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

Claude Codeのプロンプト内からスラッシュコマンドで実行することもできます。

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

Agent Skillsだけを個別に追加したい場合は、npmパッケージのskillsコマンドが使えます。

npx skills add freee/freee-mcp

GitHub CLI(v2.90.0以降)を使っている場合は、gh skillコマンドから--agent claude-codeを指定してインストールする経路もあります。ローカルMCPサーバーを選んだ場合は、configureの出力をそのままClaude Codeの設定に貼り付ける形です。

導入後、最初に実行すべきはOAuth認証です。freee_authenticateツールが認証を担当し、freee_auth_statusで状態を確認できます。複数事業所を扱っている場合は、freee_set_current_companyで操作対象の事業所を明示してから作業を始めます。事業所を切り替えずに進めると、意図しない事業所のデータを触ってしまう事故につながります。認証の仕組み自体(OAuth 2.0 + PKCEやトークンの自動更新)は、リモートMCP全般に共通する話としてリモートMCPのOAuth認証 — 仕組みとClaude Codeでの実装変化でも扱っています。

仕訳・記帳を確認させるプロンプトの書き方

freee-mcpの基本ツールは、HTTPメソッドに対応したfreee_api_get/freee_api_post/freee_api_put/freee_api_delete/freee_api_patchの5つです。エンドポイントのパスはOpenAPIスキーマに対して自動検証されるため、存在しないパラメータを渡すとその場でエラーになります。

仕訳確認で効くのは、確認したい範囲と観点を先に絞ることです。「今月の取引を見て」だけでは、Claudeがどこまで遡って何を基準にチェックするかが揺れます。

今月(2026年8月)に登録された取引のうち、以下の観点でおかしい可能性がある
行を一覧にしてください。
 
- 対象: freee_api_get で /api/1/deals から今月分を取得
- チェック観点:
  1. 税区分が未設定、または金額と税額の計算が合わない
  2. 同じ取引先・同じ金額の重複登録の疑い
  3. 勘定科目が「仮払金」「仮受金」のまま1か月以上放置
- 出力: 取引ID・取引先・金額・該当した観点・簡単な理由 の一覧
- 判断に迷うものは「要確認」として理由とともに残す。自動で修正しない

最後の1行が重要です。freee-mcpはfreee_api_putやfreee_api_patchで実際にデータを書き換えられるため、指示を曖昧にしたまま実行させると、確認のつもりが更新になってしまうことがあります。読み取りだけを頼む段階では、書き込み系ツールを使わせない前提を明示しておくと事故が減ります。

過去の取引を参考にしたい場合は、類似データを取得させてから作業させる進め方が公式にも案内されています。請求書作成なら過去の請求書を参照して取引先・品目・税区分を揃え、経費精算なら過去の申請を参照して勘定科目や部門の指定を揃える、という使い方です。

経費申請や請求書データを扱うときの注意点

会計APIのAgent Skillsには、取引・勘定科目・取引先・請求書に加えて経費申請の操作レシピも含まれています。経費申請の下書き作成や一覧取得はfreee-mcp経由でも行えますが、承認の実行そのものをどう設計するかは、接続先がClaude CodeかCoworkかで扱いが変わります。承認フローに寄せた運用はfreee×Coworkで月次経費精算の承認フローを自動化するで扱っています。

company_idをリクエストに含める場合は、現在選択中の事業所と一致していないとエラーになります。複数事業所を1つのセッションで行き来する運用では、操作の直前にfreee_get_current_companyで確認する一手間が、誤った事業所へのAPI呼び出しを防ぎます。

よくあるつまずき

認証が通らない: OAuthのコールバックURLはhttp://127.0.0.1:54321/callback固定です。freeeアプリストア側で登録したコールバックURLとずれていると、configure実行時の認証で失敗します。

ツールが見当たらない: Claude Code Pluginで導入した場合、MCPサーバーとAgent Skillsは別々のコンポーネントです。プラグインのインストールだけでスキルが自動で入るとは限らないため、/plugin一覧でfreee-mcpが有効になっているかを確認します。

事業所を間違えて操作した: freee_set_current_companyを挟まずに複数事業所を横断すると起きやすい事故です。事業所名だけでなくfreee_list_companiesで事業所IDまで確認してから切り替える手順にしておくと安全です。

電子契約(freeeサイン)のツールが動かない: freeeサインのAPIはfreee-sign-mcpという別コマンドで提供されており、リモートMCPでの提供は準備中です。ローカルでのMCPサーバー起動のみサポートされているため、会計・請求書系と同じ感覚でリモート接続を試すと見つかりません。

これらの原因を1つずつ潰しても接続できない場合は、設定・起動・認証・ツール表示の4層に分けて切り分ける進め方があります。freee-mcp固有ではないMCP共通のつまずきどころはMCPサーバーに接続できないときの切り分け手順にまとめています。

よくある質問

freee-mcpは無料で使えますか

freee-mcp自体はApache-2.0ライセンスのOSSで、GitHubから無料で入手できます。ただし操作対象はfreeeの契約プランに紐づくデータのため、freee側の契約プラン・利用料金は別途必要です。

Claude DesktopとClaude Codeで手順は違いますか

リモートMCPの接続はどちらも「カスタムコネクタを追加」でURLを登録する操作で共通です。ローカルMCPサーバーの場合、Claude Desktopは設定ファイルへのJSON追記、Claude Codeはプラグインまたはnpx skills addによるスキル追加という違いがあります。

Cursorなど他のAIツールからも使えますか

使えます。公式READMEにはCursor・Codex・GitHub CLI(gh skill)への対応が明記されています。リモートMCPはURL登録という共通の仕組みのため、MCPクライアントとして動作するツールであれば接続できる可能性があります。

複数の事業所を1つのAIセッションで扱えますか

扱えます。freee_set_current_companyで操作対象を切り替えられますが、切り替え忘れによる誤操作を避けるため、事業所を跨ぐ作業の前には現在の事業所を毎回確認する運用が安全です。

まとめ

freee-mcpは、freeeが公式に提供するAPIをMCPツールとして開放したことで、Claude Codeから会計データへ直接アクセスできるようにした仕組みです。接続方法はリモートMCP・ローカルMCPサーバー・Claude Code Pluginの3つがあり、まず試すならリモートMCP、権限を絞りたいならローカル、まとめて管理したいならPluginという使い分けになります。

仕訳や記帳のチェックに使う際は、確認したい範囲と観点を先に絞り、書き込み系ツールを使わせない前提を明示することが事故を防ぎます。freee_api_deleteのような不可逆な操作を伴うツールが同じ経路で呼び出せる点は、権限設計の段階で意識しておく必要があります。