Claude Code × freee-mcp連携｜AIエージェントで会計・請求書・給与データを直接操作する方法

freee公式MCPサーバー「freee-mcp」とClaude Codeを連携させれば、自然言語の指示だけで会計・請求書・給与データをAIエージェントが直接操作できる。月次決算チェックや請求書処理を自動化し、経理担当者が判断業務に集中できる環境が実現する。

「月末になると仕訳の確認に丸一日かかる」「請求書の発行漏れがないか、毎月手作業でチェックしている」。経理部門やCFOがこうした作業に時間を取られている企業は少なくありません。freeeを導入してクラウド会計に移行しても、データの確認・集計・レポート作成は依然として人間の手作業に依存しているケースが大半です。

この課題を根本から解決するのが、freee公式のMCPサーバー「freee-mcp」とClaude Codeの連携です。MCPとはAnthropicが提唱するModel Context Protocolの略で、AIエージェントと外部サービスをUSB-Cのように統一インターフェースで接続する標準プロトコルです。MCPの基本概念については「Claude Code MCP連携の始め方｜HubSpot・freee・Slackを接続する設定手順」で詳しく解説しています。

freee-mcpを使えば、Claude Codeのセッション内で「今月の売上高と経費の内訳を教えて」と聞くだけで、freee会計APIから直接データを取得し、即座に分析結果を返してくれます。APIの仕様書を読んでコードを書く必要はありません。

出典: freee-mcp GitHub リポジトリ

この記事でわかること

CFO・経理担当者・CDO（最高デジタル責任者）で、freeeの会計データをAIエージェントで直接操作したい方に向けた記事です。

• freee-mcpの全体像と対応する5つのAPI — 会計・人事・請求書・工数・販売のデータにアクセスできる仕組みを解説します
• Claude Codeにfreee-mcpを接続する手順 — リモートとローカルの両方のセットアップ方法を紹介します
• 月次決算チェック・請求書処理など実務での使い方 — 自然言語で「未入金の請求書を見せて」と指示するだけで結果が返る活用例を紹介します
• Agent Skillsの仕組み — AIがfreeeのAPI仕様を自動で理解し、正確な操作を行う仕組みを解説します
• freee × HubSpot × Claude Codeの統合活用 — CRMの受注データと会計の入金データを突合して予実管理を自動化する構想を紹介します

freee-mcpとは：freee公式のAIエージェント接続基盤

freee-mcpの概要と対応API

freee-mcpは、freee株式会社がGitHub上でオープンソースとして公開しているMCPサーバーです。Anthropicが策定したModel Context Protocol（MCP）に準拠しており、Claude DesktopやClaude Codeから直接freeeの各種APIにアクセスできます。

freee-mcpが対応している5つのAPIは以下の通りです。

出典: freee-mcp README

Agent Skills：AIエージェントの精度を高める仕組み

freee-mcpの特筆すべき機能が「Agent Skills」です。通常のMCPサーバーは、AIエージェントにAPIのエンドポイント一覧を提供するだけですが、freee-mcpはそれに加えて、APIリファレンスと操作レシピ（手順書）をAIエージェントのコンテキストに自動注入します。

たとえば「売上高の月次推移を出して」と指示した場合、Agent Skillsが適切なAPIエンドポイント、必要なパラメータ、レスポンスの解釈方法をClaude Codeに提供します。これにより、AIエージェントがAPIの仕様を「理解」した上で操作を行うため、誤ったパラメータの送信やデータの誤解釈が大幅に減少します。

freee-mcpのAgent Skillsは、単なるAPI接続を超えた「AIエージェント向け業務マニュアル」です。 APIのエンドポイント情報だけでなく、「この操作を行うには先にこのデータを取得する必要がある」といった操作手順まで含まれているため、Claude Codeは複雑な会計操作も正しい順序で実行できます。freeeのドメイン知識がAIに直接注入される設計は、MCPサーバーの設計思想として非常に先進的です。

OAuth 2.0 + PKCE認証：セキュリティと利便性の両立

freee-mcpの認証にはOAuth 2.0 + PKCE（Proof Key for Code Exchange）が採用されています。PKCEはパブリッククライアント（CLIツールなど、クライアントシークレットを安全に保持できない環境）向けに設計された認証フローで、以下の特長があります。

• 認証コードの横取り攻撃を防止する追加のセキュリティレイヤー
• トークンの自動リフレッシュにより、セッション中に再認証が不要
• 複数事業所の動的切り替えに対応し、グループ企業の管理にも対応

APIトークンを.envファイルに保存する従来の方法と比較して、PKCEベースの認証はトークン漏洩のリスクを低減できます。

Claude Codeにfreee-mcpをセットアップする手順

前提条件

freee-mcpをセットアップする前に、以下の準備が必要です。

• freeeの開発者アカウントとアプリケーション登録（freee Developers Communityで取得）
• Claude Codeの動作環境（Node.js 18以上）
• freeeのOAuth 2.0クライアントID・クライアントシークレット

リモートMCPサーバーとして接続する方法

2026年現在、freee-mcpはリモートMCPサーバーとしての接続をサポートしています。Claude Codeの/mcpコマンドを使って設定します。

# Claude Codeのセッション内で実行
/mcp add freee-mcp -- npx @anthropic-ai/remote-mcp-server https://mcp.freee.co.jp/sse

リモートMCPサーバーを利用する場合、ローカル環境にfreee-mcpをインストールする必要はありません。接続後にブラウザでfreeeのOAuth認証画面が開き、アクセスを許可するだけでセットアップが完了します。

ローカルセットアップの方法

セキュリティ要件やネットワーク制約により、ローカルでMCPサーバーを動作させたい場合は、以下の手順でセットアップします。

# freee-mcpをクローン
git clone https://github.com/freee/freee-mcp.git
cd freee-mcp

# 依存パッケージのインストール
npm install

# 環境変数の設定
export FREEE_CLIENT_ID="your_client_id"
export FREEE_CLIENT_SECRET="your_client_secret"

# MCPサーバーの起動
npm start

Claude Code側では、.claude/settings.jsonに以下のようにMCPサーバーの設定を追加します。

{
  "mcpServers": {
    "freee-mcp": {
      "command": "node",
      "args": ["/path/to/freee-mcp/dist/index.js"],
      "env": {
        "FREEE_CLIENT_ID": "${FREEE_CLIENT_ID}",
        "FREEE_CLIENT_SECRET": "${FREEE_CLIENT_SECRET}"
      }
    }
  }
}

設定後、Claude Codeを再起動するとfreee-mcpが自動的に接続されます。/mcpコマンドでサーバーの接続状態を確認してください。

初回認証フロー

freee-mcpを初めて使用する際は、OAuth 2.0 + PKCEの認証フローが実行されます。

1. Claude Codeでfreeeのデータにアクセスする操作を実行
2. ブラウザが自動的に開き、freeeのログイン画面が表示される
3. freeeアカウントでログインし、アクセス権限を許可
4. 認証トークンが自動的に保存され、以降はトークンリフレッシュで再認証不要

# 認証状態の確認（Claude Code内でfreee-mcpのツールを使用）
# freee_auth_status ツールで現在の認証状態を確認できる

実務での活用パターン：月次決算からレポート生成まで

パターン1：月次決算の自動チェック

経理担当者が月末に行う決算チェックをClaude Codeで自動化する例です。

# Claude Codeへの指示例
「今月（2026年4月）の試算表を取得して、前月比で10%以上変動している
勘定科目をリストアップしてください。変動理由の仮説も添えてください」

Claude Codeはfreee-mcpを通じて以下の操作を自動実行します。

1. freee会計APIで当月・前月の試算表データを取得
2. 勘定科目ごとに前月比を計算
3. 10%以上の変動がある科目を抽出
4. 過去の仕訳データから変動理由を推定

従来であれば、freeeの管理画面でレポートをダウンロードし、Excelで前月比を計算し、変動理由を個別に調査する必要がありました。この一連の作業が、1つの自然言語の指示で完結します。

パターン2：請求書の一括処理とステータス確認

# Claude Codeへの指示例
「今月発行した請求書のうち、入金確認が取れていないものを一覧表示して。
金額が大きい順にソートし、発行日から30日以上経過しているものにはフラグを付けてください」

freee-mcpの請求書APIを通じて、未入金の請求書を即座にリストアップできます。手作業でfreeeの請求書画面を1件ずつ確認する必要がなくなります。

パターン3：プロジェクト別の採算分析

工数管理APIと会計APIを組み合わせることで、プロジェクト単位での採算分析が可能です。

# Claude Codeへの指示例
「工数管理から今月のプロジェクト別の稼働時間を取得し、
会計データの外注費と合わせてプロジェクト別の粗利を計算してください」

パターン4：経費精算の異常値チェック

# Claude Codeへの指示例
「今月の経費精算データを取得して、過去6ヶ月の平均と比較して
2倍以上の金額になっている勘定科目を教えてください」

月次の経費が異常に増加しているケースを自動検出し、不正防止や予算管理に役立てることができます。

freee × HubSpot × Claude Code：三位一体の経営管理

CRMデータと会計データの突合が経営判断を変える

CRMは事業成長のエンジンです。HubSpotで管理している受注データと、freeeで管理している入金データを突き合わせることで、「受注したが入金されていない」「入金があるが受注記録がない」といった不整合を即座に発見できます。

Claude CodeにHubSpot MCPとfreee-mcpの両方を接続すれば、1つのセッション内で以下のような横断分析が可能です。

# Claude Codeへの指示例
「HubSpotの今月のクローズ済み取引一覧と、freeeの今月の売上仕訳を突合して、
金額の不一致がある取引をリストアップしてください」

会計データとCRMデータの統合は、経営判断の質を根本から変えます。 freee単体では「いくら入金があったか」しかわかりません。HubSpot単体では「いくら受注したか」しかわかりません。両方のデータをAIエージェントが横断的に分析することで、「受注から入金までのリードタイム」「顧客別のLTV（生涯価値）」「月次の予実差異の原因」といった、経営の意思決定に直結するインサイトが得られます。

StartLinkが実践するfreee × HubSpot連携

StartLinkは、HubSpotとfreeeを連携するアプリ「Sync for freee」を開発・提供しています。Sync for freeeはHubSpotの取引データを元にfreeeの請求書を自動生成するアプリで、HubSpot App Marketplaceに掲載されています。

freee-mcpとHubSpot MCPをClaude Codeに同時接続することで、Sync for freeeが自動処理した請求書のステータスを横断的に確認したり、CRMのパイプラインデータと会計データの整合性をリアルタイムで検証したりすることが可能になります。

この「freee（会計）× HubSpot（CRM）× Claude Code（AIエージェント）」の三位一体は、従来であれば経理・営業・経営企画の3部門がそれぞれ別のツールで管理していたデータを、1つのAIエージェントが統合的に分析・操作できる環境を実現します。

複数事業所の管理とチーム運用

複数事業所の動的切り替え

freee-mcpは複数事業所の動的切り替えに対応しています。グループ企業やフランチャイズ展開をしている企業では、事業所ごとの会計データを横断的に分析する必要がありますが、freee-mcpなら以下のように操作できます。

# Claude Codeへの指示例
「事業所Aと事業所Bの今月の売上高を比較して、前年同月比も含めて表にしてください」

freee-mcpのfreee_list_companiesツールで利用可能な事業所を一覧表示し、freee_set_current_companyツールで操作対象の事業所を切り替えます。Claude Codeのセッション内で事業所を切り替えながら、グループ全体のデータを集計できます。

チーム運用時のセキュリティ考慮事項

freee-mcpをチームで運用する際は、以下のセキュリティ上の注意点を押さえてください。

特に重要なのは、書き込み操作に対する人間のレビューです。AIエージェントが仕訳を自動作成する運用は効率的ですが、作成された仕訳を経理担当者が確認してから確定する（下書き → レビュー → 確定）というフローを設計することを推奨します。

トラブルシューティングと運用のコツ

よくあるエラーと対処法

freee-mcp利用時に遭遇しやすい問題と対処法をまとめます。

認証エラー（401 Unauthorized）: トークンの有効期限が切れている場合に発生します。freee-mcpはトークンの自動リフレッシュ機能を備えていますが、リフレッシュトークン自体の有効期限が切れた場合は再認証が必要です。freee_authenticateツールで再認証してください。

事業所アクセスエラー: 選択した事業所に対するアクセス権限がない場合に発生します。freeeの管理画面で、APIアプリケーションに対して該当事業所へのアクセス権限が付与されているか確認してください。

レートリミット: freee APIにはレートリミット（リクエスト回数制限）があります。大量のデータを一括取得する場合は、適切なページネーション処理とリクエスト間隔の調整が必要です。freee-mcpはこの制御を内部で処理しますが、短時間に大量のリクエストを発行する指示は避けてください。

運用効率を上げるCLAUDE.mdの設定

Claude Codeのプロジェクト設定ファイル（CLAUDE.md）にfreee関連の業務ルールを記述しておくと、AIエージェントの操作精度が向上します。

# 会計処理ルール
- 売上高の勘定科目コードは XXXXXX のみを本業売上として集計する
- freeeのtype=incomeにはBS取引（資本金等）が混入するため注意
- 会計年度は9月始まり（9/1〜8/31）
- 月次決算チェック時は、前月比10%以上の変動がある科目を必ず報告する

このようにドメイン固有のルールをCLAUDE.mdに明記しておくことで、Claude Codeは毎回の指示で細かい条件を伝えなくても、自社の会計ルールに沿った操作を行います。

よくある質問（FAQ）

Q1. freee-mcpは無料で利用できますか？

freee-mcpはGitHub上でオープンソースとして公開されており、MCPサーバー自体の利用は無料です。ただし、freee APIの利用にはfreeeの有料プランの契約とAPIアプリケーションの登録が必要です。また、Claude Codeの利用にはAnthropicのサブスクリプション（Claude Pro / Max / Team / Enterprise）が必要です。

Q2. freee-mcpでデータの書き込み（仕訳作成・請求書発行）はできますか？

はい、freee-mcpはfreee APIの読み取り操作だけでなく、書き込み操作（POST・PUT・PATCH・DELETE）にも対応しています。ただし、会計データの書き込みは不可逆な操作を含むため、運用上は「AIエージェントが下書きを作成 → 人間がレビュー → 確定」というフローを推奨します。

Q3. Claude Desktop版とClaude Code版のどちらで使うべきですか？

定型的なレポート生成やデータ確認にはClaude Desktop版が手軽です。一方、複数のMCPサーバーを組み合わせた横断分析（freee × HubSpot × Slack等）や、CLAUDE.mdによる業務ルールの注入が必要な場合はClaude Code版が適しています。チームでの運用や自動化パイプラインの構築を見据えるなら、Claude Codeを推奨します。

Q4. セキュリティ面で不安があります。freeeの認証情報はどこに保存されますか？

freee-mcpはOAuth 2.0 + PKCEを採用しており、認証トークンはローカル環境（~/.config/freee-mcp/）に保存されます。APIキーをコード内にハードコードする方式と比較して、トークンの自動リフレッシュとスコープ制限による安全な運用が可能です。トークンファイルのアクセス権限を適切に設定し、.gitignoreでの除外を徹底してください。

Q5. freee-mcpとSync for freee（HubSpot連携アプリ）の違いは何ですか？

Sync for freeeはHubSpotの取引データを元にfreeeの請求書を自動生成するHubSpotアプリで、特定のワークフロー（受注 → 請求書発行）を自動化します。一方、freee-mcpはfreee APIへの汎用的なアクセス基盤であり、AIエージェントを通じて会計・人事労務・請求書・工数管理・販売の全APIを自由に操作できます。Sync for freeeで定型業務を自動化し、freee-mcpで非定型の分析・レポートをAIに任せるという使い分けが効果的です。

まとめ：AIエージェントが経理業務のパートナーになる時代

freee-mcpとClaude Codeの連携で実現できることを整理します。

• 月次決算チェック・請求書の一括処理・プロジェクト別採算分析が自然言語の指示だけで完結する環境が整っている
• freee-mcpのAgent Skills機能は単なるAPI接続ではなく、freeeのドメイン知識をAIエージェントに注入する設計。会計の専門知識がなくても適切なAPI操作が実行される
• HubSpot MCPと組み合わせることで、CRMの受注データと会計の入金データを1つのAIセッションで横断分析できる。部門やツールの壁を越えた経営判断が可能になる
• AIエージェントは経理担当者の仕事を奪うものではなく、データ収集・集計・異常値検出の定型作業を代行することで、経理担当者が高度な判断業務に集中できる環境を作る

Claude Code MCP連携の始め方（設定手順の詳細） | AI活用完全ガイド