DoneOnce › Ayuda › Su asistente de IA en DoneOnce

Su asistente de IA en DoneOnce

DoneOnce tiene un servidor MCP: la forma estándar en que un asistente de IA (Claude, ChatGPT y otros) se conecta a una app. Una vez conectado, puede pedirle a su asistente cosas como "agrega a los García en 12 Oak St, cada dos semanas los martes", "¿quién está atrasado con los pagos?" o "mándale a Ana el presupuesto de la limpieza de la piscina", y el trabajo se hace dentro de su DoneOnce, como usted.

Puede hacer exactamente lo que usted puede hacer en la app, y nada más: el asistente de un técnico ve el día y los clientes, el de la oficina ve el dinero. Todo lo que envía mensajes se lo describe primero y solo lo hace después de su sí. El dinero nunca se mueve por una llamada de un asistente: los reembolsos, los cobros, los recordatorios de pago, conectar Stripe y su facturación de DoneOnce los hace usted, en DoneOnce, en la pantalla de Pagos. Su asistente se lo dice.

Empezar desde su asistente

¿Todavía no tiene cuenta en DoneOnce? Dígale a su asistente "configúrame en DoneOnce". Le mostrará un link como https://app.doneonce.app/device?code=BCDF-GHJK y el código.

  1. Abra el link y revise que la página muestre el mismo código que le muestra su asistente.
  2. Pulse Crear mi negocio (o Ya tengo una cuenta y entre). Un negocio nuevo confirma su correo primero; el link de ese correo lo devuelve a la misma página.
  3. Lea quién lo pide y pulse Aprobar. Luego vuelva a su asistente: configura con usted sus zonas, precios y clientes, y le muestra cada paso antes de guardar.

Un código dura 30 minutos y sirve una vez. Si se vence, pídale a su asistente un link nuevo; su cuenta y su negocio se conservan.

Conectar Claude (claude.ai o la app de escritorio)

  1. En Claude, abra Personalizar → Conectores (Customize → Connectors), pulse + y elija Añadir conector personalizado (Add custom connector).
  2. Póngale de nombre DoneOnce y pegue esta URL: https://mcp.doneonce.app/mcp
  3. Pulse Añadir y luego Conectar. Se abre una ventana de DoneOnce: entre con su email y contraseña de DoneOnce, elija qué puede hacer (Solo lectura, lo predeterminado, o Leer y hacer cambios) y pulse Aprobar.

Eso es todo: ningún token que copiar. El plan gratuito de Claude permite un conector personalizado; los planes de pago, más.

Conectar Claude Code

En una terminal:

claude mcp add --transport http --scope user doneonce https://mcp.doneonce.app/mcp

Luego escriba /mcp dentro de Claude Code, elija doneonce y entre de la misma forma.

Otros asistentes

Cualquier asistente que admita conectores MCP remotos con inicio de sesión (OAuth) funciona con la misma URL. Un programa que solo puede enviar una cabecera fija puede usar un token: en DoneOnce, Ajustes → Asistentes de IA → Cómo conectar → Con un token, genere uno y envíelo como Authorization: Bearer <token>.

Usted sigue al mando

Para el asistente que lee esto

Traer una lista completa de clientes (para el asistente)

La persona le da su hoja de cálculo — una exportación de Jobber, Housecall Pro, QuickBooks, Excel o Google Sheets. Dos herramientas, siempre en este orden:

  1. import_book con el archivo como texto, tal cual se lo dieron, con la fila de encabezados primero. Nunca reescriba, limpie ni resuma filas: el servidor lee el archivo con las mismas reglas que usa Importar CSV en la app, y todavía no se escribe nada. El separador puede ser coma, tabulador, punto y coma o barra vertical (lo decide la fila de encabezados), y una tabla markdown (| Name | Address | sobre una fila |---|---|) se lee como tabla. Los hints de la respuesta advierten sobre el archivo mismo —un código postal que perdió su cero inicial, un negocio sin zonas—: transmítaselos a la persona. Nombre las columnas solo si la suposición de la respuesta está mal (mapping: name, street, zip obligatorios; phone, email, category, day, frequency, notes, tech opcionales; null deja uno fuera). Una columna como "Assigned to", "Team" o "Technician" se lee como el técnico: quien tenía la visita en la app anterior. Si el archivo trae la dirección completa en una sola columna ("12 Oak St, Stuart, FL 34994"), déjela así: sin columna de código postal, el servidor lo lee del final de la dirección (zipFromAddress: true en la respuesta) y rechaza con su motivo la fila que no lo trae.
  2. Muéstrele a la persona la respuesta en palabras sencillas: cuántos serán clientes, cuántos tendrán un servicio semanal o cada dos semanas y qué día (lo decide la zona que cubre el código postal, luego la columna de día del archivo), qué filas se rechazan y por qué, cuáles quedan sin servicio y por qué, y las categorías nuevas. Si una columna se leyó mal, corrija mapping y vuelva a previsualizar.
  3. commit_import con el importId, solo después de su sí. Llámelo otra vez mientras remaining sea mayor que 0 — sigue donde se quedó y nunca escribe una fila dos veces. Después informe los totales: creados, servicios, duplicados, fallidos (cada fallo trae su motivo).

Lo que entra: cada cliente con su dirección como la principal (códigos de portón y notas en la dirección), su categoría y su servicio recurrente o de una sola vez, sin asignar. Después, dos herramientas más, en este orden:

  1. import_week (solo lectura) muestra la semana que armaría la importación: por cada día, quién maneja cuántas visitas, los minutos y los ingresos, y qué no se puede asignar todavía y por qué. La zona que cubre el código postal decide la persona y el día; sin zona, la persona que nombra el archivo (asociada al equipo por nombre, o por primer nombre cuando es único); sin nombre en el archivo y con un solo conductor, ese conductor. Una visita de una sola vez va en el día de su fecha; la que cae después de los próximos 7 días se cuenta en laterOnce (igual se asigna en su fecha) y no se dibuja en la semana. Un nombre que el equipo no reconoce vuelve en unmatchedTechs: pregunte al dueño quién es. Con holdNamed: true el equipo nunca se asocia por nombre: cada visita con nombre espera la respuesta del dueño en techMap. Úselo cuando un nombre del archivo pueda confundirse con alguien (un dueño llamado "Carlos Pérez" y un técnico que el archivo llama "Carlos"), y pase el mismo valor a place_import.
  2. place_import, después de su sí, pone esa semana en las rutas. Llámela otra vez mientras done sea falso (ubica hasta 100 por llamada y antes localiza las direcciones que aún esperan), enviando el next de la respuesta como after, y sin after cuando next es nulo: eso significa que las direcciones recién localizadas se recorren otra vez desde el principio. Pase las respuestas del dueño como techMap ({"Johnny": "<id del miembro>"}); un nombre sin asociar, una visita cuya dirección no se pudo localizar (location_missing) y una visita de una sola vez con fecha pasada quedan sin asignar y se listan. location_pending es distinto: el mapa todavía no encontró la dirección (está lento o caído), así que diga que se sigue buscando y vuelva a llamar más tarde. Un servicio que ya está en una ruta nunca se mueve, y volver a llamarla no asigna nada dos veces.

place_queue y place_queue_apply siguen sirviendo para asignar la cola recurrente por sus zonas fuera de una importación (o la oficina lo hace desde la cola de la semana en la app). Configure las zonas antes de importar si el negocio las tiene, para que los días salgan bien.

Cuando la lista de clientes no es un archivo

Una lista en texto corrido, la foto de una hoja o un correo todavía no es un CSV: usted lo arma, y la persona lo aprueba con la misma vista previa:

Cambiar desde Jobber o Housecall Pro: tres archivos, en este orden (para el asistente)

Un negocio que deja otra app exporta tres archivos. Tráigalos con las mismas dos herramientas, un archivo a la vez, siempre en este orden:

  1. La lista de clientes: import_book como arriba (kind: "book", el valor por defecto), luego commit_import.
  2. Las cotizaciones abiertas: import_book con kind: "quotes", luego commit_import.
  3. Los saldos pendientes (lo que cada cliente todavía debe): import_book con kind: "balances" y vendor ("Jobber", "Housecall Pro"), luego commit_import.

El orden importa porque una cotización o un saldo nunca crea un cliente: cada fila debe nombrar a un cliente que ya está en la libreta, con el mismo correo o teléfono y el mismo nombre, o el mismo nombre en la misma dirección. Una fila que nombra a otra persona se rechaza (quoteClientNotFound, balanceClientNotFound) y los hints de la respuesta dicen que primero hay que importar la lista de clientes. Pase siempre kind para estos dos archivos: sin kind, el archivo se lee como lista de clientes, digan lo que digan sus encabezados. Cuando los encabezados de una vista previa de clientes parecen de cotizaciones o de saldos, la respuesta trae looksLike ("quotes" o "balances") y una pista —"This looks like a list of open balances; import it as balances?"—: pregúntele a la persona y vuelva a previsualizar con ese kind. Nada pasa a ser cotización ni saldo si kind no lo dice. Un archivo de cotizaciones o de saldos de más de 1,000 filas se rechaza entero (divídalo, con las líneas de cada cotización en el mismo archivo); nunca se corta. Una lista de clientes de más de 1,000 filas se corta, y su respuesta dice truncated: true.

Las cotizaciones pasan a ser presupuestos. Una cotización abierta, enviada o esperando respuesta pasa a ser un presupuesto en el estado "enviado, esperando respuesta", con la fecha en que se envió, y no se le envía nada al cliente: ni correo ni mensaje de texto. La oficina puede registrar el sí, dejar que venza o enviar el enlace después desde la app. Un borrador sigue siendo borrador, y también toda cotización cuyo estado el archivo no dice —sin columna de estado o con la celda vacía (quoteStatusUnknown)—: una cotización nunca se supone abierta. Las cotizaciones aprobadas, convertidas, rechazadas, archivadas o vencidas son historia y no se importan (quoteClosed). Las columnas: nombre, correo, teléfono y dirección del cliente, el número de cotización, un título o descripción, el total —o sus líneas (descripción, cantidad, precio unitario; las filas que comparten número de cotización son las líneas de una sola)—, el estado, la fecha y el vencimiento. Las líneas se conservan y el total debe coincidir con ellas al centavo (quoteTotalMismatch si no): nunca ajuste el archivo para que cuadre; dígale a la persona qué cotización no coincide. El número de cotización queda en el presupuesto. El quotes de la respuesta dice cuántos presupuestos, cuántos enviados y cuántos borradores, y su total.

Los saldos pasan a ser líneas en borrador para cobrar. Cada saldo es una línea facturable en borrador de ese cliente —"Saldo pendiente traspasado desde Jobber al 1 nov 2026" (en inglés si el idioma del negocio es inglés)— que la oficina aprueba y factura en la pantalla de Facturación. La importación no crea facturas ni cobra nada. Un saldo en cero o a favor del cliente no se importa (balanceNotOwed). Las columnas: nombre, correo, teléfono y dirección del cliente, el monto adeudado, la fecha de corte ("as of") y un número de factura o una nota. Un cliente tiene un solo saldo inicial: las filas con número de factura son una línea cada una, y las filas de un cliente sin número se suman en una sola línea (balanceSummed dice cuáles). Un cliente cuyas filas mezclan números de factura y un total suelto —un reporte de antigüedad de saldos que trae ambos— no recibe ninguna (balanceMixedRows, con las dos sumas): la persona deja uno u otro. Un cliente que ya tiene un saldo inicial de una importación anterior, en cualquier estado, se rechaza (balanceAlreadyImported, con ese monto): una nueva exportación después de un pago parcial nunca se cobra dos veces; corrija esa línea en Facturación. Importar saldos requiere ser el dueño (admin) o un gerente del departamento de facturación; importar cotizaciones, el dueño o un gerente del departamento de ventas (la importación misma es de la oficina: admin o gerente).

El mismo archivo dos veces no agrega nada: una cotización o un saldo ya importado cuenta como duplicado.

Actualizado 2026-11-15

14 días gratis, sin tarjeta. La configuración la hacemos con usted, en español.

Empezar gratis