jobkeepr

Servidor MCP de Jobkeepr

Conecta Jobkeepr a Claude, ChatGPT o cualquier otro cliente MCP, para que un asistente de IA pueda leer y gestionar tu negocio de servicio de campo: trabajos, clientes, programación, presupuestos, facturas y pagos.

Jobkeepr es un software de gestión de servicio de campo para pequeñas cuadrillas de contratistas: manitas, instaladores de TV, fontaneros, electricistas, técnicos de HVAC, que operan con una a diez personas.

"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."

Dos formas de conectarse

Remoto (recomendado). Si tu cliente admite servidores MCP remotos, apúntalo directamente al endpoint alojado y omite este paquete por completo:

https://jobkeepr.com/mcp

Admite OAuth, así que inicias sesión con tu inicio de sesión normal de Jobkeepr y apruebas el acceso en el navegador. No hay nada que instalar.

stdio (este paquete). Para clientes que solo hablan stdio, esto actúa como puente hacia el mismo servidor usando una clave de API.

Este paquete no está en npm. Instálalo directamente desde GitHub usando el especificador github:dandyer/jobkeepr-mcp que se muestra a continuación. Un npx jobkeepr-mcp simple no se resolverá. npm compila el TypeScript por ti durante la instalación, así que no hay nada extra que ejecutar.

Configuración

Crea una clave de API en Jobkeepr en Configuración → Claves de API. Se muestra una sola vez, así que cópiala en ese momento.

Claude Desktop

Añade a 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

O conéctate directamente al endpoint remoto:

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

Herramientas

Lectura

Herramienta	Qué hace
get_business_context	Nombre del negocio, zona horaria, horario laboral y la fecha de hoy con rangos resueltos para "esta semana", "el mes pasado", etc.
get_jobs	Trabajos filtrados por fecha, estado, cliente, tipo o fuente
get_customers	Buscar clientes, opcionalmente con recuentos de trabajos y totales
get_schedule	Trabajos programados, eventos de calendario y franjas horarias disponibles
get_estimates	Presupuestos y su estado
get_invoices	Facturas y saldos pendientes
get_payments	Pagos recibidos
get_line_items	Partidas de trabajos, para análisis de márgenes y mezcla
get_reference_data	Tipos de trabajo, fuentes de clientes potenciales y el catálogo de precios

Escritura

Herramienta	Qué hace
create_job	Reservar un trabajo para un cliente
create_event	Añadir un evento de calendario que no sea un trabajo, como tiempo libre o una visita
create_customer	Añadir un cliente
create_estimate	Crear un presupuesto
create_catalog_item	Añadir un servicio o producto al catálogo de precios
add_line_items	Añadir partidas facturables a un trabajo
set_customer_source	Registrar cómo encontró el cliente el negocio
reschedule_job	Mover un trabajo a una nueva fecha u hora
cancel_job	Cancelar un trabajo programado
close_jobs	Marcar trabajos como completados

Las herramientas financieras requieren el permiso VIEW_FINANCIALS, y cada herramienta de escritura requiere su permiso correspondiente. Las herramientas que no puedes usar no se te muestran.

Lo que no hará

Ninguna herramienta aquí puede enviar mensajes de texto a tus clientes. El envío de SMS está deliberadamente excluido: es la única acción que llega a una persona real y no se puede deshacer. Pide a tu asistente que redacte un mensaje y envíalo tú mismo desde Jobkeepr.

Las escrituras surten efecto de inmediato. No hay paso de ensayo ni deshacer, por eso cancel_job y close_jobs están marcadas como destructivas para que tu cliente pida confirmación antes de ejecutarlas. close_jobs puede actuar sobre muchos trabajos a la vez, así que revisa el conjunto antes de aprobarlo.

Configuración

Variable	Obligatoria	Predeterminado	Notas
JOBKEEPR_API_KEY	sí	—	Desde Configuración → Claves de API. Empieza con jk_live_.
JOBKEEPR_URL	no	https://jobkeepr.com	Anular solo para autoalojado o ensayo.

Una clave de API actúa sobre una cuenta y tiene acceso de nivel propietario. Revócala en cualquier momento en Configuración → Claves de API. Para dar a un asistente un acceso más limitado por usuario, usa el endpoint remoto con OAuth.

Cómo funciona

Este paquete es un proxy, no una reimplementación. Las herramientas viven en el servidor alojado; esto hace de puente entre stdio y ese servidor. Eso significa que el conjunto de herramientas aquí siempre está actualizado y este paquete rara vez necesita una versión nueva.

Desarrollo

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

Prueba de forma interactiva con el Inspector MCP:

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

Enlaces

• Jobkeepr
• Model Context Protocol

Con licencia MIT.