- c7d55a3:
configure --forceオプションを追加。保存済みのログイン情報(トークン・設定ファイル)をリセットして再設定できるようにした。 - 37edff1: 開発ツールチェーンを bun に移行: パッケージマネージャ (pnpm → bun)、バンドラ (esbuild → Bun.build)、スクリプト実行 (tsx → bun)。テストは vitest を維持。CI/CD を bun ベースに更新。
- 6ca07dc: configure コマンドでポート番号に不正な値を入力した場合に、次回 configure が起動しなくなるバグを修正。入力時のバリデーション追加と、config.json の読み込み時に null 値を許容するよう修正。
- 5903d74: TokenStore インターフェースを導入。将来のリモートデプロイ(Redis 等)に向けた内部構造の改善で、stdio モードの動作変更はありません。
- f8873e4: エラーハンドリングの共通ヘルパー関数抽出とスキーマパス検証の regex キャッシュ化によるリファクタリング
- ff3e506: freee_api_delete が HTTP 204 No Content レスポンスで JSON パースエラーとなる問題を修正
- 83251cb: freee-api-skill の description に具体的な操作キーワードを追加してトリガー率を改善
- fb11574: ESLint + Prettier を Biome に移行
- 441d1e4: --remote オプションを追加。リモート MCP サーバーとして動作させる際にファイルアップロード機能を無効化
- 564777b: configure コマンドで会計 API から事業所一覧を取得できない場合に、人事労務 API へフォールバックするように改善。人事労務のみ利用しているユーザーでも事業所を選択できるようになりました。
- 42255f2: configure コマンドの事業所選択プロンプトに操作ヒント(↑↓ で選択、Enter で確定)を追加し、表現を「操作対象の事業所」に統一
- bc135be: API 要望の案内先を freee サポートページから freee Public API リクエストフォームに変更
- 8c964bf: API の機能制限に関する問い合わせを freee プロダクトのフィードバックに誘導するガイダンスを SKILL とトラブルシューティングに追加
- 32fab73: 工数管理レシピの拡充: 全 PM エンドポイントのカバレッジ追加と、PM・HR 連携による安全な工数登録ワークフローレシピの新規追加
- cc24426: MCP サーバーに instructions を追加し、全ツールの description に freee-api-skill skill へのガイド参照を追加
- ace37e0: PM/SM API 操作レシピを追加し company_id 指定方法を明記、取引 URL フォーマットを修正
- cc24426: publish workflow の skill zip ファイル名を freee-api-skill.zip に修正
- cc24426: サーバーバージョンをハードコードから package.json の値に同期するよう変更
- d93e78b: ファイルボックスへのファイルアップロード用カスタムツール (freee_file_upload) を追加
- 78d94ed: Claude Desktop のスキルアップロード手順の UI パスを最新のものに更新
- b94976d: Fix
claude plugin addtoclaude plugin installin README and publish workflow - 87abec4: Windows Store (MSIX) 版 Claude Desktop の設定ファイルパスに対応。Store 版のパッケージディレクトリが存在する場合、自動的に正しいパスを使用します。
- 69622a3: スキルドキュメントを整理し company_id の扱いを明確化
- 3fb6f22: 人事労務(有給申請)・工数管理・販売 API のリファレンスドキュメントを追加し、リファレンス生成スクリプトを改善
- dab48e3: ツールの説明文や使用例から invoice API の例示を deal 一覧取得の例に置き換え
- 62e8483: CSV レスポンスが JSON として処理される不整合を修正。isBinaryContentType に text/csv を追加し、CSV レスポンスが正しくファイルとして保存されるようにしました。
- aa42fef: refresh_token が欠落している場合に空文字列を保存する代わりにエラーを返すようにし、再認証を促すメッセージを表示するようにした
- cb2e717: 環境変数の部分設定(FREEE_CLIENT_ID または FREEE_CLIENT_SECRET の片方のみ)でエラーを返すように修正
- 3a3346e: FREEE_CALLBACK_PORT の値検証を追加し、不正な値(NaN、範囲外)の場合はデフォルトポートにフォールバックするようにした
- 806aa41: 各サービスの API ベース URL を環境変数で切り替え可能にする機能を追加。FREEEAPI_BASE_URL{SERVICE}(ACCOUNTING, HR, INVOICE, PM, SM)環境変数でサービスごとの接続先を上書きできます。
- 93222c3: スキルの docs/ ディレクトリを recipes/ にリネーム(ユースケースサンプル集であることを明確化)
- d615b70: README.md の skills インストーラー CLI の参照を
add-skillからskillsに更新
- 7d84fd6: 勤怠操作ガイド(hr-attendance-operations.md)を新設し、hr-operations.md を hr-employee-operations.md にリネーム・整理
- 1ea4571: npm publish を Trusted Publishing (OIDC) に移行し、NPM_TOKEN シークレットを不要に
- 3f3fe54: npm パッケージ名を @him0/freee-mcp から freee-mcp に変更したことに伴い、全ファイルの参照を更新
- c47692c: configure 完了後に Skill インストールの案内を表示するように改善。Claude Code には
npx add-skillコマンド、Claude Desktop には Releases から freee-skill.zip をダウンロードする手順を案内。
- e91f75f: configure コマンドでコールバック URL を分かりやすく表示するように改善
- a3766e0: OpenAPI スキーマを最新版に更新: 会計 API に経費申請制限事項とテンプレート ID フィールド追加、人事労務 API に所定休日労働時間フィールド追加、販売 API に案件更新・受注更新エンドポイント追加
-
d2147d3: freee API が name: null の事業所を返す場合に configure コマンドが失敗する問題を修正
-
d055c47: fix: トークン交換の失敗をブラウザに正しく表示
トークン交換を待ってから結果に応じてブラウザに応答を返すように修正。エラー時は「認証エラー」(HTTP 500)を表示し、エラーがサイレントに無視されないようにした。
- 988121f: Add User-Agent header to OAuth token refresh and token exchange requests
- 74a2f5b: fix: エラーメッセージ内の誤ったツール名を修正 (freee_set_company → freee_set_current_company, 旧ツール名 → freee_api_get)
- 8b27a9f: freee-agent パッケージを private に設定し、npm publish 対象から除外
-
9ab8bc6: 0.6.2 リリース: 1/17 以降の変更を含む
このリリースには以下の改善が含まれています(CHANGELOG 0.6.1 に既に記載済みの内容):
- 外部 API へのリクエストに User-Agent ヘッダーを追加
- 外部 API レスポンスの Zod バリデーション追加
- OAuth コールバックサーバーのエラーハンドリング改善
- 403 エラーのハンドリング改善(レートリミット対応)
- トークンエラーハンドリングの改善(Result 型パターン)
- OAuth コールバックサーバーのオンデマンド起動
- ポート使用中時のエラーメッセージ改善
-
4b941b6: 外部 API へのリクエストに User-Agent ヘッダーを追加し、MCP サーバーからのリクエストであることを識別可能に
-
a803a3e: Add Zod validation for external API responses to prevent silent failures from invalid response formats
-
f79175d: fix: improve error handling for OAuth callback server startup failures
- Add explicit error messages when OAuth callback server fails to start
- Log when server is already running instead of silently returning
- Clean up server state properly on error
-
a6b4a4c: fix: 403 エラーのハンドリングを改善し、レートリミットの可能性を示すメッセージを追加
-
230cbf8: fix: improve token error handling with Result type pattern
- Replace safeParseJson with parseJsonResponse that returns a Result type, preserving error context instead of silently returning empty object
- Propagate token refresh errors in getValidAccessToken instead of returning null, allowing callers to understand failure reasons
- Add comprehensive tests for parseJsonResponse and token refresh failure scenarios
-
b2ac012: OAuth コールバックサーバーを MCP サーバー起動時ではなく、認証時にオンデマンドで起動するように変更
-
d4f96c0: ポートが使用中の場合にフォールバックせず、具体的な解決方法を含むエラーメッセージを表示するように変更