https://mcp.freee.co.jp/mcp に freee Public API の access_token を使うと 401 Unauthorized になる

[kytkhrz]

Description / 概要

freee-mcp の hosted MCP endpoint (https://mcp.freee.co.jp/mcp) に対して、freee Public API で取得した access_token を Bearer token として使用するとツール一覧取得で 401 Unauthorized になる。

Steps to Reproduce / 再現手順

1. freee OAuth application を作成（[参考URL](https://developer.freee.co.jp/startguide/starting-api)）
2. freee Public API 用の access_token を取得
3. GET https://api.freee.co.jp/api/1/users/me で 200 OK を確認
4. 独自 MCP クライアント（Python/httpx ベース）から https://mcp.freee.co.jp/mcp に対してツール一覧取得リクエストを送信（取得した access_token を Bearer token として使用）

Expected Behavior / 期待される動作

ツール一覧が正常に取得できる。

Actual Behavior / 実際の動作

401 Unauthorized が返る。

Error Messages / エラーメッセージ

401 Unauthorized

Environment / 環境

• freee-mcp version:
• MCP client (e.g., Claude Desktop, Claude Code): 独自実装（Python/httpx ベース）
• Node.js version:
• OS:

---

質問:

1. https://mcp.freee.co.jp/mcp は、freee Public API の access_token をそのまま Bearer token として利用可能でしょうか？
2. それとも hosted MCP 用に別の OAuth / MCP auth flow が必要でしょうか？

[JeongJaeSoon]

ご質問ありがとうございます。認証方式について補足します。

結論として、https://mcp.freee.co.jp/mcp では freee Public API で取得した access_token をそのまま Bearer token として利用することはできません。
そのため、その token を指定して /mcp にアクセスした場合に 401 Unauthorized になるのは現在の期待動作です。

Hosted MCP endpoint では、MCP 用の OAuth / MCP auth flow を通じて発行された access token が必要です。
freee Public API の access token は、MCP 認証フローの途中で freee 側の認可が完了した後、MCP サーバー内部で freee API 呼び出し用に保持・利用されます。一方で、/mcp endpoint 自体の Bearer token として直接受け付けるものではありません。

独自 MCP クライアントから接続する場合は、以下の metadata を起点に、MCP の OAuth flow に沿って認証を行ってください。

• Protected Resource Metadata: https://mcp.freee.co.jp/.well-known/oauth-protected-resource/mcp
• Authorization Server Metadata: https://mcp.freee.co.jp/.well-known/oauth-authorization-server

大まかな流れとしては、client registration / authorization code + PKCE / token exchange を行い、https://mcp.freee.co.jp/token で発行された MCP 用 access token を Authorization: Bearer ... として /mcp に送る形になります。

もし freee Public API の access token をご自身で管理して直接 API を呼び出したい場合は、Hosted MCP endpoint 経由ではなく、freee Public API を直接呼び出すか、freee-mcp を self-host / local 実行する構成をご検討ください。