mcpField
O
OpsConduit Jobber MCP

OpsConduit Jobber MCP

本地服务
github.com/opsconduit商业与营销123 周前更新
代码仓库

关于 OpsConduit Jobber MCP

OpsConduit Jobber MCP 是面向现场服务运营的客户自托管、只读 Jobber 连接器，支持本地 OAuth 设置和基于 GraphQL 的报告，帮助经营者找出待跟进事项；项目仍处于早期实现阶段。

主要功能

  1. 01在本地设置 Jobber OAuth
  2. 02在本地刷新并保存令牌
  3. 03验证已连接的账户
  4. 04抽样读取客户数据以检查权限
  5. 05运行只读 Jobber GraphQL 查询
  6. 06发送前阻止变更操作

适用场景

  1. 01查找需要跟进的估价单
  2. 02查看逾期发票和未排期工作
  3. 03识别近期没有活动的客户
  4. 04整理每周待处理运营事项

MCP 相关

MCP 服务提供 Jobber OAuth、账户验证、客户样本读取和只读 GraphQL 报告工具。变更操作会在发送前被阻止。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置
{
  "mcpServers": {
    "opsconduit-jobber": {
      "command": "npx",
      "args": [
        "-y",
        "@opsconduit/jobber-mcp"
      ],
      "env": {
        "JOBBER_CLIENT_ID": "<JOBBER_CLIENT_ID>",
        "JOBBER_CLIENT_SECRET": "<JOBBER_CLIENT_SECRET>",
        "JOBBER_REDIRECT_URI": "<JOBBER_REDIRECT_URI>"
      }
    }
  }
}
启动命令npx -y @opsconduit/jobber-mcp
需要配置的环境变量
JOBBER_CLIENT_IDJobber developer app client id for customer-owned OAuth setup.
JOBBER_CLIENT_SECRET密钥Jobber developer app client secret. Keep local; do not email or publish.
JOBBER_REDIRECT_URIOAuth redirect URI, usually http://localhost:3333/oauth/callback for local setup.

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包
npm@opsconduit/jobber-mcp0.1.3

工具

6

收录的工具列表 · 更新于 2 周前

参数类型必填说明
statestring否用于验证 Jobber 重定向回调时的不可读 CSRF/state 令牌。若省略，OpsConduit 会生成一个。
redirectUristring否在 Jobber 开发者应用中配置的 OAuth 回调 URL，例如 http://localhost:3333/oauth/callback。

详细介绍

OpsConduit Jobber MCP

用于 Jobber 现场服务运营的只读 MCP 连接器。

OpsConduit 帮助企业所有者和运营人员就支撑业务运转的工具提出切实可行的问题。这个首个连接器面向 Jobber，默认保持只读。

面向买家的简明介绍：docs/index.md。 常见买家问题的解答见 docs/faq.md。 企业所有者／运营人员提示词示例见 docs/operator-prompts.md。 首个付费安装交付物的形式见 docs/first-report.md。

它应该能回答的问题

  • 哪些估价需要跟进？
  • 哪些发票已逾期？
  • 哪些工作尚未排期、已停滞或受阻？
  • 哪些客户近期没有活动记录？
  • 本周哪些工作需要关注？
  • 哪些环节的运营跟进正在导致收入流失？

更多面向买家的示例见 docs/use-cases.md。

可在 docs/demo-output.md 查看虚构的示例输出，也可以运行：

npm run demo

付费试点的交接格式见 docs/pilot-deliverable-template.md。

产品定位

  • 优先由客户托管。
  • 优先只读。
  • 公共仓库无需保管凭据。
  • 不在客户系统中自主写入数据。
  • 不抓取私有数据。
  • 不作虚假宣传、不编造客户评价，也不进行欺骗性推广。

发布优惠

早期体验价格见 docs/offer.md。

如需设置试点，请发送邮件至 [email protected]，主题填写 Jobber pilot。请勿通过邮件发送 Jobber 密码、令牌、API 密钥或私有客户数据。

安装

需要 Node.js 20+。

mkdir opsconduit-jobber
cd opsconduit-jobber
npm install @opsconduit/jobber-mcp
cp node_modules/@opsconduit/jobber-mcp/.env.example .env
npx opsconduit-jobber-auth
npx opsconduit-jobber-mcp

运行身份验证助手前，请在 .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。

MCP 工具

  • jobber_auth_url - 为由客户托管的安装创建一次性 Jobber OAuth 授权链接。
  • jobber_exchange_code - 交换重定向返回的 OAuth 代码，并在本地存储令牌，不在聊天中暴露令牌。
  • jobber_refresh_token - 刷新已存储的访问令牌，以继续生成只读报告。
  • jobber_account - 在运行运营查询前验证已连接的账户。
  • jobber_clients_sample - 通过数量受限的客户端样本验证读取权限。
  • jobber_graphql_read - 为所有者报告执行只读 Jobber GraphQL 查询；发送前会拦截变更操作。

政策

状态

此仓库仍处于早期实现阶段。首个可用目标是由客户托管的 MCP 服务，支持本地 OAuth 设置和只读 Jobber GraphQL 访问。

评论

支持 Markdown

第一次接触 MCP？

从协议是什么，到在客户端里装上第一个服务，这几条回答覆盖了大多数入门问题。

一个开放协议，规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话，MCP 服务负责提供工具、资源和提示模板，两者通过标准消息通信，同一个服务可以被不同客户端复用。