English Français العربية

OpsConduit Jobber MCP

السجل الرسمي أخرى

Customer-hosted read-only MCP server for Jobber ops reports, OAuth setup, and GraphQL validation.

الشيفرة المصدرية التوثيق

ماذا يمكنك أن تفعل مع OpsConduit Jobber MCP؟

  • jobber_auth_url - create the one-time Jobber OAuth authorization link for a customer-hosted install.
  • jobber_exchange_code - exchange the redirected OAuth code and store tokens locally without exposing them in chat.
  • jobber_refresh_token - refresh the stored access token for continued read-only reporting.
  • jobber_account - validate the connected account before running operational queries.
  • jobber_clients_sample - validate read access with a capped client sample.
  • jobber_graphql_read - run read-only Jobber GraphQL for owner reports; mutations are blocked before sending.

التثبيت

أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: ‏.cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «mcpServers»).

NPM package @opsconduit/jobber-mcp
Claude Code 
claude mcp add opsconduit-jobber-mcp -e 'JOBBER_CLIENT_ID=<JOBBER_CLIENT_ID>' -e 'JOBBER_CLIENT_SECRET=<your jobber_client_secret>' -e 'JOBBER_REDIRECT_URI=<JOBBER_REDIRECT_URI>' -- npx -y @opsconduit/jobber-mcp@0.1.3
إعداد JSON (Claude Desktop وCursor وVS Code) 
{
    "mcpServers": {
        "opsconduit-jobber-mcp": {
            "command": "npx",
            "args": [
                "-y",
                "@opsconduit/jobber-mcp@0.1.3"
            ],
            "env": {
                "JOBBER_CLIENT_ID": "<JOBBER_CLIENT_ID>",
                "JOBBER_CLIENT_SECRET": "<your jobber_client_secret>",
                "JOBBER_REDIRECT_URI": "<JOBBER_REDIRECT_URI>"
            }
        }
    }
}

متغيرات البيئة

  • JOBBER_CLIENT_ID إلزامي Jobber 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_URI OAuth redirect URI, usually http://localhost:3333/oauth/callback for local setup.

التوثيق

مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.

المحتويات
  1. OpsConduit Jobber MCP
  2. What It Should Answer
  3. Product Posture
  4. Launch Offer
  5. Install
  6. MCP Tools
  7. Policies
  8. Status

OpsConduit Jobber MCP

Read-only MCP connector for Jobber field-service operations.

OpsConduit helps owners and operators ask practical questions about the tools that run their business. This first connector is for Jobber and is designed to stay read-only by default.

Plain buyer-facing overview: docs/index.md. Common buyer questions are answered in docs/faq.md. Example owner/operator prompts are in docs/operator-prompts.md. First paid-install deliverable shape: docs/first-report.md.

What It Should Answer

  • Which estimates need follow-up?
  • Which invoices are overdue?
  • Which jobs are unscheduled, stale, or blocked?
  • Which customers have not had activity recently?
  • What work needs attention this week?
  • Where is operational follow-up leaking revenue?

More buyer-facing examples are in docs/use-cases.md.

A fictional sample output is available in docs/demo-output.md, or run:

npm run demo

The paid pilot handoff format is documented in docs/pilot-deliverable-template.md.

Product Posture

  • Customer-hosted first.
  • Read-only first.
  • No credential custody required for the public repo.
  • No autonomous writes in customer systems.
  • No scraping private data.
  • No fake claims, fake testimonials, or deceptive outreach.

Launch Offer

Early-access pricing is documented in docs/offer.md.

For pilot setup, email opsconduit@gmail.com with the subject Jobber pilot. Do not send Jobber passwords, tokens, API secrets, or private customer data by email.

Install

Requires 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

Fill JOBBER_CLIENT_ID and JOBBER_CLIENT_SECRET in .env before running the auth helper. The helper prints a Jobber OAuth URL, receives the local callback at http://localhost:3333/oauth/callback, and stores tokens in .opsconduit/jobber-tokens.json.

Detailed setup notes are in docs/install.md. Paid pilot validation steps are in docs/pilot-checklist.md. Implementation notes for Jobber's GraphQL API are in docs/jobber-api-notes.md.

MCP Tools

  • jobber_auth_url - create the one-time Jobber OAuth authorization link for a customer-hosted install.
  • jobber_exchange_code - exchange the redirected OAuth code and store tokens locally without exposing them in chat.
  • jobber_refresh_token - refresh the stored access token for continued read-only reporting.
  • jobber_account - validate the connected account before running operational queries.
  • jobber_clients_sample - validate read access with a capped client sample.
  • jobber_graphql_read - run read-only Jobber GraphQL for owner reports; mutations are blocked before sending.

Policies

Status

This repository is in early implementation. The first usable target is a customer-hosted MCP server with local OAuth setup and read-only Jobber GraphQL access.

الأسئلة الشائعة

ما هو OpsConduit Jobber MCP؟

Customer-hosted read-only MCP server for Jobber ops reports, OAuth setup, and GraphQL validation.

كيف أثبّت OpsConduit Jobber MCP؟

يعمل على جهازك. في Claude Code: claude mcp add opsconduit-jobber-mcp -e 'JOBBER_CLIENT_ID=<JOBBER_CLIENT_ID>' -e 'JOBBER_CLIENT_SECRET=<your jobber_client_secret>' -e 'JOBBER_REDIRECT_URI=<JOBBER_REDIRECT_URI>' -- npx -y @opsconduit/jobber-mcp@0.1.3. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.

هل يحتاج OpsConduit Jobber MCP إلى مفتاح API؟

نعم. يتطلب JOBBER_CLIENT_ID, JOBBER_CLIENT_SECRET، وتضبطها في إعداداته.

هل OpsConduit Jobber MCP مفتوح المصدر؟

نعم. شيفرته متاحة على GitHub بترخيص MIT.

من يصون OpsConduit Jobber MCP؟

ينشره opsconduit. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.

من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.