@him0/freee-mcp

# トラブルシューティング freee 経費申請作成スキル使用時の一般的な問題と解決方法。 ## 認証関連 ### 問題: "401 Unauthorized" 原因: 認証トークンの有効期限切れ 解決方法: ``` freee_authenticate ``` 再認証後、再度操作を実行してください。 ### 問題: "403 Forbidden" 原因: 必要な権限がない 解決方法: 1. freee 開発者ポータルでアプリケーションの権限を確認 2. 必要な権限（経費申請の作成、閲覧など）が有効化されているか確認 3. 権限を追加した場合は再認証が必要 ``` freee_clear_auth freee_authenticate ``` ### 問題: OAuth 認証画面が表示されない 原因: ブラウザがブロックしている可能性 解決方法: 1. ポップアップブロックを一時的に無効化 2. 手動でコールバック URL にアクセス 3. 別のブラウザを試す ## 事業所関連 ### 問題: "Company not found" 原因: 指定した事業所 ID が存在しないか、アクセス権限がない 解決方法: ``` # 利用可能な事業所を確認 freee_list_companies # 正しい事業所IDを設定 freee_set_current_company [正しい事業所ID] ``` ### 問題: 事業所を切り替えたい 解決方法: ``` freee_list_companies freee_set_current_company [新しい事業所ID] freee_current_user # 切り替わったことを確認 ``` ### 問題: 複数事業所がある場合どれを選ぶべきか 解決方法: - 経費申請を作成したい事業所を選択 - 不明な場合は経理部門に確認 - `freee_list_companies`で事業所の説明を確認 ### 問題: "company_id の不整合" 原因: リクエストに含まれる `company_id` と、現在設定されている事業所が異なる 解決方法: ``` # 現在の事業所を確認 freee_get_current_company # 方法1: 事業所を切り替える freee_set_company [リクエストで使用したい事業所ID] # 方法2: リクエストの company_id を現在の事業所に合わせる ``` 注意: company_id を含むリクエストは、必ず現在の事業所と一致している必要があります。 ## 経費申請作成時のエラー ### 問題: "expense_application_line_template_id が無効" 原因: 指定した経費科目 ID が存在しない、または事業所で無効化されている 解決方法: ``` # 有効な経費科目IDを確認 get_expense_application_line_templates company_id: [事業所ID] # 正しいIDを使用して再実行 ``` 詳細: 各事業所で利用可能な経費科目は異なります。必ず事前に確認してください。 ### 問題: "amount must be positive" 原因: 金額が 0 以下または数値でない 解決方法: 正の整数を指定 ```json "amount": 5000 // ✅ 正しい "amount": -100 // ❌ 負の数 "amount": 0 // ❌ ゼロ "amount": "5000" // ❌ 文字列（JSONでは整数で指定） "amount": 5000.5 // ❌ 小数（整数のみ） ``` ### 問題: "Invalid date format" 原因: 日付形式が不正 解決方法: "yyyy-mm-dd" 形式を使用 ```json "transaction_date": "2025-10-19" // ✅ 正しい "transaction_date": "10/19/2025" // ❌ スラッシュ区切り "transaction_date": "2025-10-19T00:00:00Z" // ❌ 時刻部分は不要 "transaction_date": "20251019" // ❌ ハイフンなし ``` ### 問題: "issue_date must be after transaction_date" 原因: 申請日が発生日より前 解決方法: 申請日を発生日以降に設定 ```json "transaction_date": "2025-10-15", // 発生日 "issue_date": "2025-10-19" // ✅ 申請日は発生日以降 ``` 注意: 通常、申請日は「今日」または発生日以降の日付を指定します。 ### 問題: "title is required" 原因: 申請タイトルが空または未設定 解決方法: わかりやすいタイトルを設定 ```json "title": "2025年10月 東京出張経費" // ✅ 具体的 "title": "経費申請" // ⚠️ 抽象的だが可 "title": "" // ❌ 空文字 ``` ### 問題: "expense_application_lines is required" 原因: 経費明細が空または未設定 解決方法: 少なくとも 1 つの経費明細を含める ```json { "expense_application_lines": [ { "expense_application_line_template_id": 1001, "amount": 5000, "transaction_date": "2025-10-19" } ] } ``` ### 問題: "section_id が無効" 原因: 指定した部門 ID が存在しない 解決方法: ``` # 部門一覧を確認 get_sections company_id: [事業所ID] # 有効な部門IDを使用 ``` ### 問題: 申請作成後に内容を確認したい 解決方法: ``` # 申請番号がわかる場合 get_expense_applications company_id: [事業所ID] application_number: [申請番号] # 最近の申請を確認 get_expense_applications company_id: [事業所ID] limit: 10 ``` ## データ取得時の問題 ### 問題: 経費科目一覧が取得できない 原因: - company_id が未設定または不正 - 権限がない 解決方法: ``` # 現在の事業所を確認 freee_get_current_company # 経費科目を取得 get_expense_application_line_templates company_id: [確認した事業所ID] ``` ### 問題: "経費科目が多すぎてどれを選べばいいかわからない" 解決方法: 1. 経費科目の`name`と`description`を確認 2. 一般的な科目: - 交通費: 電車、バス、タクシー - 宿泊費: ホテル、旅館 - 接待交際費: 会食、接待 - 消耗品費: 文房具、備品 3. 不明な場合は経理部門に確認 ## パフォーマンス関連 ### 問題: レスポンスが遅い 原因: - 大量のデータを取得している - ネットワークの問題 解決方法: - `limit`パラメータで取得件数を制限 - 必要なデータのみ取得するよう条件を絞る ## よくある質問 ### Q: 経費申請を下書き保存できますか？ A: freee API では、申請作成時に自動的に申請されます。下書き保存したい場合は、ローカルでデータを保存しておき、後で`post_expense_applications`を実行してください。 ### Q: 領収書画像を添付できますか？ A: 領収書の添付は、現在の MCP サーバーではサポートされていない可能性があります。領収書添付が必要な場合は、freee Web UI を使用してください。 ### Q: 作成した申請を修正できますか？ A: 申請作成後の修正は、現在の MCP サーバーではサポートされていない可能性があります。修正が必要な場合は、freee Web UI を使用するか、申請を削除して再作成してください。 ### Q: 複数の経費をまとめて申請すべきですか？ A: 以下を考慮してください: - 同じ出張: まとめる（例: 交通費+宿泊費） - 同じ月の交通費: まとめることが多い - 異なる種類の経費: 別々に申請することを推奨 - 会社の方針に従ってください ## サポートが必要な場合 ### freee API 公式ドキュメント https://developer.freee.co.jp/docs ### GitHub Issues https://github.com/him0/freee-skill/issues ### よくある質問の前に確認すること 1. [ ] `freee_status`で状態を確認しましたか？ 2. [ ] `freee_auth_status`で認証を確認しましたか？ 3. [ ] `freee_get_current_company`で事業所を確認しましたか？ 4. [ ] エラーメッセージを正確にコピーしましたか？