内容
# OpsConduit Jobber MCP
只读的Jobber现场服务操作MCP连接器。
OpsConduit帮助所有者和运营者提出关于运行其业务的工具的实用问题。此第一个连接器用于Jobber，默认情况下设计为只读。
面向买家的概述：[docs/index.md](docs/index.md)。
常见买家问题在[docs/faq.md](docs/faq.md)中得到解答。
示例所有者和运营者提示在[docs/operator-prompts.md](docs/operator-prompts.md)中。
第一个付费安装交付成果的格式：[docs/first-report.md](docs/first-report.md)。
## 它应该回答的问题
- 哪些估算需要后续跟进？
- 哪些发票已过期？
- 哪些工作未安排、停滞或被阻止？
- 哪些客户最近没有活动？
- 本周需要关注哪些工作？
- 运营后续跟进在哪里泄漏收入？
更多面向买家的示例在[docs/use-cases.md](docs/use-cases.md)中。
虚拟示例输出可在[docs/demo-output.md](docs/demo-output.md)中找到，或运行：
```bash
npm run demo
```
付费试点移交格式在[docs/pilot-deliverable-template.md](docs/pilot-deliverable-template.md)中记录。
## 产品立场
- 首先由客户托管。
- 首先只读。
- 公共存储库不需要凭证托管。
- 不在客户系统中进行自主写入。
- 不刮取私人数据。
- 没有虚假声明、虚假推荐或欺骗性外联。
## 启动优惠
早期访问定价在[docs/offer.md](docs/offer.md)中记录。
对于试点设置，请发送电子邮件至`opsconduit@gmail.com`，主题为`Jobber pilot`。请勿通过电子邮件发送Jobber密码、令牌、API密钥或私人客户数据。
## 安装
需要Node.js 20+。
```bash
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/install.md)中。付费试点验证步骤在[docs/pilot-checklist.md](docs/pilot-checklist.md)中。
Jobber GraphQL API的实现说明在[docs/jobber-api-notes.md](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以获取所有者报告；发送前阻止突变。
## 政策
- [服务条款](docs/terms.md)
- [隐私政策](docs/privacy.md)
## 状态
该存储库正在早期实施。第一个可用的目标是带有本地OAuth设置和只读Jobber GraphQL访问的客户托管MCP服务器。
