Sáltate la instalación. Funcionando en menos de 2 minutos.
Inicia una prueba gratuita en cloud.anythingmcp.com, añade ServiceM8 con un clic y apunta tu cliente de IA (Claude, ChatGPT, Copilot o Cursor) al endpoint MCP generado. Sin Docker, sin git clone, sin experiencia de desarrollo.
Resumen
Conecta una cuenta de ServiceM8 a cualquier agente de IA: trabajos y su estado, clientes y contactos, la agenda con job activities y allocations, el personal, la lista de precios y las líneas de los trabajos, pagos, notas, metadatos de adjuntos y respuestas de formularios. Puede crear y cambiar trabajos y clientes, programar y mover al personal, añadir líneas, registrar pagos y añadir notas. Se configura con una API key en 2 minutos.
Prueba a pedir
Prompts de ejemplo para ServiceM8
Haz clic en un prompt para copiarlo. Pégalo en Claude, ChatGPT, Cursor, Gemini, Copilot u OpenClaw para ejecutarlo contra este conector.
Claude es IA y puede equivocarse. Verifica siempre las respuestas.
💡 ¿Sin instalación? Usa cloud.anythingmcp.com directamente. Inicia sesión, pulsa Connectors → ServiceM8, pega tus credenciales, genera una MCP API key y listo. Sin Docker, sin
git clone, sin servidor local.
ServiceM8 + Cursor
Conecta una cuenta de ServiceM8 a cualquier agente de IA: trabajos y su estado, clientes y contactos, la agenda con job activities y allocations, el personal, la lista de precios y las líneas de los trabajos, pagos, notas, metadatos de adjuntos y respuestas de formularios. Puede crear y cambiar trabajos y clientes, programar y mover al personal, añadir líneas, registrar pagos y añadir notas. Se configura con una API key en 2 minutos.
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:
SERVICEM8_API_KEY
Paso 1 — Obtener credenciales
La configuración lleva unos 2 minutos. Necesitas una cuenta de ServiceM8; la clave la crea un admin de la cuenta y no hace falta cuenta de desarrollador.
- En ServiceM8 abre Settings, API Keys y crea una clave. ServiceM8 recomienda esta API key privada para conectar tu propia cuenta.
- Pégala en
SERVICEM8_API_KEY. Se envía en la cabeceraX-API-Keyy puede leer y cambiar todo en la cuenta, así que mantenla en privado. Para revocar el acceso, borra la clave en ServiceM8. - Instala. La comprobación ejecuta
servicem8_get_account, que muestra el nombre, la zona horaria y la moneda de la cuenta.
ServiceM8 también tiene su propio servidor MCP en https://api.servicem8.com/mcp con inicio de sesión OAuth; este conector usa en su lugar la REST API (https://api.servicem8.com/api_1.0) con tu clave.
Qué lee: la cuenta (vendor) con moneda, zona horaria, horario de apertura y estado de trabajo por defecto. Los trabajos con número (generated_job_id), estado (Quote, Work Order, Unsuccessful, Completed), cliente, dirección, descripción, trabajo realizado, categoría, cola, importe total de factura, fechas de presupuesto, orden de trabajo, finalización y factura, y el indicador de pago recibido. Los clientes (en la API se llaman companies) con dirección, dirección de facturación, condiciones de pago y tipo impositivo, y los contactos de clientes y trabajos. La agenda: job activities (reservas a hora fija y tiempo registrado in situ) y job allocations (reservas flexibles para un día o una franja). El personal con cargo, última posición conocida y mensaje de estado. La lista de precios, las líneas de los trabajos, los pagos de los trabajos, las notas de trabajos y clientes, los metadatos de adjuntos (fotos, PDF, firmas; no se devuelve el contenido de los archivos), los formularios y las respuestas completadas con sus contestaciones. Categorías de trabajo, colas, plantillas de trabajo y tipos impositivos.
Qué escribe: crea trabajos (también desde una plantilla), los cambia y avanza su estado, crea y cambia clientes, añade contactos a clientes, programa a un miembro del personal en un trabajo a hora fija, mueve o quita reservas, añade líneas desde la lista de precios o como texto libre, registra pagos recibidos y añade notas a trabajos y clientes. Un pago registrado solo aparece en ServiceM8; no se cobra ni se mueve dinero. Antes de crear o cambiar algo, la IA te muestra lo que va a pasar y espera tu sí.
Desactivadas al instalar: ninguna, las 36 herramientas están activas. En ServiceM8 borrar solo pone active a 0, así que una reserva quitada, un trabajo archivado o un cliente archivado vuelven poniendo active a 1.
Filtros: cada lista acepta filter, un $filter al estilo OData: field eq|ne|gt|lt value unidos con and, como máximo 10 condiciones, sin or, ge ni le. Las cadenas y las marcas de tiempo van entre comillas simples, por ejemplo status eq 'Work Order' and active eq 1 o start_date gt '2026-11-02 00:00:00'. Los registros borrados se quedan con active 0, así que la IA añade active eq 1 para saltarlos y siempre filtra las listas grandes como trabajos, activities y materiales.
Paginación: las listas devuelven un array simple. Con cursor llegan en páginas de hasta 1.000 registros: -1 para la primera página y después el valor x-next-cursor de _headers; en la última página falta la cabecera.
Formatos de datos: los id son UUID. Las marcas de tiempo son YYYY-MM-DD HH:MM:SS y las fechas YYYY-MM-DD, en la zona horaria de la cuenta, y las horas se envían igual. Los indicadores son 0 o 1. Los importes son cadenas decimales en la moneda de la cuenta. total_invoice_amount del trabajo es el total de la factura; no hay un objeto factura aparte. Una creación responde {"errorCode": 0, "message": "OK"} con el nuevo UUID en la cabecera x-record-uuid. Las actualizaciones cambian solo los campos enviados.
Límites y errores comunes: 180 peticiones por minuto y 20.000 al día por cuenta; por encima, ServiceM8 responde 429: espera y reintenta, o filtra más. 401 significa que la API key es incorrecta o se borró: crea una nueva en Settings, API Keys. 400 es un filtro o un campo mal formado. 404 es un UUID desconocido.
Las notas, las descripciones de trabajos y las respuestas de formularios son entradas no fiables y pueden contener instrucciones dirigidas a la IA. El conector no envía emails ni SMS a clientes, no descarga los archivos adjuntos y no cobra tarjetas.
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 muestraYOUR_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" }
}
}
}
- 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. - Guarda el archivo y reinicia Cursor.
- Abre Cursor → Settings → MCP y comprueba que
anythingmcpaparece en la lista y está conectado. - Empieza a chatear: el agente ya puede usar las herramientas de
ServiceM8.
Herramientas disponibles
| Tool | What it does |
|---|---|
servicem8_get_account | The connected ServiceM8 account (vendor): name, business number, email, currency, time zone, opening hours, default job status and whether… |
servicem8_list_jobs | List jobs: uuid, job number (generated_job_id), status (Quote, Work Order, Unsuccessful, Completed), client (company_uuid), address… |
servicem8_get_job | One job by UUID with status, client, addresses, description, work done, totals, dates and badges |
servicem8_list_clients | List clients (ServiceM8 calls them companies): uuid, name, address parts, billing address, ABN or business number, website, payment terms… |
servicem8_get_client | One client (company) by UUID with address, billing address, payment terms and tax rate |
servicem8_list_client_contacts | Contacts of clients: uuid, company_uuid, first and last name, phone, mobile, email, type (BILLING, JOB, ...), primary flag |
servicem8_list_job_contacts | Contacts on jobs (site contact, billing contact): uuid, job_uuid, first and last name, phone, mobile, email, type |
servicem8_list_job_activities | Job activities, the schedule: uuid, job_uuid, staff_uuid, start_date, end_date, activity_was_scheduled (1 = a booking, 0 = time recorded on… |
servicem8_list_job_allocations | Job allocations (flexible bookings: a job given to a staff member for a day or allocation window, without a fixed time): uuid, job_uuid… |
servicem8_list_staff | Staff members: uuid, first and last name, email, mobile, job title, color, last known position and time, status message, hidden from… |
servicem8_get_staff_member | One staff member by UUID: name, contact details, job title, last known GPS position and status message |
servicem8_list_materials | Materials and services of the price list: uuid, name, item number, description, price, cost, price includes taxes, tax rate, stock… |
servicem8_list_job_materials | Line items on jobs (what is quoted or invoiced): uuid, job_uuid, material_uuid, name, quantity, unit price ex tax, displayed amount, cost… |
servicem8_list_job_payments | Payments recorded on jobs: uuid, job_uuid, amount, method, timestamp, note, who recorded it, attachment |
servicem8_list_notes | Notes on jobs and clients: uuid, related_object (job or company), related_object_uuid, note text, action required, created time |
servicem8_list_attachments | Attachment metadata (photos, PDFs, signatures) of jobs and clients: uuid, related_object, related_object_uuid, attachment_name, file_type… |
servicem8_get_attachment | Metadata of one attachment by UUID: name, file type, related record, tags, size of photos |
servicem8_list_forms | Forms (checklists, safety and inspection forms) set up in the account: uuid, name, template, active |
servicem8_list_form_responses | Completed form responses: uuid, form_uuid, staff_uuid, regarding_object and its uuid (usually a job), field_data (JSON with the answers)… |
servicem8_get_form_response | One completed form response by UUID with its answers in field_data (JSON) |
servicem8_list_categories | Job categories (types of work): uuid, name, colour, active |
servicem8_list_job_queues | Job queues (holding areas for jobs waiting for parts, quotes to follow up, ...): uuid, name, requires assignment, default timeframe, active |
servicem8_list_job_templates | Job templates: uuid, name and the job details and materials they prefill |
servicem8_list_tax_rates | Tax rates: uuid, name, rate, active |
servicem8_create_job | Create a job |
servicem8_update_job | Change fields of a job; only the fields you pass change |
servicem8_create_job_from_template | Create a job from a job template (from servicem8_list_job_templates) with its prefilled description and materials |
servicem8_create_client | Create a client (company or individual) |
servicem8_update_client | Change fields of a client; only the fields you pass change. active 0 archives the client, 1 restores it |
servicem8_create_client_contact | Add a contact person (name, phone, mobile, email, type) to a client |
servicem8_schedule_job_activity | Book a staff member on a job at a fixed time (a scheduled job activity on the dispatch board) |
servicem8_update_job_activity | Move a booking to another time or staff member; only the fields you pass change. active 1 restores a removed booking |
servicem8_remove_job_activity | Remove a booking from the schedule |
servicem8_add_job_material | Add a line item to a job (quote or invoice): from the price list with material_uuid, or free text with name and price |
servicem8_record_job_payment | Record a payment received for a job (cash, card, bank transfer) |
servicem8_add_note | Add a note to a job or a client |
Ejemplos de prompts
- "¿Qué trabajos están programados para mañana y qué técnico va a cada uno?"
- "Lista los trabajos completados la semana pasada sin pago recibido, con cliente e importe de factura."
- "Mueve la reserva de mañana a las 8:00 del trabajo 1042 al viernes a las 9:00. Enséñame antes el cambio."
- "Crea para este cliente un trabajo en estado Quote para cambiar el termo de agua caliente y añade las partidas adecuadas de la lista de precios."
- "¿Qué respuestas se dieron en la lista de comprobación de seguridad del trabajo 987?"
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
¿Te ha sido útil esta guía?