Jobkeepr

Jobkeepr MCP 服务

将 Jobkeepr 连接到 Claude、ChatGPT 或任何其他 MCP 客户端，让 AI 助手读取和管理您的现场服务业务：工单、客户、排期、报价、发票和付款。

Jobkeepr 是面向小型承包商团队的现场服务管理软件，适用于由 1 到 10 人组成的团队，例如杂工、电视安装人员、水管工、电工和暖通空调技师。

"What's on my schedule tomorrow?"
"Which service made me the most money last month?"
"Book Sarah Chen for a TV mount Thursday at 2pm."
"Mark today's jobs complete."

两种连接方式

远程（推荐）。 如果您的客户端支持远程 MCP 服务，可直接连接托管端点，完全跳过此软件包：

https://jobkeepr.com/mcp

它支持 OAuth，因此您可以使用常规 Jobkeepr 登录账号登录，并在浏览器中批准访问。无需安装任何内容。

stdio（此软件包）。 对于仅支持 stdio 的客户端，此软件包通过 API 密钥连接到同一服务。

此软件包未发布到 npm。 请使用下方所示的 github:dandyer/jobkeepr-mcp 说明符直接从 GitHub 安装。普通的 npx jobkeepr-mcp 将无法 解析。npm 会在安装时为您编译 TypeScript，因此无需额外运行任何内容。

设置

在 Jobkeepr 的 Settings → API Keys 中创建 API 密钥。密钥只会显示一次，请立即复制。

Claude Desktop

将以下内容添加到 claude_desktop_config.json：

{
  "mcpServers": {
    "jobkeepr": {
      "command": "npx",
      "args": ["-y", "github:dandyer/jobkeepr-mcp"],
      "env": {
        "JOBKEEPR_API_KEY": "jk_live_your_key_here"
      }
    }
  }
}

Claude Code

claude mcp add jobkeepr --env JOBKEEPR_API_KEY=jk_live_your_key_here -- npx -y github:dandyer/jobkeepr-mcp

或者直接连接到远程端点：

claude mcp add --transport http jobkeepr https://jobkeepr.com/mcp

工具

读取

工具	功能
get_business_context	企业名称、时区、工作时间和今天的日期，并解析“本周”“上个月”等时间范围
get_jobs	按日期、状态、客户、类型或来源筛选工单
get_customers	搜索客户，可选包含工单数量和总额
get_schedule	已安排的工单、日历事件和空闲时段
get_estimates	报价及其状态
get_invoices	发票和未付款余额
get_payments	已收到的付款
get_line_items	所有工单中的明细项，用于分析利润率和构成
get_reference_data	工单类型、潜在客户来源和价格目录

写入

工具	功能
create_job	为客户预订工单
create_event	添加非工单类日历事件，例如休假或现场勘查
create_customer	添加客户
create_estimate	创建报价
create_catalog_item	向价格目录添加服务或产品
add_line_items	向工单添加可计费明细项
set_customer_source	记录客户通过何种方式找到企业
reschedule_job	将工单改到新的日期或时间
cancel_job	取消已安排的工单
close_jobs	将工单标记为已完成

财务工具需要 VIEW_FINANCIALS 权限，每个写入工具都需要相应的权限。您无权使用的工具不会显示给您。

它不会做什么

此处没有任何工具可以给您的客户发短信。 我们特意排除了短信发送功能：这是唯一会联系到真实人员且无法撤销的操作。请让您的助手起草消息，然后在 Jobkeepr 中自行发送。

写入操作会立即生效，没有暂存步骤，也无法撤销。因此，cancel_job 和 close_jobs 被标记为破坏性操作，客户端会在运行前提示您。close_jobs 一次可以处理多个工单，因此请在批准前检查所涉及的工单。

配置

变量	必填	默认值	说明
JOBKEEPR_API_KEY	是	—	在 Settings → API Keys 中获取。以 jk_live_ 开头。
JOBKEEPR_URL	否	https://jobkeepr.com	仅用于可自托管或暂存环境时进行覆盖。

API 密钥仅对一个账号生效，并具有所有者级访问权限。您可以随时在 Settings → API Keys 中撤销密钥。若要为助手提供权限范围更窄的用户级访问权限，请通过 OAuth 使用远程端点。

工作原理

此软件包是代理，而非重新实现。工具位于托管服务上；此软件包负责将 stdio 连接到它。因此，这里的工具集始终是最新的，此软件包很少需要发布新版本。

开发

npm install
npm run build
JOBKEEPR_API_KEY=jk_live_... node dist/index.js

使用 MCP Inspector 进行交互式测试：

JOBKEEPR_API_KEY=jk_live_... npx @modelcontextprotocol/inspector node dist/index.js

链接

• Jobkeepr
• Model Context Protocol

采用 MIT 许可。