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 + Gemini
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 Gemini
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.
Gemini CLI lee los servidores MCP de ~/.gemini/settings.json (en Windows, %USERPROFILE%\.gemini\settings.json). Añade:
{
"mcpServers": {
"anythingmcp": {
"httpUrl": "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
gemini. - Ejecuta
/mcpdentro de Gemini CLI (ogemini mcp listen tu terminal):anythingmcpdebería aparecer como conectado. - Empieza a escribir prompts: Gemini CLI ya puede llamar a 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
¿Dónde busca Gemini CLI los servidores MCP? En ~/.gemini/settings.json para tu usuario, o en .gemini/settings.json dentro de un proyecto. gemini mcp list muestra cada servidor y si se conecta.
Siguientes pasos
- Página del conector
- Conectar a Claude
- Conectar a ChatGPT
- Conectar a Cursor
- Conectar a Meta Muse
- Conectar a Microsoft Copilot
¿Te ha sido útil esta guía?