Claude×freee API で会計を自然文で操作する|公式MCPと書き込みの止め方
freee会計を Claude から自然文で操作するなら、freee 公式の MCP サーバーを使います。リモート版はコネクタに URL を足し許可すればつながり、書き込みは freee の権限と Claude の承認で止めます。
目次 クリックで開く
この記事の要点
- Claude から freee会計を自然文で操作するなら、2026年3月に freee が公開した公式の MCP サーバー「freee-mcp」を使います。リモート版(β版)は、Claude のコネクタに freee の URL を足し、freee の画面で[許可する]を押せばつながります。
- 登録・更新・削除は、「実行前に確認して」という頼み方では止まりません。止めるのは、freee のユーザーの権限、ローカル版ならアプリの権限設定、Claude 側のツールの承認とルールです。
- 止まったときは、トークンの期限(アクセストークンは6時間)、権限、使用制限(1日のAPIコールは事業所とアプリごとに3,000回から)で見分けます。最初は「閲覧のみ」の権限のユーザーで、読み取りから試してください。
自然文の頼みが freee会計に届くまでと、止められる場所
プロンプトや CLAUDE.md に書いた指示は Claude の動きを方向づけるだけで、許可の仕組みではない
出典:GitHub freee/freee-mcp、freee ヘルプ「freee-mcp(リモート版)を設定して利用する」、Claude Code「Configure permissions」
Claude から freee会計を自然文で操作するのに、今は MCP サーバーを自分で作る必要はありません。freee は2026年3月2日に、公式の MCP サーバー「freee-mcp」をオープンソースで公開しました(freee のお知らせ)。freee がサーバーを置くリモート版(β版)なら、Claude か Claude Desktop のコネクタに freee の URL を足し、freee のログイン画面で[許可する]を押すだけでつながります。Node.js のインストールも、freee アプリストアでのアプリの登録も要りません。
手間がかかるのは、つないだ後です。たとえば「実行前に内容を見せて、承認を得てから登録して」と Claude に頼んでも、それは Claude の振る舞いを方向づけるだけで、書き込みを止める仕組みではありません。止める場所は、freee の側と Claude の側に別々にあります。この記事は、つなぎ方と一緒に、その場所を書きます。
当社は Claude Code の導入と、freee などの会計ソフトを使った経理の自動化を手伝う側の会社です。この記事は、freee会計を使う会社で Claude とのつなぎ込みを任された経理の担当者と情シスの方に向けています。人事労務・請求書・電子契約(freee サイン)など会計以外の領域と、Claude の API を自社のプログラムから呼ぶ作り方の細部は扱いません。経理の仕事で Claude Code に何を任せてよいかの線引きは、会計・経理で Claude Code にやらせていいこと・ダメなことに書いています。
自作の MCP サーバーから、freee 公式の freee-mcp へ
MCP(Model Context Protocol)は、Claude のような AI が外部のツールやデータにつなぐための公開の規格で、Anthropic が2024年11月に発表しました(Anthropic「Introducing the Model Context Protocol」)。freee会計を Claude から触るには、以前は freee 用の MCP サーバーを自分で作るか、有志が作ったものを探す必要がありました。freee-mcp は、もとは freee のエンジニアが個人で作り、freee が公式のオープンソースとして引き継いだものです。発表の時点では、会計・人事労務・請求書・工数管理・販売の5つの領域で、約270本の API を MCP の道具(ツール)にしていました(freee のお知らせ)。GitHub の説明(README)では、その後 IT管理・固定資産・申告・サイン(電子契約)などが加わり、2026年10月14日に見た時点で557の操作に対応しています。ライセンスは Apache-2.0 です(GitHub freee/freee-mcp)。
freee-mcp は、取引・勘定科目といった API ごとに道具を持つのではなく、HTTP のメソッドごとに freee_api_get・freee_api_post・freee_api_put・freee_api_patch・freee_api_delete の5つの道具を持ち、呼ぶ API のパスを引数で受け取ります。パスは freee の API の仕様(OpenAPI)に照らして確かめてから送ります。どの API をどう呼ぶかは、一緒に配られる Agent Skills(API の説明と操作の手順をまとめたもの)を Claude が読んで決めます。ほかに、事業所の切り替え(freee_set_current_company)や認証の状態の確認(freee_auth_status)などの管理用の道具と、エンドポイントの一覧を返す freee_api_list_paths があります(README)。この「メソッドごと」という作りが、後で書く止める場所の単位を決めます。
Claude と freee会計をつなぐ3つの方法
リモート版(β版)
freee がサーバーを置く。https://mcp.freee.co.jp/mcp
- 要るのは freee のアカウントと Claude のコネクタ
- freee のログイン画面で許可する
- 操作できるのは、ログインしたユーザーの権限の範囲だけ
- MCP の仕様の制限で、一部の操作ができないことがある
ローカル版
自分のパソコンで npx freee-mcp を動かす
- freee アプリストアでアプリを登録する
- OAuth 2.0 + PKCE。トークンは自動で更新
- アプリの権限設定でデータの種類ごとに絞れる
- ファイルのアップロード(freee_file_upload)と freee サインはローカル版だけ
自社のプログラム
Claude の API と freee API を自分でつなぐ
- 承認の画面や記録の残し方を自社で決められる
- 作る・直す手間は自社が持つ
出典:GitHub freee/freee-mcp(README)、freee ヘルプ「freee-mcp(リモート版)を設定して利用する」
決まった流れを繰り返すだけなら、Zapier や Make などのつなぎ込みのサービス(iPaaS)で組む方法も残ります。「特定のメールが来たら取引を登録する」のように、きっかけと処理を先に決めておく仕組みです。この記事で扱うのは、その都度の自然文の頼みを Claude が API の呼び出しに組み立てる使い方です。
つなぐ前に決めておくこと
手順そのものは数分で終わります。先に決めておきたいのは、freee のどのユーザーでつなぐかと、Claude をどの契約で使うかです。リモート版について freee のヘルプは、ログインしているユーザーの権限と同じ範囲でのみ操作できる、と書いています(freee ヘルプ)。管理者の権限のアカウントでつなげば、Claude からも管理者と同じ範囲に届きます。
| 決めること | 公式の決まり | 決めずに進めると |
|---|---|---|
| freee のどのユーザーでつなぐか | 標準の権限セットは、管理者・一般(経理)・取引登録のみ・閲覧のみ・一般(経理以外)・申請・承認。「閲覧のみ」は取引の新規登録や修正、マスタ(勘定科目・税区分など)の変更ができず、レポート・帳簿は閲覧・出力できる。権限の表では、口座の明細の一覧と、勘定科目・税区分・品目の確認・設定も「閲覧のみ」では使えない。メンバーの招待は[その他設定]→[メンバー一覧・招待](freee ヘルプ) | 自分のアカウントでつなぐと、Claude の道具の届く範囲が自分の権限と同じになる |
| Claude のどのプランで使うか | カスタムコネクタは Free・Pro・Max・Team・Enterprise で使え、Free は1つまで。Team では Owner と Primary Owner が追加し、各メンバーが自分でつなぐ(Claude ヘルプ)。Claude Code は Pro 以上のプランか Claude Console のアカウントが要る | Team では一般のメンバーは自分で追加できず、Owner に足してもらうことになる |
| 学習に使われる設定 | freee のヘルプは、AI ツールの側で学習の無効化(オプトアウト)などを設定するよう求めている。個人向けのプラン(Free・Pro・Max)は、改善に使う設定をオフにしても、フィードバックを送った分と安全審査の対象になった分は学習に使われる(Anthropic の利用規約「Consumer Terms」)。Team・Enterprise・API などの商用の契約は学習に使わない | 取引先や従業員の名前を含む会計データを、学習に使われうる契約で送ることになる |
| 費用の効き方 | Pro・Max・Team の定額の枠の中では、使った量は請求ではなく上限の消費になる。Enterprise と Console(API)、追加の利用の分は請求になる(Claude の料金のページ)。freee のヘルプは、Agent Skills を入れないと大量のトークンを消費する可能性があるとしている | 取引を何百件も取らせる頼みで、上限に早く届く、または請求が増える |
個人データを含むファイルや会計データを扱う契約の選び方は、Claude Code にやらせていいこと・ダメなことの記事の「個人データは、学習に使わない契約で送る」の節で、規約の該当箇所と一緒に書いています。業務の会計データを扱うなら、法人の名義の商用の契約をお勧めします。個人向けのプランは学習の設定を本人が切り替えるので、会社として扱いをそろえられないからです。
つなぎ方:リモート版、Claude Code、ローカル版
3つとも、何をするか、どこで確かめるか、間違えると何が起きるかの順に書きます。画面の名前は freee のヘルプ(2026年9月11日更新)と freee-mcp の README の表記に合わせています。
Claude・Claude Desktop にリモート版をつなぐ
リモート版をカスタムコネクタで足す
1
コネクタを追加する
- Claude か Claude Desktop で[カスタマイズ]→[コネクタ]→[追加]
- タイトルに freee、URL に https://mcp.freee.co.jp/mcp
2
freee で許可する
- [連携](または[連携させる])を押すと freee のログイン画面が開く
- [許可する]を押す
3
つながったかを見る
- 「freeeに接続されました。」と出て、道具の一覧が出る
4
Agent Skills を入れる
- GitHub から freee-api-skill.zip の最新版を取る
- [カスタマイズ]の[スキル]からアップロード
出典:freee ヘルプ「freee-mcp(リモート版)を設定して利用する」、GitHub freee/freee-mcp(README)
カスタムコネクタに入れる値
名前: freee
URL: https://mcp.freee.co.jp/mcp
Team・Enterprise では、メンバーはこの画面から足せません。管理者(Team は Owner と Primary Owner)が組織にコネクタを足し、各メンバーが自分でつなぎます(Claude ヘルプ)。
Claude のコネクタの一覧には、freee の公式のコネクタも載っています。[カスタマイズ]→[コネクタ]→[追加]→[コネクタを参照]で freee を検索し、[Claudeに接続]を押してもつなげます。ヘルプは、こちらのほうが設定が簡単だと案内しています。README は、freee 公式以外の URL を入れないよう注意を書いています。似た名前の別のサーバーに会計の許可を出すことになるからです。Agent Skills は、freee-api-skill.zip の最新版から取れます。
Claude Code にリモート版をつなぐ
Claude Code では、リモートの MCP サーバーを claude mcp add --transport http で足し、OAuth の認証は Claude Code の中で /mcp を開いて行います(Claude Code「MCP」)。Agent Skills は npx skills add freee/freee-mcp で入ります。サーバーとスキルをまとめて入れたいときは、freee-mcp が用意しているプラグインを使います(README)。
方法1:サーバーとスキルを別々に足す
claude mcp add --transport http freee https://mcp.freee.co.jp/mcp
npx skills add freee/freee-mcp
方法2:プラグインでまとめて入れる
claude plugin marketplace add freee/freee-mcp
claude plugin install freee-mcp@freee-mcp-marketplace
どちらで入れたかで、Claude Code の中での道具の名前が変わります。この名前は、後で書く許可のルールにそのまま使います。claude mcp add で freee という名前で足した場合は mcp__freee__freee_api_post のようになり、プラグインで入れた場合は mcp__plugin_freee-mcp_freee__freee_api_post のように、プラグインの名前が入ります。claude.ai で足したコネクタを Claude Code が読み込んだ場合は mcp__claude_ai_ で始まります(Claude Code「MCP」、「Configure permissions」)。
ローカル版:自分でアプリを登録してつなぐ
ローカル版は、freee アプリストアに自社のアプリを登録し、自分のパソコンで freee-mcp を動かす方法です。アプリの権限設定で、どのデータの種類を参照・更新できるかを絞れるのが、リモート版との違いです。
ローカル版を Claude Desktop につなぐ
1
アプリを登録する
- freee アプリストアで新しいアプリを作る
- コールバックURL は http://127.0.0.1:54321/callback
- Client ID と Client Secret を控え、必要な権限にだけチェック
2
設定を作る
- npx freee-mcp configure を実行
- 認証情報の入力、OAuth の認証、事業所の選択を対話で進める
3
Claude Desktop に足す
- configure が出す設定を設定ファイルに書く
- Claude Desktop を完全に終了してから起動し直す
出典:GitHub freee/freee-mcp(README)、MCP「Connect to local MCP servers」
ローカル版の初期設定(Node.js の npx を使う)
npx freee-mcp configure
Claude Desktop の設定ファイル claude_desktop_config.json に足す内容
{
"mcpServers": {
"freee": {
"command": "npx",
"args": ["freee-mcp"]
}
}
}
設定ファイルは、Claude Desktop の[Settings]→[Developer]→[Edit Config]で開けます。場所は Windows なら %APPDATA%\Claude\claude_desktop_config.json、macOS なら ~/Library/Application Support/Claude/claude_desktop_config.json です(MCP 公式)。Microsoft Store 版の Claude Desktop は場所が違いますが、freee-mcp configure が自動で見つけます(README)。configure は、認証情報と事業所の設定を ~/.config/freee-mcp/config.json に保存します(freee-mcp の CLAUDE.md)。Client Secret が入るファイルなので、共有のフォルダや Git の管理下に置かないことをお勧めします。
アプリの権限設定では、チェックを付け忘れないようにします。freee Developers は、非公開のアプリで権限に一つもチェックが無い場合、すべてにチェックがある場合と同じ扱いになると書いています(freee Developers「HTTPエラーレスポンス」)。絞ったつもりで何も選ばないと、いちばん広い権限のアプリになります。
つながったかを確かめる
つないだら、まず道具の一覧に freee_api_get などが並んでいるかを見ます。Claude Desktop なら、入力欄の左下の「+」のボタン(英語の表記は Add files, connectors, and more)から[Connectors]→[Manage connectors]を開き、freee を選ぶと道具が出ます(MCP 公式)。次に、どの事業所につながっているかを確かめます。freee会計は1つのアカウントで複数の事業所を扱えるので、ほとんどの API で事業所 ID(company_id)を指定します。freee-mcp では、頼みに含めた company_id が、今選んでいる事業所と一致しないとエラーになります。確かめるのは freee_get_current_company、切り替えるのは freee_set_current_company です(README)。
読み取りで確かめる頼みの例(この記事を通して使う例)
今つながっている freee の事業所の名前を教えてください。
直近10件の支出の取引を表示してください。金額、決済の状況、発生日を並べてください。
支払期日を過ぎていて未決済の売掛金を、取引先ごとに一覧にしてください。
書き込みで確かめる頼みの例
今日の日付で、勘定科目「消耗品費」、金額 1,100円の支出の取引を登録してください。
備考には「Claudeテスト」と入れてください。登録する前に、送る内容を見せてください。
書き込みを試したら、freee会計の画面で取引が正しく登録されたかを目で見て、試しの取引は消しておきます。書き込みの試しは、次の節の止める場所を決めてから行ってください。
書き込みは、頼み方では止まらない
「登録する前に、送る内容を見せてください」という頼みは、上の例のように役に立ちます。Claude は内容を見せてから進めようとします。ただ、それは許可の仕組みではありません。Claude Code の公式は、権限のルールを守らせるのはモデルではなく Claude Code だと書いています。プロンプトや CLAUDE.md の指示は、Claude が何をしようとするかを方向づけるだけで、何が許されるかは変えません(Claude Code「Configure permissions」)。claude.ai のコネクタについても、Research(リサーチ)の機能では道具が承認なしで動くので、外のアプリに書き込める道具は無効にしておくよう案内があります(Claude ヘルプ)。
止める場所は3つあります。強い順に、freee のユーザーの権限、ローカル版ならアプリの権限設定、Claude 側のツールの承認です。
書き込みを止める3つの場所
出典:freee ヘルプ、freee Developers「権限エラー」、「HTTPエラーレスポンス」、Claude Code「Configure permissions」、「Choose a permission mode」
1. freee のユーザーの権限
いちばん確かなのは、freee の側でユーザーにその操作をさせないことです。freee Developers は、アプリに取引の更新の権限があっても、ユーザーに取引の登録・編集・削除の権限が無ければ、その操作はできないと書いています。その場合 API は 401 の user_do_not_have_permission を返します(freee Developers「権限エラー」)。リモート版は自社でアプリを登録しないので、ヘルプの説明どおり、ログインしたユーザーの権限がそのまま Claude の届く範囲になります。分析や一覧づくりのように読むだけの用途なら、「閲覧のみ」の権限セットのユーザーでつなぐことをお勧めします。Claude 側の設定を誤っても、freee の側で登録・修正が通らないからです。権限セットを自分で作る「権限管理」の機能は、使えるプランが限られます(freee ヘルプ)。
2. アプリの権限設定(ローカル版)
ローカル版では、自社で登録したアプリに、データの種類ごとの参照・更新の権限を付けます。アプリにその API の権限が無いと、API は 403 を返します(freee Developers「HTTPエラーレスポンス」)。権限を変えても、今のアクセストークンには反映されません。新しいアクセストークンを取ったときから効き、リフレッシュトークンで取り直しても権限は変わりません。非公開のアプリは、利用者がログインし直して認可し直すと新しい権限になります(freee Developers「アプリの権限の変更反映タイミング」)。
3. Claude 側のツールの承認
claude.ai と Claude Desktop では、Claude が道具を呼ぶ前に承認を求めます。信頼できるサーバーと道具には、毎回の承認を省く「常に許可」(ヘルプの英語版では Allow always)を選べますが、書き込みの道具には選ばないでおきます。使わない道具は、検索とツールのメニュー(英語版では Search and tools)で無効にできます(Claude ヘルプ)。Team・Enterprise では、組織がコネクタの道具ごとに承認を必須にしたり、止めたりする設定もでき、Claude Code はその設定を読みます(Claude Code「MCP」)。
Claude Code は事情が違います。v2.1.283 以降を端末や VS Code で起動すると、設定が無ければ auto モードで始まり、道具の呼び出しを人の代わりに分類器(別のモデル)が確かめます(Claude Code「Choose a permission mode」)。freee への書き込みを人が1件ずつ見るなら、プロジェクトの .claude/settings.json に、書き込みの道具を ask(毎回確かめる)、削除を deny(使わせない)とするルールを書きます。ルールは deny、ask、allow の順に見られ、最初に当たったものが効きます(Claude Code「Configure permissions」)。
.claude/settings.json の例(claude mcp add で freee という名前で足した場合)
{
"permissions": {
"allow": ["mcp__freee__freee_api_get"],
"ask": [
"mcp__freee__freee_api_post",
"mcp__freee__freee_api_put",
"mcp__freee__freee_api_patch"
],
"deny": ["mcp__freee__freee_api_delete"]
}
}
プラグインで入れた場合は、道具の名前を mcp__plugin_freee-mcp_freee__ で始まるものに替えます。設定ファイル(settings.json)で止められるのは道具の単位、つまり HTTP のメソッドごとです。Claude Code は設定ファイルを読むとき、括弧の付いた mcp__ のルールを読み飛ばすので、「取引の API だけ登録を許す」のようにパスで分けたルールは設定ファイルには書けません。MCP の道具の引数の値で止めたいときは、起動するときの --disallowedTools に deny のルールとして書きます。値は * を使わなければ完全に一致したときだけ当たり、* を使うと任意の文字の並びに当たります。この書き方は deny のためのもので、allow には使えません(Claude Code「Configure permissions」)。freee-mcp の道具は API のパスを引数で受け取るので、たとえば仕訳帳の API への post を止めるなら mcp__freee__freee_api_post(path:/api/1/journals*) の形になります(引数の名前は README の例からの読み取りです)。ただ、パスで分けたいなら、freee のユーザーかアプリの権限で分けるほうが確かです。
なお、freee-mcp の道具には、読み取り専用か、元に戻せない操作かを示す印(MCP のツールの注釈 readOnlyHint・destructiveHint)が付いています。注釈は 0.17.0 で加わり、0.26.5 で書き込み(POST・PUT・PATCH・DELETE)の道具に destructiveHint が付き、0.36.1 からは全部の道具に明示されています(freee-mcp の CHANGELOG)。印を使うかどうかはアプリの側の作りによるので、上の設定の代わりにはしません。
外から入る指示と、あとで確かめる記録
Claude が Web のページや別のコネクタの中身を読む会話では、その中に紛れた指示を Claude が受け取ってしまうおそれがあります(プロンプトインジェクション)。Anthropic も、悪意のある MCP サーバーが、Claude に意図しない動きをさせる隠れた指示を含むことがあると注意しています(Claude ヘルプ)。会計の作業をする会話では、関係の無いコネクタを外し、書き込みの道具を承認制にしておくことをお勧めします。紛れた指示で書き込みが呼ばれても、人の承認の手前で止まるからです。
誤って二重に登録した取引は、freee会計の画面でふつうに直せます。誰がいつ何を変えたかを freee の側で追うには、仕訳全体の操作履歴の一覧を使います。エンタープライズプランの機能で、削除した仕訳も含めて表示できます(freee ヘルプ「エンタープライズプランの概要」)。ほかのプランでは、Claude に何を頼んだかを Claude の側の記録で残します。Claude Code で使った道具を会社のログに送る設定は、経理で Claude Code にやらせていいことの記事の記録の節にあります。
自然文の頼みは、API のどこに当たるか
Claude は、頼みを読んで freee の API の呼び出しに組み立てます。思ったとおりに動かないときは、どの API に当たったかを見ると原因が絞れます。下の表は、よく使う頼みと、当たる会計 API の例です。上限や仕様は、freee が公開している会計 API の仕様(GitHub freee/freee-api-schema、会計APIリファレンス)で確かめたものです。
| 頼みの例 | 当たる API | 気をつけること |
|---|---|---|
| 支払期日を過ぎた未決済の売掛金を、取引先ごとに一覧にして | GET /api/1/deals(status=unsettled、type=income) | 1回に取れるのは最大100件(既定は20件)。件数が多いと続けて何度も呼ぶ |
| 今月の経費で、支払先・金額・日付が同じ取引が複数ないか調べて | GET /api/1/deals(type=expense) | 突き合わせは、Claude が取ってきたデータの上で行う。全件を取るので、件数のぶん呼び出しが増える |
| 銀行の明細のうち、まだ取引を登録していない入金を出して | GET /api/1/wallet_txns | 取引登録待ちの金額は due_amount。最大100件ずつ |
| 品目と勘定科目の一覧を ID つきで出して | GET /api/1/items、GET /api/1/account_items | 取引の登録では、名前ではなく ID で指定する |
| 先月の損益を、取引先ごとに見せて | GET /api/1/reports/trial_pl | 取引先・品目・部門・セグメントの単位で内訳を出せる。/reports は1秒に10回まで |
| 今期の仕訳帳を書き出して | GET /api/1/journals | ダウンロードの依頼を受け付けるだけで、ファイルは後で作られる。状態を確かめ、uploaded になってからダウンロードする |
| この領収書の PDF を取引に付けて | POST /api/1/receipts | 1ファイル64MBまで、1分に300ファイルまで。freee-mcp ではローカル版の freee_file_upload を使う |
| 請求書を作って | freee請求書の API | freee会計の API の請求書・見積書の作成は、2023年10月に freee請求書の API に移行した |
freee-mcp の README は、請求書や経費の申請のように同じ形のデータを繰り返し作るときは、前に作ったデータを参照させると正確になるとしています。「先月の○○社への請求書を参考に、今月分を作成して」のような頼み方です(README)。
税区分は「10%」ではなくコードで送る
取引を作るとき、税区分は tax_code という数字のコードで指定します。「10%で」と頼んでも、API に送られるのはコードです。事業所で使えるコードは GET /api/1/taxes/companies/{company_id} で取れ、available=true を付けると、事業所の設定で使うことにしている税区分だけに絞れます。従来の /api/1/taxes/codes は廃止予定で、事業所の設定に関係のない共通の一覧を返します。勘定科目と品目も同じで、名前を ID に置き換えて送ります。勘定科目・税区分・品目の一覧を先に取らせてから登録を頼むと、ID が合わずに 400 のエラーになるのを減らせます。
プランで使えない API とパラメータがある
freee会計の API は、契約しているプランの Web 版で使える機能と同じ範囲が使えます。例外として、総勘定元帳の API は法人アドバンスプラン・新法人エンタープライズプラン・旧プロフェッショナル・旧エンタープライズの事業所だけ、固定資産台帳の API は新旧のエンタープライズプランの事業所だけが使えます。部門とは別のセグメントのタグ(segment_1_tag など)も、法人アドバンスプランかエンタープライズプランなどに限られます(会計 API の仕様)。プランの外の API は使えません。なお、有料プランの事業所だけで使える API を呼んだときに返るのが、401 の freee_plan_limit です(freee Developers)。
止まったときに見るところ
Claude の返事が「エラーになりました」だけでも、freee の API が返したステータスとコードは、道具の結果に入っていることが多くあります。Claude に「freee から返ったステータスとエラーのコードを、そのまま見せて」と頼むと、どこで止まったかが分かります。
トークンの期限
freee の API のアクセストークンは6時間で切れます(freee Developers「アクセストークンを取得する」)。リフレッシュトークンは発行から90日で切れ(freee Developers のお知らせ)、1つのリフレッシュトークンで取り直せるのは1回だけです。freee-mcp はトークンを自動で更新しますが(README)、長く使わずに90日を過ぎたときや、権限を変えたときは認可し直します。
freee の API のトークンが続く条件
出典:freee Developers「アクセストークンを取得する」、「リフレッシュトークンの有効期限の変更」、「アプリの権限の変更反映タイミング」
使用制限
freee の API の使用制限は、1分あたりの決まった回数ではなく、次の3つで決まっています(会計 API の仕様「API 使用制限」)。一定の期間に過度のアクセスがあると 403 が返り、10分ほどたつと使えるようになります。/reports は1秒に10回、/receipts/{id}/download は1秒に3回までで、超えると 429 が返り、応答のヘッダーに上限・残り・戻る時刻(x-ratelimit-limit・x-ratelimit-remaining・x-ratelimit-reset)が付きます。そして、1日の API のコール数に、事業所とアプリケーションごとの上限があります。
1日の API コール数の上限(事業所とアプリケーションごと)
過去3年分の取引を全部調べて、のような頼みは、1回に最大100件ずつ取るので、件数を100で割った回数だけ呼び出しが重なります。分けて頼むか、期間を絞ってから頼むと、1日の上限に届きにくくなり、Claude の側の使用量も減ります。会計データを毎日まとめて取り出して分析するなら、BigQuery などのデータ基盤に貯めてから見る方法もあります。
エラーと、誰が直すか
| 返ってきたもの | 意味 | やること |
|---|---|---|
401 expired_access_token | アクセストークンの期限切れ | リフレッシュする。freee-mcp は自動で更新する。続くなら freee_auth_status で認証の状態を見て、認証し直す |
401 user_do_not_have_permission | つないだユーザーの権限が足りない | 事業所の管理者に、そのユーザーの権限セットを見直してもらう |
401 re_authorization_required | アプリストアで公開しているアプリが、使うデータの範囲を広げた | 利用者が認可し直す |
401 invalid_grant | 認可が不正・期限切れ・無効 | Client ID・Client Secret、使い終わったリフレッシュトークンを使っていないかを確かめる |
401 freee_plan_limit | 有料プランの事業所だけで使える API | 事業所のプランを確かめる |
| 403(コードなし) | アプリにその API の権限が無い | ローカル版はアプリの権限設定を見直し、新しいトークンを取る |
| 403(続けて呼んだ後) | 過度のアクセスで止められた | 10分ほど待ち、期間を絞って頼み直す |
| 429 | /reports か証憑のダウンロードの回数の上限 | ヘッダーの x-ratelimit-reset の時刻まで待つ |
| 400 | 不正なリクエスト。validation に詳細 | 日付の形、勘定科目・税区分・品目の ID が事業所にあるかを見る |
403 は、権限の不足と使用制限の2つの意味で返ります。設定を変えた直後に毎回出るなら権限、たくさん呼んだ後に出て10分ほどで戻るなら使用制限です。出典は freee Developers「HTTPエラーレスポンス」と会計 API の仕様です。トークンのエラーの読み方と、連携が止まったときに誰が許可し直すかは、freee会計の連携が止まったときの記事でも扱っています。
ローカル版が Claude Desktop につながらないときは、ログを見ます。Windows では %APPDATA%\Claude\logs に、つなぎ込み全体の mcp.log と、サーバーごとの mcp-server-<名前>.log があります(MCP 公式)。なお、freee のヘルプは、MCP サーバーを介した外部連携は freee のサポートの対象外で、freee-mcp の不具合は GitHub の Issues で受け付けるとしています(freee ヘルプ)。
よくある取り違え
| 取り違え | 実際 |
|---|---|
| 自然文で頼めば、正しく仕訳してくれる | Claude は頼みを読んで勘定科目や税区分を選ぶので、選び間違いは起こりうる。取り込む前に、勘定科目・税区分・金額を人が確かめる |
| Claude が freee のデータを覚えている | Claude は頼まれるたびに freee の API から取ってくる。ただし、取ってきた結果は会話の記録に残る |
| これで月次の締めが終わる | 代わりにできるのは、freee の操作と、取ったデータの集計・突き合わせまで。証憑を集める、現物を数えるといった作業は残る |
| API のキーを AI に渡すのは危ない | リモート版は freee の画面で許可する OAuth で、キーを Claude に貼らない。届く範囲は、つないだユーザーの権限で決まる |
読み取った値を会計ソフトに取り込む前の確かめ方は、領収書・請求書の読み取りを扱ったClaude Code × OCR の記事に、経費精算から freee に流すつなぎ方は楽楽精算と freee会計の連携の記事に書いています。退職した人のアカウントや権限を外し忘れない仕組みは、アカウントの削除漏れを防ぐ記事にあります。
ルールとAIの分け方を、1社から広げる進め方まで動画で解説しています↓↓
まず「閲覧のみ」のユーザーで、読み取りから試す
最初の一歩は、freee会計に「閲覧のみ」の権限セットのユーザーを用意し、そのユーザーでリモート版をつないで、読み取りの頼みだけを試すことです。この形なら、Claude 側の設定に漏れがあっても、freee の側で登録・修正が通りません。ただし「閲覧のみ」では、画面で口座の明細の一覧が見られません(freee ヘルプの権限の表)。銀行の明細(wallet_txns)を扱う頼みには、一般(経理)以上の権限が要ると考えてください。API で同じように止まるかは確かめていません。書き込みを使うときは、書き込める権限のユーザーに切り替える前に、Claude Code なら ask と deny のルールを、claude.ai なら書き込みの道具の承認を決めておきます。
freee を Claude につなぐ前に、権限と書き込みの止め方を決める
閲覧のみのユーザーで読み取りを試したら、次に決めるのは、書き込みをどこで止めるかです。Aurant Technologies の Claude Code 導入支援では、AI に渡す情報・権限・操作を絞り込んだうえで、freee などの会計の SaaS を MCP でつなぎ、承認と操作ログを残す形で導入します。進め方は、今の業務の流れと課題を聞き取る無料診断から始めます。AI に渡す会計データと書き込みを手前で絞る仕組みとして、freee・マネーフォワード向けのRuleHubもあります。経理全体の見直しは経理DX支援で受けています。
freee-mcp・freee ヘルプ・freee Developers・会計 API の仕様、Claude Code・Claude ヘルプ・MCP の公式ドキュメントは、2026年10月14日に確かめました。freee-mcp は更新が早く、リモート版は β版です。道具の名前や対応する操作は、使う前に README で確かめてください。
Claude Code 導入支援
領収書・請求書の読み取りから記帳・仕訳、Excel の集計まで。freee・マネーフォワード・バクラク・勘定奉行などと MCP でつなぐときは、AI に渡す情報・権限・操作を絞り、承認と操作ログを残す形で導入します。




