OpsConduit Jobber MCP

Servidor MCP somente leitura, hospedado pelo cliente, para consultas operacionais de proprietário/admin do Jobber.

GitHub
1
Experimente este MCPPatrocinado

Documentação

OpsConduit Jobber MCP

Conector MCP somente leitura para operações de campo do Jobber.

A OpsConduit ajuda proprietários e operadores a fazer perguntas práticas sobre as ferramentas que gerenciam seus negócios. Este primeiro conector é para o Jobber e foi projetado para permanecer somente leitura por padrão.

Visão geral voltada ao comprador: docs/index.md. Perguntas comuns de compradores são respondidas em docs/faq.md. Exemplos de prompts para proprietários/operadores estão em docs/operator-prompts.md. Formato inicial da entrega paga: docs/first-report.md.

O Que Deve Responder

  • Quais orçamentos precisam de acompanhamento?
  • Quais faturas estão em atraso?
  • Quais trabalhos estão não agendados, parados ou bloqueados?
  • Quais clientes não tiveram atividade recentemente?
  • Que trabalho precisa de atenção esta semana?
  • Onde o acompanhamento operacional está vazando receita?

Mais exemplos voltados ao comprador estão em docs/use-cases.md.

Um exemplo fictício de saída está disponível em docs/demo-output.md, ou execute:

npm run demo

O formato de entrega do piloto pago está documentado em docs/pilot-deliverable-template.md.

Postura do Produto

  • Hospedado pelo cliente primeiro.
  • Somente leitura primeiro.
  • Nenhuma custódia de credenciais necessária para o repositório público.
  • Nenhuma escrita autônoma em sistemas do cliente.
  • Nenhuma raspagem de dados privados.
  • Nenhuma alegação falsa, depoimento falso ou divulgação enganosa.

Oferta de Lançamento

Os preços de acesso antecipado estão documentados em docs/offer.md.

Para configuração do piloto, envie um e-mail para opsconduit@gmail.com com o assunto Jobber pilot. Não envie senhas do Jobber, tokens, segredos de API ou dados privados de clientes por e-mail.

Instalação

Requer 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

Preencha JOBBER_CLIENT_ID e JOBBER_CLIENT_SECRET em .env antes de executar o auxiliar de autenticação. O auxiliar imprime uma URL de autorização OAuth do Jobber, recebe o callback local em http://localhost:3333/oauth/callback e armazena os tokens em .opsconduit/jobber-tokens.json.

Instruções detalhadas de configuração estão em docs/install.md. As etapas de validação do piloto pago estão em docs/pilot-checklist.md. Notas de implementação para a API GraphQL do Jobber estão em docs/jobber-api-notes.md.

Ferramentas MCP

  • jobber_auth_url - cria o link de autorização OAuth único do Jobber para uma instalação hospedada pelo cliente.
  • jobber_exchange_code - troca o código OAuth redirecionado e armazena os tokens localmente sem expô-los no chat.
  • jobber_refresh_token - renova o token de acesso armazenado para relatórios contínuos somente leitura.
  • jobber_account - valida a conta conectada antes de executar consultas operacionais.
  • jobber_clients_sample - valida o acesso de leitura com uma amostra limitada de clientes.
  • jobber_graphql_read - executa GraphQL do Jobber somente leitura para relatórios do proprietário; mutações são bloqueadas antes do envio.

Políticas

Status

Este repositório está em implementação inicial. O primeiro alvo utilizável é um servidor MCP hospedado pelo cliente com configuração OAuth local e acesso GraphQL do Jobber somente leitura.