freee-api-skill

freee API スキル 概要 freee-mcp (MCP サーバー) を通じて freee API と連携。 このスキルの役割: freee API の詳細リファレンスを提供 freee-mcp 使用ガイドと API 呼び出し例を提供 注意: OAuth 認証はユーザー自身が自分の環境で実行する必要があります。 セットアップ 1. OAuth 認証（あなたのターミナルで実行） npx freee-mcp configure ブラウザで freee にログインし、事業所を選択します。設定は ~/.config/freee-mcp/config.json に保存されます。 2. 再起動して確認 Claude を再起動後、 freee_auth_status ツールで認証状態を確認。 リファレンス API リファレンスが references/ に含まれます。各リファレンスにはパラメータ、リクエストボディ、レスポンスの詳細情報があります。 目的のAPIを探すには、 references/ ディレクトリ内のファイルをキーワード検索してください。 主なリファレンス: accounting-deals.md - 取引 accounting-expense-applications.md - 経費申請 hr-employees.md - 従業員情報 hr-attendances.md - 勤怠 invoice-invoices.md - 請求書 使い方 MCP ツール 認証・事業所管理: freee_authenticate - OAuth 認証 freee_auth_status - 認証状態確認 freee_clear_auth - 認証情報クリア freee_current_user - ログインユーザー情報取得 freee_list_companies - 事業所一覧 freee_set_current_company - 事業所切り替え freee_get_current_company - 現在の事業所取得 ファイル操作: freee_file_upload - ファイルボックスにファイルをアップロード (POST /api/1/receipts) API 呼び出し: freee_api_get - GET リクエスト freee_api_post - POST リクエスト freee_api_put - PUT リクエスト freee_api_delete - DELETE リクエスト freee_api_patch - PATCH リクエスト freee_api_list_paths - 利用可能なAPIパス一覧 serviceパラメータ (必須): service 説明 パス例 accounting freee会計 (取引、勘定科目、取引先など) /api/1/deals hr freee人事労務 (従業員、勤怠など) /api/v1/employees invoice freee請求書 (請求書、見積書、納品書) /invoices pm freee工数管理 (プロジェクト、工数など) /projects sm freee販売 (見積、受注、売上など) /businesses 基本ワークフロー 事業所を確認: freee_get_current_company で現在の事業所IDを取得する（初回は必須。セッション内で1回取得すれば以降は使い回せる） レシピを確認: recipes/ 内の該当レシピを読む リファレンスを検索: 必要に応じて references/ を参照 API を呼び出す: freee_api_* ツールを使用（company_id が必要なエンドポイントでは手順1で取得した値を使う） 注意: company_id は現在設定されている事業所と一致している必要がある。不一致の場合はエラーになる 事業所を変更する場合: 先に freee_set_current_company で切り替えてからリクエストを実行 レシピ よくある操作のユースケースサンプルとTipsは以下を参照: recipes/expense-application-operations.md - 経費申請 recipes/deal-operations.md - 取引（収入・支出） recipes/hr-employee-operations.md - 人事労務（従業員・給与） recipes/hr-attendance-operations.md - 勤怠（出退勤・打刻・休憩の登録） recipes/invoice-operations.md - 請求書・見積書・納品書 recipes/receipt-operations.md - ファイルボックス（証憑ファイルのアップロード・管理） recipes/pm-operations.md - 工数管理（プロジェクト・工数実績） recipes/pm-workload-registration.md - 工数の安全な登録（PM・HR連携ワークフロー） recipes/sm-operations.md - 販売管理（案件・受注） エラー対応 認証エラー: freee_auth_status で確認 → freee_clear_auth → freee_authenticate 事業所エラー: freee_list_companies → freee_set_current_company 詳細: recipes/troubleshooting.md 参照 API の機能制限について freee API 自体の機能制限に起因する問題は freee-mcp では解決できません。詳細は recipes/troubleshooting.md を参照してください。 関連リンク freee-mcp freee API ドキュメント