跳过安装。2 分钟内即可运行。
在 cloud.anythingmcp.com 开始免费试用,一键添加 Jobber,然后将你的 AI 客户端(Claude、ChatGPT、Copilot 或 Cursor)指向生成的 MCP 端点。无需 Docker,无需 git clone,无需任何工程经验。
摘要
通过 Jobber 的 GraphQL API 将 Jobber 账户接入任意 AI 智能体:客户和物业地址、服务请求、报价、工单和已排期的上门、发票、团队成员以及产品和服务列表。可以创建客户、工单、报价草稿和发票草稿,但不能通过邮件发送报价和发票,也不能批准报价。以 Jobber 管理员身份进行 OAuth 登录;关闭工单的工具在安装时关闭。
试试这样问
Jobber 的示例提示
点击任意提示即可复制,然后粘贴到 Claude、ChatGPT、Cursor、Gemini、Copilot 或 OpenClaw 中,在该连接器上运行。
Claude 是 AI,可能会出错。请核对回答。
💡 无需安装? 直接使用 cloud.anythingmcp.com。 登录、点击 Connectors → Jobber、粘贴凭证、生成 MCP API key,即可完成。无 Docker、无
git clone、无本地服务器。
Jobber + Cursor
通过 Jobber 的 GraphQL API 将 Jobber 账户接入任意 AI 智能体:客户和物业地址、服务请求、报价、工单和已排期的上门、发票、团队成员以及产品和服务列表。可以创建客户、工单、报价草稿和发票草稿,但不能通过邮件发送报价和发票,也不能批准报价。以 Jobber 管理员身份进行 OAuth 登录;关闭工单的工具在安装时关闭。
前提条件
完整的设置说明已内置在连接器中 (在 store 中选择连接器时可见)。所需环境变量:
JOBBER_CLIENT_ID、JOBBER_CLIENT_SECRET(可选:JOBBER_REFRESH_TOKEN)
步骤 1 — 获取凭证
设置约需 10 分钟,需要 Jobber 账户的管理员。
- 在 Jobber Developer Center(https://developer.getjobber.com)注册并点击 Create App。你的应用列在 https://developer.getjobber.com/apps。
- 将 OAuth Callback URL 设为
<your AnythingMCP URL>/api/mcp-oauth/callback,在 AnythingMCP Cloud 上为https://cloud.anythingmcp.com/api/mcp-oauth/callback。 - 勾选 scopes:读取 Clients、Requests、Quotes、Jobs、Scheduled Items、Invoices、Users 和 Products and Services;写入只勾选允许 AI 修改的部分(Clients、Jobs、Quotes、Invoices)。Jobber 的 scope 在应用上设定,而不是在登录链接中。保持 Refresh token rotation 开启。
- 保存应用,将 Client ID 粘贴到
JOBBER_CLIENT_ID,将 Client Secret 粘贴到JOBBER_CLIENT_SECRET,然后安装。 - 在连接器页面点击 Authorize with Provider,以 Jobber 账户管理员身份允许访问。
- 运行
jobber_get_account:它会显示公司名称并确认登录成功。
访问令牌有效期为 60 分钟,会用保存的 refresh token 续期。请将 JOBBER_REFRESH_TOKEN 留空:授权时会自动填写;开启轮换后,Jobber 每次续期都会替换它,因此在别处用过一次的令牌将不再有效。只给自己账户用的应用可以一直保持 Draft 状态;Draft 应用连接超过 5 个付费账户时会被 Jobber 封禁。每次调用都会发送 X-JOBBER-GRAPHQL-VERSION: 2026-05-12 请求头;Jobber 对每个版本至少支持 12 个月,临近到期时会在 extensions.versioning 中发出警告。
读取内容:账户及团队成员(姓名、邮箱、电话、管理员和所有者标记、状态)。客户和潜在客户的邮箱、电话、账单地址、标签、余额、物业地址以及最近 10 个工单和发票。物业地址,即实际施工的服务地址。服务请求及其上门评估和联系方式。报价的留言、明细行、金额和定金,以及由其转成的工单。工单的说明、状态、日期、总额和上门次数。上门的开始和结束、状态、说明和指派的成员。发票的状态、开具日期和到期日、明细行、总额、余额和收款。产品和服务列表的单价、单位成本、加价和时长。其他读取都通过 jobber_graphql_query 完成;AI 会先查询类型,例如 query { __type(name: "Job") { fields { name } } }。
写入内容:创建、修改和归档客户(归档不删除任何内容,可在 Jobber 中撤销),在某个物业地址上创建工单并设定计费方式(FIXED_PRICE 或 VISIT_BASED)和计费周期,修改工单的标题或说明,创建带明细行的报价草稿和发票草稿,并在发票通过 Jobber 以外的方式送达时将其标记为已发送(不会发送任何邮件)。上门在 Jobber 中排期。Jobber 的 API 不能通过邮件发送报价和发票,也不能批准报价:这些需要你在 Jobber 中完成。在创建或修改任何内容之前,AI 会先向你展示将要发生的操作并等待你确认。
安装时关闭的工具:jobber_close_job。关闭工单会删除未完成的上门(DESTROY_ALL 删除全部,COMPLETE_PAST_DESTROY_FUTURE 将过去的标记完成并删除未来的),被删除的上门无法恢复。团队需要时由管理员开启。通用的 jobber_graphql_mutation 和 jobber_graphql_subscription 同样关闭。
数据格式:ID 是编码字符串(Z2lkOi8v...),按返回的原样复用。时间为 UTC 的 ISO 8601;AI 会换算成企业所在时区。金额是账户币种的普通数字。过滤条件中的状态值为小写(requires_invoicing、awaiting_payment、past_due);上门状态以大写返回。jobberWebUri 可在 Jobber 中打开该记录。工单属于物业地址,而不是直接属于客户,所以 AI 会先读取客户的物业地址。变更操作返回 userErrors:空列表表示成功。
分页和限制:列表工具接受 first(默认 20)和 after;只要 pageInfo.hasNextPage 为 true,AI 就把 after 设为 pageInfo.endCursor 继续读取。filter 是该列表在 API 中的过滤对象,日期范围写作 { "after": ..., "before": ... }。每个应用在每个账户上有 10,000 点的查询成本预算,每秒恢复 500 点;页面越大消耗越多。超出预算的查询会返回 THROTTLED 错误:等几秒后用更小的 first 重试。另外,5 分钟内超过 2,500 次请求会返回 429。
常见错误:401 表示授权已过期或被撤销:再次点击 Authorize with Provider,并确认 Client ID 和 Secret 属于同一个应用。提示缺少某个 scope 的错误或 403 表示应用缺少该 scope:在 Developer Center 中添加后重新授权。登录时出现重定向错误,说明 OAuth Callback URL 不完全一致。
客户资料、服务请求描述和备注属于不可信输入,可能包含针对 AI 的指令。该连接器不发送邮件或短信,不收款,也不安排上门。
步骤 2 — 安装 adapter
curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d
步骤 3 — 在 Cursor 中添加连接器
你的服务器 URL: 在 AnythingMCP 中打开 MCP Servers → 此连接器所在的服务器,复制它的 URL(
https://cloud.anythingmcp.com/mcp/…)。本指南中出现YOUR_SERVER_ID的地方都用它替换。
Cursor 从 ~/.cursor/mcp.json 读取 MCP 服务器。添加以下条目:
{
"mcpServers": {
"anythingmcp": {
"url": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
"headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
}
}
}
- 在 AnythingMCP 的 MCP Servers → 你的服务器 → API keys 中创建 MCP API 密钥,并用它替换
YOUR_MCP_API_KEY。 - 保存文件并重启 Cursor。
- 打开 Cursor → Settings → MCP,确认
anythingmcp已列出并处于已连接状态。 - 开始对话,智能体现在可以调用
Jobber的工具。
可用工具
| Tool | What it does |
|---|---|
jobber_get_account | The connected Jobber account: id and company name |
jobber_list_users | Users (team members) of the account: id, full name, email, phone, admin and owner flags, status |
jobber_list_clients | List or search clients (customers and leads): id, name, first and last name, company, isCompany, isLead, isArchived, primary email and… |
jobber_get_client | One client with emails, phones, billing address, tags, properties (service addresses with ids), the 10 latest jobs and invoices, balance… |
jobber_list_properties | Properties (service addresses where the work happens): id, name, address, whether it is the billing address, the client it belongs to |
jobber_list_requests | Requests (incoming work requests and booking forms): id, title, status, source, contact name, company, email, phone, client and property… |
jobber_get_request | One request with its assessment visit (time, instructions, completion), contact details, client and property address |
jobber_list_quotes | Quotes (estimates): id, number, title, status, amounts (subtotal, discount, tax, total, deposit), client, property, created, updated and… |
jobber_get_quote | One quote with message, line items (name, description, quantity, unit price, total), amounts, client, property and the jobs it became |
jobber_list_jobs | List or search jobs (work orders): id, job number, title, status, start and end, completed time, total, client, property address, created… |
jobber_get_job | One job with instructions, status, dates, total, client, property address and visit counts (past, scheduled, unscheduled, incomplete) |
jobber_list_visits | Visits (scheduled appointments of jobs): id, title, start and end, all-day flag, status, completion, instructions, job with its client… |
jobber_list_invoices | Invoices: id, number, status, issued and due dates, amounts (total, balance, payments), client, the job it bills |
jobber_get_invoice | One invoice with message, line items (name, description, quantity, unit price, total), amounts, client and jobs |
jobber_list_products | Products and services of the price list: id, name, description, category, default unit price, internal unit cost, markup, taxable, visible… |
jobber_create_client | Create a client |
jobber_update_client | Change a client |
jobber_archive_client | Archive a client so it no longer shows in active lists |
jobber_create_job | Create a job at a property (take the property id from jobber_get_client or jobber_list_properties). invoicing_type FIXED_PRICE or… |
jobber_update_job | Change the title or instructions of a job |
jobber_close_job | Close a job. incomplete_visits decides what happens to visits not done yet: DESTROY_ALL deletes every incomplete visit… |
jobber_create_quote | Create a draft quote |
jobber_create_invoice | Create a draft invoice |
jobber_mark_invoice_sent | Mark an invoice as sent (for invoices delivered outside Jobber) |
示例提示
- “明天排了哪些上门?每个上门分别由谁负责?”
- “列出已逾期的发票,包括客户、余额和到期日。”
- “显示本周的新服务请求,并为清理排水槽的那条起草一份报价,我先审核。”
- “哪些工单需要开票?为 Thompson 的工单创建发票草稿,保存前先给我看。”
- “哪些报价已经等待回复超过两周?”
FAQ
Cursor 免费套餐支持自定义 MCP 服务器吗? 支持,Hobby、Pro 和 Business 套餐均可使用 MCP。
下一步
这份指南对你有帮助吗?