jobber-mcp 是 OpsConduit 提供的只读 MCP 连接器,用于 Jobber 现场服务运营。它旨在帮助业主和运营人员针对运行业务的工具提出实用问题,首个连接器面向 Jobber,默认保持只读。
用途:该工具主要回答运营层面的问题,例如:哪些估价需要跟进?哪些发票已逾期?哪些工作未排期、停滞或被阻塞?哪些客户近期没有活动?本周哪些工作需要关注?运营跟进在哪里造成收入流失?更多面向买家的示例见 docs/use-cases.md。
主要能力:提供一组 MCP 工具,包括:jobber_auth_url(为客户自托管安装创建一次性 Jobber OAuth 授权链接)、jobber_exchange_code(交换重定向的 OAuth 代码并在本地存储令牌,不在聊天中暴露)、jobber_refresh_token(刷新已存储的访问令牌以继续只读报告)、jobber_account(在运行运营查询前验证已连接账户)、jobber_clients_sample(通过有上限的客户样本验证读取权限)、jobber_graphql_read(运行只读 Jobber GraphQL 以生成业主报告,变更操作在发送前被阻止)。
使用方式:需要 Node.js 20+。在运行认证助手之前,在 .env 中填写 JOBBER_CLIENT_ID 和 JOBBER_CLIENT_SECRET。该助手会打印一个 Jobber OAuth URL,接收本地回调 http://localhost:3333/oauth/callback,并将令牌存储在 .opsconduit/jobber-tokens.json。详细安装说明见 docs/install.md,付费试点验证步骤见 docs/pilot-checklist.md,Jobber GraphQL API 的实现说明见 docs/jobber-api-notes.md。付费试点交接格式记录在 docs/pilot-deliverable-template.md。
适用场景:面向 Jobber 现场服务运营的业主和运营者,用于生成只读运营报告,发现需要跟进的估价、逾期发票、未排期或停滞的工作、近期无活动的客户,以及本周需关注的工作。适合希望以客户自托管方式运行、保持只读、不托管凭据、不在客户系统中自动写入的团队。
限制:该仓库处于早期实现阶段,首个可用目标是带有本地 OAuth 设置和只读 Jobber GraphQL 访问的客户自托管 MCP 服务器。产品姿态包括:客户自托管优先、只读优先、公共仓库无需凭据托管、不在客户系统中自动写入、不抓取私人数据、不虚假声明或欺骗性推广。早期访问定价记录在 docs/offer.md。如需试点设置,可发送邮件至 opsconduit@gmail.com,主题为 Jobber pilot。请勿通过电子邮件发送 Jobber 密码、令牌、API 密钥或私人客户数据。