用途：该技能用于借助 freee-mcp（MCP 服务器）连接 freee API，为会计、人事劳务、发票、工时管理、销售等业务提供详细 API 参考和调用示例。技能本身不执行 OAuth 认证，认证需用户在自己的环境中完成。
主要能力：提供各业务领域的 API 参考文件（如 accounting-deals.md 交易、accounting-expense-applications.md 经费申请、hr-employees.md 员工信息、hr-attendances.md 考勤、invoice-invoices.md 发票），包含参数、请求体和响应详情；提供 recipes/ 下的常见操作示例和排错指南；通过 MCP 工具完成认证、事业所管理与通用 API 调用。
使用方式：先在你的终端执行 npx freee-mcp configure，在浏览器登录 freee 并选择事业所，配置保存于 ~/.config/freee-mcp/config.json；重启 Claude 后用 freee_auth_status 确认认证状态。调用 API 前先用 freee_get_current_company 获取当前事业所 ID，再选择对应 service（accounting、hr、invoice、pm、sm）并使用 freee_api_get/post/put/delete/patch 等工具；可用 freee_api_list_paths 查看可用路径。
限制：OAuth 认证必须用户自行执行；company_id 必须与当前事业所一致，否则报错；切换事业所需先调用 freee_set_current_company；freee API 本身的功能限制无法通过 freee-mcp 解决。具体细节可查阅 recipes/troubleshooting.md。