用途:这是 Harvest(工时追踪与项目计费服务)的独立非官方连接器,封装 Harvest API v2,提供可由智能体调用的工具,用于记录工时并管理工时归属的项目、客户、联系人和任务。
主要能力:记录与编辑工时(按小时数或起止时间创建、更新、删除时间条目,启动、停止、重启计时器);管理项目、客户、联系人、任务,并将任务分配给项目;读取时间条目、项目、客户、联系人、任务和发票;读取当前用户与公司设置(工时追踪模式、功能开关)。
使用方式:作为 agentskills.io 技能安装,命令为 npx skills add zapier/connectors --skill harvest;运行 CLI、本地 MCP 服务器或 zapier-sdk 认证命令前,先执行 npm install --omit=dev。需 Node.js 22.18+。按运行形态加载对应参考文件(MCP、CLI、SDK 或直接调用 API 的 recipe)。脚本返回 { data, meta } 结构,可用 jq 表达式裁剪结果。
限制:不支持创建或发送发票与估价单、记录费用、运行聚合 Reports API、用户管理;客户、项目、任务无硬删除,只能通过 is_active: false 归档;已锁定或已开票的时间条目不可删除。工时追踪模式分按时长与按起止时间两种且互斥,未知时应先读取 getCompany 的 wants_timestamp_timers。按名称匹配记录时若出现多个同名项,应停止并让用户确认,不得静默选择。认证以连接选择器字符串传入,而非密钥本身。