用途:通过 freee-mcp(MCP 服务器)让 AI 直接操作 freee 的会计、人事劳务、发票、工时管理、销售、IT 管理、固定资产、业务委托管理、调查、开业、人事评价、申报等数据,并提供 freee API 的详细参考与调用示例。
主要能力:提供 references/ 下的 API 参考(含参数、请求体、响应),recipes/ 下的常见操作配方,以及法人税申报账票 XML(XTX/XBRL)与纸质账票项目的对应参考。MCP 工具包括认证与事业所管理(freee_authenticate、freee_auth_status、freee_clear_auth、freee_current_user、freee_list_companies、freee_set_current_company、freee_get_current_company)、服务器信息(freee_server_info)、文件上传(freee_file_upload,仅本地模式)及 API 调用(freee_api_get/post/put/delete/patch、freee_api_list_paths)。service 参数为必填,可选 accounting、hr、invoice、pm、sm、it_management、fixed_asset_management、partner_management、survey、launch、employee_evaluation、tax_return。
使用方式:若 freee_* 工具可用则无需设置;否则阅读 SETUP.md 引导连接。连接模式由 freee_server_info 的 transport 字段确认(remote 为 Remote MCP,stdio 为本地)。基本流程为:用 freee_get_current_company 确认事业所、查阅 recipes/ 配方、按需检索 references/INDEX.md、再用 freee_api_* 调用。company_id 须与当前事业所一致,切换事业所先用 freee_set_current_company。
适用场景:经 expense-application、deal、manual-journal、payment-request、hr-employee、hr-attendance、invoice、receipt、pm、sm、partner-management、it-management、survey、launch、fixed-asset-management、corporate-tax-return、report 等配方覆盖的日常业务操作。
限制:survey、launch、employee_evaluation 等部分端点仅限 freee-mcp 远程版,本地 stdio 模式不可用,需先确认 transport 并引导切换。freee 签名由另一 MCP 服务器 freee-sign-mcp 提供,可用 sign_api_get 等工具时参考 SIGN-GUIDE.md。数据可视化需按 COLORS.md 指定配色。API 自身功能限制无法由 freee-mcp 解决。版本过旧可能导致信息不匹配,需更新技能。具体收费、价格与平台信息暂未提供。