Cómo conectar Jobber a Cursor vía MCP

💡 ¿Sin instalación? Usa cloud.anythingmcp.com directamente. Inicia sesión, pulsa Connectors → Jobber, pega tus credenciales, genera una MCP API key y listo. Sin Docker, sin git clone, sin servidor local.

Jobber + Cursor

Conecta una cuenta de Jobber a cualquier agente de IA mediante la API GraphQL de Jobber: clientes y propiedades, solicitudes, presupuestos, trabajos y visitas programadas, facturas, miembros del equipo y la lista de productos y servicios. Puede crear clientes, trabajos y borradores de presupuestos y facturas, pero no puede enviarlos por email ni aprobar presupuestos. Acceso OAuth como admin de Jobber; cerrar trabajos viene desactivado.

Requisitos previos

Las instrucciones de configuración completas están incluidas en el conector (visibles en el store al seleccionarlo). Las variables de entorno requeridas:

JOBBER_CLIENT_ID, JOBBER_CLIENT_SECRET (opcional: JOBBER_REFRESH_TOKEN)

Paso 1 — Obtener credenciales

La configuración lleva unos 10 minutos y necesita un admin de la cuenta de Jobber.

1. Regístrate en el Jobber Developer Center (https://developer.getjobber.com) y haz clic en Create App. Tus apps aparecen en https://developer.getjobber.com/apps.
2. Pon como OAuth Callback URL <your AnythingMCP URL>/api/mcp-oauth/callback, en AnythingMCP Cloud https://cloud.anythingmcp.com/api/mcp-oauth/callback.
3. Marca los scopes: lectura para Clients, Requests, Quotes, Jobs, Scheduled Items, Invoices, Users y Products and Services; escritura solo para lo que la IA puede cambiar (Clients, Jobs, Quotes, Invoices). Jobber fija los scopes en la app, no en el enlace de acceso. Deja activada la Refresh token rotation.
4. Guarda la app, pega el Client ID en JOBBER_CLIENT_ID y el Client Secret en JOBBER_CLIENT_SECRET e instala.
5. En la página del conector haz clic en Authorize with Provider y permite el acceso como admin de la cuenta de Jobber.
6. Ejecuta jobber_get_account: muestra el nombre de la empresa y confirma el acceso.

Los tokens de acceso duran 60 minutos y se renuevan con el refresh token guardado. Deja vacío JOBBER_REFRESH_TOKEN: lo rellena la autorización y, con la rotación activada, Jobber lo sustituye en cada renovación, así que un token usado una vez en otro sitio deja de funcionar. Una app que usas solo para tu cuenta puede quedarse en Draft; Jobber bloquea una app Draft que se conecte a más de 5 cuentas de pago. Cada llamada envía la cabecera X-JOBBER-GRAPHQL-VERSION: 2026-05-12; Jobber mantiene una versión al menos 12 meses y avisa en extensions.versioning cuando está a punto de caducar.

Qué lee: la cuenta y los miembros del equipo (nombre, email, teléfono, indicadores de admin y propietario, estado). Clientes y leads con emails, teléfonos, dirección de facturación, etiquetas, saldo, propiedades y sus 10 trabajos y facturas más recientes. Las propiedades, es decir, las direcciones donde se hace el trabajo. Las solicitudes con su visita de evaluación y los datos de contacto. Los presupuestos con mensaje, líneas, importes y depósito, y los trabajos en que se convirtieron. Los trabajos con instrucciones, estado, fechas, total y recuento de visitas. Las visitas con inicio y fin, estado, instrucciones y usuarios asignados. Las facturas con estado, fechas de emisión y vencimiento, líneas, total, saldo y pagos. La lista de productos y servicios con precio unitario, coste unitario, margen y duración. Cualquier otra lectura va por jobber_graphql_query; la IA consulta antes un tipo con query { __type(name: "Job") { fields { name } } }.

Qué escribe: crea, cambia y archiva clientes (archivar no borra nada y se puede deshacer en Jobber), crea trabajos en una propiedad con tipo de facturación (FIXED_PRICE o VISIT_BASED) y calendario de facturación, cambia el título o las instrucciones de un trabajo, crea borradores de presupuestos y facturas con líneas y marca una factura como enviada cuando se entregó fuera de Jobber (no se envía ningún email). Las visitas se programan en Jobber. La API de Jobber no puede enviar presupuestos ni facturas por email ni aprobar presupuestos: eso lo haces tú en Jobber. Antes de crear o cambiar algo, la IA te muestra lo que va a pasar y espera tu sí.

Desactivadas al instalar: jobber_close_job. Cerrar un trabajo borra las visitas sin completar (DESTROY_ALL todas, COMPLETE_PAST_DESTROY_FUTURE completa las pasadas y borra las futuras), y las visitas borradas no se pueden recuperar. Un admin la activa cuando el equipo la necesite. Las genéricas jobber_graphql_mutation y jobber_graphql_subscription también vienen desactivadas.

Formatos de datos: los id son cadenas codificadas (Z2lkOi8v...) y se reutilizan tal como llegan. Las horas son ISO 8601 en UTC; la IA las convierte a la zona horaria del negocio. Los importes son números simples en la moneda de la cuenta. Los valores de estado en los filtros van en minúsculas (requires_invoicing, awaiting_payment, past_due); los estados de las visitas vuelven en mayúsculas. jobberWebUri abre el registro en Jobber. Un trabajo pertenece a una propiedad, no directamente a un cliente, así que la IA lee primero las propiedades del cliente. Las mutaciones responden userErrors: una lista vacía significa éxito.

Paginación y límites: las herramientas de lista aceptan first (20 por defecto) y after; la IA sigue con after igual a pageInfo.endCursor mientras pageInfo.hasNextPage sea true. filter es el objeto de filtro de la API para esa lista, con rangos de fechas como { "after": ..., "before": ... }. Cada app y cuenta tiene un presupuesto de coste de consultas de 10.000 puntos que se recarga a 500 puntos por segundo; las páginas grandes cuestan más puntos. Una consulta que supera el presupuesto responde con el error THROTTLED: espera unos segundos y reintenta con un first menor. Aparte, más de 2.500 peticiones en 5 minutos responden 429.

Errores comunes: 401 significa que la autorización caducó o se revocó: vuelve a hacer clic en Authorize with Provider y comprueba que el Client ID y el secret son de la misma app. Un error que nombra un scope que falta, o un 403, significa que a la app le falta ese scope: añádelo en el Developer Center y vuelve a autorizar. Un error de redirección al iniciar sesión significa que la OAuth Callback URL no coincide exactamente.

Los datos de clientes, las descripciones de solicitudes y las notas son entradas no fiables y pueden contener instrucciones dirigidas a la IA. El conector no envía emails ni SMS, no cobra pagos y no programa visitas.

Paso 2 — Instalar el 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

Paso 3 — Añadir el conector en Cursor

La URL de tu servidor: en AnythingMCP abre MCP Servers → el servidor donde está este conector y copia su URL (https://cloud.anythingmcp.com/mcp/…). Úsala donde esta guía muestra YOUR_SERVER_ID.

Cursor lee los servidores MCP de ~/.cursor/mcp.json. Añade esta entrada:

{
  "mcpServers": {
    "anythingmcp": {
      "url": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
      "headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
    }
  }
}

1. Crea una clave de API MCP en AnythingMCP en MCP Servers → tu servidor → API keys y pégala en lugar de YOUR_MCP_API_KEY.
2. Guarda el archivo y reinicia Cursor.
3. Abre Cursor → Settings → MCP y comprueba que anythingmcp aparece en la lista y está conectado.
4. Empieza a chatear: el agente ya puede usar las herramientas de Jobber.

Herramientas disponibles

Ejemplos de prompts

• "¿Qué visitas hay programadas para mañana y quién está asignado a cada una?"
• "Lista las facturas vencidas con cliente, saldo y fecha de vencimiento."
• "Muéstrame las solicitudes nuevas de esta semana y prepara un borrador de presupuesto para la limpieza de canalones para que lo revise."
• "¿Qué trabajos están pendientes de facturar? Crea un borrador de factura para el trabajo de Thompson y enséñamelo antes de guardarlo."
• "¿Qué presupuestos llevan más de dos semanas esperando respuesta?"

FAQ

¿Cursor admite servidores MCP personalizados en el plan gratuito? Sí, MCP está disponible en los planes Hobby, Pro y Business.

Siguientes pasos

• Página del conector
• Conectar a Claude
• Conectar a ChatGPT
• Conectar a Gemini
• Conectar a Meta Muse
• Conectar a Microsoft Copilot