Jobber MCP

jobber mcp服务器

](https://www.npmjs.com/package/jobber-mcp-server)  ](https://nodejs.org)

MCP服务器 临时工 现场服务管理API-客户管理、作业调度、报价、发票和服务请求接收。专为在家庭服务中工作的AI代理而构建。

这是什么？

这是一个“驱动程序”，允许任何兼容MCP的AI助手（Claude等）在Jobber帐户中读写数据。 MCP（模型上下文协议） 是一个开放标准，它为人工智能模型提供了一种结构化的方式来调用外部工具——可以把它想象成人工智能和业务软件之间的USB端口。

随着这台服务器的运行，人工智能代理可以通过自然对话搜索客户端、创建作业、检查日程、发送报价等。

快速安装

克劳德代码（推荐）：

claude mcp add jobber --scope user \
  -e JOBBER_CLIENT_ID=your_id \
  -e JOBBER_CLIENT_SECRET=your_secret \
  -e JOBBER_ACCESS_TOKEN=your_token \
  -e JOBBER_REFRESH_TOKEN=your_refresh \
  -- npx -y jobber-mcp-server

克劳德桌面：

添加到您的 claude_desktop_config.json:

• macOS： ~/Library/Application Support/Claude/claude_desktop_config.json
• 窗户： %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "jobber": {
      "command": "npx",
      "args": ["-y", "jobber-mcp-server"],
      "env": {
        "JOBBER_CLIENT_ID": "your_client_id",
        "JOBBER_CLIENT_SECRET": "your_client_secret",
        "JOBBER_ACCESS_TOKEN": "your_access_token",
        "JOBBER_REFRESH_TOKEN": "your_refresh_token"
      }
    }
  }
}

对话示例

一旦连接，只需自然地与克劳德交谈：

• “寻找客户约翰·史密斯” --电话 jobber_search_clients 按名称查找匹配的客户端
• “明天安排了什么工作？” --电话 jobber_get_schedule 取消明天的访问和任务
• “为主街123号的Sarah创建一个报价——炉子检查，150美元” --电话 jobber_create_client + jobber_create_quote 建立客户并起草估算
• “显示所有未付发票” --电话 jobber_list_invoices 已过滤为未清余额

可用工具

客户

请求：

乔布斯

调度

语录

发票

正在获取Jobber API凭据

1. 在以下网址创建开发人员帐户 developer.getjobber.com
2. 创建一个新应用程序——选择用例所需的范围（客户、作业、报价、发票、日程安排）
3. 注意你的 客户端ID 和 客户端密钥 从应用程序设置
4. 完成OAuth2授权流程以获取您的令牌：

- 将Jobber帐户所有者重定向到 https://api.getjobber.com/api/oauth/authorize?client_id=YOUR_CLIENT_ID&redirect_uri=YOUR_REDIRECT&response_type=code - 在他们授权后，Jobber使用 ?code= 参数 - 将代码替换为令牌： POST https://api.getjobber.com/api/oauth/token 和 grant_type=authorization_code，您的客户ID/机密和代码 - 响应包含您的 access_token 和 refresh_token

注： 这 scripts/extract-tokens.py 该脚本用于从现有的FirstVisitAI数据库中提取令牌，它本身不处理OAuth流。

从源代码安装

先决条件

• Node.js 18+
• A. Jobber开发者应用
• OAuth2凭据（客户端ID、客户端密钥、访问令牌、刷新令牌）

克隆和构建

git clone https://github.com/Onsite-Intelligence/Jobber-mcp.git
cd Jobber-mcp
npm install
npm run build

配置

复制示例环境文件并填写您的Jobber凭据：

cp .env.example .env

你的 .env 应该看起来像这样：

JOBBER_CLIENT_ID=your_client_id
JOBBER_CLIENT_SECRET=your_client_secret
JOBBER_ACCESS_TOKEN=your_access_token
JOBBER_REFRESH_TOKEN=your_refresh_token

连接到Claude Code（源代码）

{
  "mcpServers": {
    "jobber": {
      "command": "node",
      "args": ["dist/index.js"],
      "cwd": "/path/to/Jobber-mcp",
      "env": {
        "JOBBER_CLIENT_ID": "your_client_id",
        "JOBBER_CLIENT_SECRET": "your_client_secret",
        "JOBBER_ACCESS_TOKEN": "your_access_token",
        "JOBBER_REFRESH_TOKEN": "your_refresh_token"
      }
    }
  }
}

通过HTTP连接（用于远程/托管使用）

以HTTP模式启动服务器：

TRANSPORT=http HTTP_PORT=3000 jobber-mcp

MCP端点将在 http://localhost:3000/mcp.

配置

许可证管理

Jobber访问令牌将在约1小时后过期。此服务器自动处理令牌刷新：

1. 在每次API调用之前，服务器检查令牌是否在5分钟内过期
2. 在401响应中，服务器刷新令牌并重试
3. 成功刷新后，新令牌为 写回你的 .env 文件 自动地
4. 令牌也会记录到stderr作为回退

如果 .env 文件不存在或不可写，服务器退回到仅记录stderr并发出警告。

这 scripts/extract-tokens.py 如果您需要引导凭据，该实用程序可以从现有的Jobber集成中提取令牌。

速率限制

Jobber的API每分钟允许60个请求。服务器跟踪请求时间戳，并在接近限制时自动延迟。如果收到429响应，它将以指数回退方式重试（最多3次尝试）。

许可证

麻省理工学院