用途：通过 freee-mcp（MCP 服务器）与 freee API 对接，为 Claude 提供 freee API 的详细参考和使用指南。OAuth 认证需用户自行在本地环境完成。
主要能力：references/ 中收录会计（取引、经费申请）、人事劳务（员工、勤怠）、发票、工时管理、销售等 API 参考，含参数、请求体、响应信息，可用关键词在目录中检索。同时提供认证与事业所管理工具（freee_authenticate、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）以及通用请求工具 freee_api_get/post/put/delete/patch 和 freee_api_list_paths。service 参数为必填，可取 accounting（/api/1/deals）、hr（/api/v1/employees）、invoice（/invoices）、pm（/projects）、sm（/businesses）。
使用方式：先执行 npx freee-mcp configure 在浏览器登录 freee 并选择事业所，配置保存于 ~/.config/freee-mcp/config.json；重启 Claude 后用 freee_auth_status 确认认证。基本流程为获取当前事业所（freee_get_current_company，会话内一次即可）、查看 recipes/ 对应配方、按需检索 references/、调用 API。company_id 须与当前设置的事业所一致，否则报错；切换事业所前先调用 freee_set_current_company。
适用场景：会计收支、经费申请、员工与勤怠、发票与报价单、工时与项目管理、销售案件等操作。
限制：认证错误可按 freee_auth_status→freee_clear_auth→freee_authenticate 处理，事业所错误用 freee_list_companies→freee_set_current_company；因 freee API 本身的功能限制所导致的问题无法由 freee-mcp 解决，详见 recipes/troubleshooting.md。