OpsConduit Jobber MCP

Servidor MCP de solo lectura, alojado por el cliente, para consultas operativas del propietario/administrador de Jobber.

GitHub
1

Documentación

OpsConduit Jobber MCP

Conector MCP de solo lectura para operaciones de servicio en campo de Jobber.

OpsConduit ayuda a propietarios y operadores a hacer preguntas prácticas sobre las herramientas que impulsan su negocio. Este primer conector es para Jobber y está diseñado para mantenerse de solo lectura por defecto.

Resumen general orientado al comprador: docs/index.md. Las preguntas comunes de los compradores se responden en docs/faq.md. Ejemplos de indicaciones para propietarios/operadores están en docs/operator-prompts.md. Formato inicial del entregable de la primera instalación de pago: docs/first-report.md.

Qué Debería Responder

  • ¿Qué presupuestos necesitan seguimiento?
  • ¿Qué facturas están vencidas?
  • ¿Qué trabajos no están programados, están obsoletos o bloqueados?
  • ¿Qué clientes no han tenido actividad recientemente?
  • ¿Qué trabajo necesita atención esta semana?
  • ¿Dónde está el seguimiento operativo filtrando ingresos?

Más ejemplos orientados al comprador están en docs/use-cases.md.

Hay una muestra ficticia de salida disponible en docs/demo-output.md, o ejecuta:

npm run demo

El formato de entrega del piloto de pago está documentado en docs/pilot-deliverable-template.md.

Postura del Producto

  • Alojado por el cliente primero.
  • Solo lectura primero.
  • Sin custodia de credenciales requerida para el repositorio público.
  • Sin escrituras autónomas en los sistemas del cliente.
  • Sin extracción de datos privados.
  • Sin afirmaciones falsas, testimonios falsos o divulgación engañosa.

Oferta de Lanzamiento

Los precios de acceso anticipado están documentados en docs/offer.md.

Para la configuración del piloto, envía un correo a opsconduit@gmail.com con el asunto Jobber pilot. No envíes contraseñas de Jobber, tokens, secretos de API o datos privados de clientes por correo electrónico.

Instalación

Requiere 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

Completa JOBBER_CLIENT_ID y JOBBER_CLIENT_SECRET en .env antes de ejecutar el asistente de autenticación. El asistente imprime una URL de autorización OAuth de Jobber, recibe la devolución de llamada local en http://localhost:3333/oauth/callback y almacena los tokens en .opsconduit/jobber-tokens.json.

Las notas detalladas de configuración están en docs/install.md. Los pasos de validación del piloto de pago están en docs/pilot-checklist.md. Las notas de implementación para la API GraphQL de Jobber están en docs/jobber-api-notes.md.

Herramientas MCP

  • jobber_auth_url - crea el enlace de autorización OAuth de Jobber de un solo uso para una instalación alojada por el cliente.
  • jobber_exchange_code - intercambia el código OAuth redirigido y almacena los tokens localmente sin exponerlos en el chat.
  • jobber_refresh_token - renueva el token de acceso almacenado para continuar con los informes de solo lectura.
  • jobber_account - valida la cuenta conectada antes de ejecutar consultas operativas.
  • jobber_clients_sample - valida el acceso de lectura con una muestra de clientes limitada.
  • jobber_graphql_read - ejecuta GraphQL de Jobber de solo lectura para informes del propietario; las mutaciones se bloquean antes de enviarse.

Políticas

Estado

Este repositorio está en implementación temprana. El primer objetivo utilizable es un servidor MCP alojado por el cliente con configuración OAuth local y acceso GraphQL de Jobber de solo lectura.