用AI操作freee会计与考勤 ― freee-api-skill
機械翻訳 / Machine-translated
cccskills
5日前・8分で読める
機械翻訳 / Machine-translated
原文链接：用AI操作freee会计与考勤 ― freee-api-skill（cccskills）
技能页面：freee-api-skill
本文结论
安装freee-api-skill后，使用freee的财务和劳务负责人可以用日语向AI代理提出费用申请、交易登记、考勤打卡、试算表查看等请求。
本文将说明freee-api-skill与freee-mcp的关系及对应的业务范围，并依次介绍安装步骤、请求示例以及使用前需注意的事项。
日常的财务核查工作，可以用普通语言来委托。
例如月末时，发送如下内容：
让我看看本月的试算表。
也帮我确认一下是否还有未审批的凭证。
代理首先通过连接AI与freee的freee-mcp，确认要操作的事业所。
接着读取试算表和总分类账的配方（常见操作的操作指南），确认API规格后再获取本月的试算表。
该配方也涵盖未审批凭证的确认，因此可以一次性委托完成截止日前的所有核查工作。
请求中并未包含"freee"这个词。
该技能的设计前提是：凡是涉及会计处理、人事劳务、开票及报价等请求，即使没有明确提及freee，也会自动调用。
无需打开freee界面，用日常语言即可委托处理财务和劳务核查——这正是该技能的使用场景。
将结果整理为图表、表格或HTML时，会使用技能内置的配色规范。
粘贴到内部资料时，视觉风格也更易统一。
freee-api-skill是一款将freee API的详细参考文档和使用指南提供给代理的技能。
实际执行数据查询和登记操作的，是MCP服务器（连接AI与外部服务的工具）freee-mcp。
技能负责告知"向哪个API传递什么内容"，freee-mcp负责实际调用——两者分工明确。
支持的领域广泛，涵盖freee的主要服务。按领域整理可委托的工作如下：
| 领域 | 可委托的工作示例 |
|---|---|
| 会计 | 费用申请、交易（收入·支出）登记、转账凭证、付款申请、试算表·总分类账获取 |
| 人事劳务 | 查看员工信息及工资明细、登记上下班打卡及休息 |
| 发票 | 创建及查看发票、报价单、发货单 |
| 工时管理 | 查看项目、登记工时实绩 |
| 销售 | 管理案件、订单及销售 |
| IT管理 | 管理成员、SaaS账户、应用、设备及部门 |
| 固定资产 | 固定资产的列表、登记、更新、删除 |
| 业务外包管理 | 查看外包企业用户及部门 |
| 调查·开业·人事评价 | 获取调查企划和实施回次、查看及更新开业申请数据、获取人事评价结果 |
| 申报 | 查看法人税申报数据和报表 |
| 签名（电子合同） | 电子合同文件管理（需另行配置freee-sign-mcp） |
针对常见操作，共提供19个配方。
涵盖费用申请、交易、考勤、发票、工时、固定资产等方面的操作步骤和注意事项。
其中包括：将工时与人事劳务信息核对后安全登记的流程，以及判断固定资产的更新和删除工作中哪些部分可以交由AI处理。
代理按以下顺序执行操作：
首先确认事业所，是因为freee的数据按事业所分别存储。
若此步骤出错，可能会误操作到其他事业所的数据。
该技能也适合用于查询API规格。
参考文档中包含各API的参数、请求体和响应说明。
必填项均有标注，还收录了法人税申报XML各元素与纸质报表字段的对应关系表。
安装方式有两种：通过命令安装，或请Claude帮助安装。
前提条件是已完成freee-mcp的连接与认证配置。
即使尚未连接，安装该技能后，代理也会引导完成连接步骤。
通过命令安装，请执行以下命令：
npx skills add https://github.com/freee/freee-mcp --skill freee-api-skill
请求Claude帮助安装时，请直接发送以下内容：
次の Agent Skill をインストールしてください。
https://github.com/freee/freee-mcp/tree/main/skills/freee-api-skill
まず SKILL.md と付属ファイルの中身を確認し、不審な処理（外部への送信、認証情報の読み取りなど）がないことを確かめてから、~/.claude/skills/freee-api-skill/ に配置してください。
存放位置也有两种选择。
若要在所有项目中使用，请放置于~/.claude/skills/；若仅在特定项目中使用，请放置于该项目的.claude/skills/目录下。
分发来源为GitHub上的freee/freee-mcp。
请求内容只需直接写出想要完成的工作即可。
以下介绍三个典型示例：
确认当前事业所，并将这笔支出登记为交易。
代理会确认事业所，参照交易配方和规格整理所需字段，然后完成支出交易的登记。
请登记今天的上班和下班打卡。
休息时间是12点起1小时。
根据此请求，代理会按照考勤配方登记上下班打卡和休息时间。
考勤配方涵盖上下班打卡及休息的登记。
我想登记这个案件的工时实绩，请帮我查一下需要填写哪些字段。
此情况下，代理不会直接进行登记，而是先从工时管理参考文档中整理并展示需要输入的字段。
适合在确认字段后再推进登记的场景。
可使用的功能会因freee-mcp的连接方式不同而有所差异。
远程版和本地版的区别如下：
| 连接方式 | 可用范围差异 |
|---|---|
| 远程版 | 调查、开业、人事评价的API仅在远程版中可用；认证会自动处理 |
| 本地版 | 向文件箱上传文件仅在本地版中可用；首次使用需手动进行认证操作 |
若在本地版中请求仅限远程版的功能，代理不会执行调用，而是提示切换版本。
处理电子合同需要在freee-mcp之外另行配置freee-sign-mcp。
由于会直接修改会计和人事数据，登记、更新、删除操作请在执行前确认内容。
尤其是交易登记和考勤打卡，建议先让代理显示金额和日期时间，确认无误后再下达执行指令，这样更为安全。
切换事业所后，也请确认操作目标是否正确。
操作不顺畅时，主要有三种原因。
第一种是技能版本比freee-mcp旧，此时请将技能更新至最新版本。
第二种是持续出现认证错误。
远程版请删除连接器后重新添加，本地版请清除认证信息后重新认证。
第三种是freee API本身的功能限制，这无法通过freee-mcp解决。
许可证为Apache-2.0。
安装前请阅读SKILL.md及附属文件的内容，确认不存在可疑操作。
不能。
该技能的作用是传递API规格和操作流程，数据操作由freee-mcp负责执行。
在未连接状态下发出请求时，代理会引导完成连接步骤。
可以处理，但需要另行配置freee-sign-mcp。
在签名工具可用的状态下，代理会参照签名专用指南操作文件。
根据所需功能来决定。
若需要处理调查、开业、人事评价，请选择远程版；若需要上传证明文件，则需要本地版。
操作开始时已内置确认事业所的步骤。
若指定的事业所与当前事业所不符，会报错并要求切换后重新执行。
freee-api-skill是一款与freee-mcp配合使用的技能，可通过AI代理处理freee的财务、劳务、开票、工时等相关工作。
费用申请、交易登记、考勤打卡、试算表查看等操作，都可以用日语请求代替界面操作来完成。
该技能也可用于查询API必填项，对于开发freee集成功能的人员来说，同样能减轻查阅资料的负担。
建议先从查询类请求开始尝试，登记操作请在确认内容后逐步推进。
本文转载自 cccskills 的文章《用AI操作freee会计与考勤 ― freee-api-skill》。
技能详情和安装方法请参见 cccskills 的 freee-api-skill 页面。