Cómo usar el Conector MCP

El Conector es un servidor MCP remoto: se agrega una sola vez en el cliente de IA y queda disponible en todas las conversaciones.

1. Verifica tu permiso. En World Office Cloud, un administrador debe habilitar tu usuario en Seguridad → Usuarios → Modificar para que puedas agregar el Conector.
2. Agrega el conector en tu cliente de IA. En Claude.ai: Configuración → Conectores → Agregar conector personalizado, y pega la URL del servidor MCP que entrega World Office (por ejemplo https://mcp.worldoffice.cloud/mcp).
3. Inicia sesión. Se abre la pantalla de login de World Office. Ingresa tu correo y contraseña habituales; se usan solo para autenticar y no se almacenan.
4. Autoriza. Al terminar, el cliente de IA queda conectado y las herramientas aparecen listadas en la conversación.
5. Pide tu primer informe. Escribe algo como «¿Cuáles fueron mis ventas por producto en enero de 2026?».

Conectar el asistente no cierra tu sesión web de World Office: son canales independientes. Puedes desconectar el Conector desde tu cliente de IA en cualquier momento.

Las herramientas se dividen en dos familias que trabajan juntas:

• Herramientas de búsqueda

  Traducen el texto que escribes (nombre de empresa, cliente, producto o cuenta) al id interno que el informe necesita. El asistente las ejecuta primero, sin que tengas que pedirlo.

• Herramientas de informe

  Generan el informe con los ids ya resueltos y las fechas que indicaste. Devuelven los datos al asistente, que te los resume o tabula.

Si el asistente no encuentra una coincidencia clara (por ejemplo, escribiste mal el nombre de un cliente), no inventa el id: te avisa y pide que aclares antes de ejecutar el informe.

Cinco herramientas para resolver nombres a ids. Puedes usarlas directamente cuando solo quieras consultar un maestro.

• Buscar empresas / sucursales

  buscar_empresas

  Lista o filtra las empresas y sucursales a las que tienes acceso, por identificación o nombre. Es el punto de partida de casi todos los informes.

  busqueda opcional

  Texto a buscar en identificación o nombre. Vacío lista todas.

  «Lista mis empresas y sucursales.»

• Buscar terceros

  buscar_terceros

  Busca clientes, proveedores y vendedores por identificación o nombre.

  busqueda requerido

  Texto a buscar en identificación o nombre del tercero.

  limite opcional

  Máximo de resultados, de 1 a 50. Por defecto 20.

  «Busca el cliente con NIT 900123456.»

• Buscar inventarios / productos

  buscar_inventarios

  Busca productos por código o descripción.

  busqueda requerido

  Texto a buscar en código o descripción del producto.

  limite opcional

  Máximo de resultados, de 1 a 50. Por defecto 20.

  «¿Tengo un producto que se llame teclado inalámbrico?»

• Listar inventarios por grupo

  listar_inventarios_por_grupo

  Lista todos los productos de un grupo de inventario. Útil cuando quieres una clasificación completa y no un producto puntual. Devuelve id, código, descripción y código de barras.

  nombreGrupo requerido

  Nombre exacto del grupo, por ejemplo Productos No Fabricados Por La Empresa.

  «Muéstrame los productos del grupo Productos No Fabricados Por La Empresa.»

• Buscar cuentas contables

  buscar_cuentas_contables

  Busca cuentas contables activas del PUC por código o nombre. Necesaria para acotar libro auxiliar o estado de cuenta a una cuenta concreta.

  busqueda requerido

  Texto a buscar en código o nombre de la cuenta contable.

  limite opcional

  Máximo de resultados, de 1 a 50. Por defecto 20.

  «¿Qué cuentas contables hay para bancos?»

Los tres informes de ventas comparten el parámetro documentos: indica qué tipos de documento incluir. Si no lo dices, se usa Factura de Venta.

• Ventas por producto

  ventas_por_producto

  Ventas agrupadas por producto en un rango de fechas. Se puede acotar a un producto o, si se omite, incluye todos.

  empresaId requerido

  Empresa o sucursal. El asistente lo resuelve con buscar_empresas.

  fechaInicial requerido

  Inicio del rango.

  fechaFinal requerido

  Fin del rango.

  documentos opcional

  Tipos de documento a incluir. Por defecto Factura de Venta.

  productoId opcional

  Un producto puntual, resuelto con buscar_inventarios.

  «¿Cuáles fueron mis ventas por producto entre el 1 y el 31 de enero de 2026?»

• Ventas por vendedor

  ventas_por_vendedor

  Ventas agrupadas por vendedor en un rango de fechas. Se puede acotar a un vendedor o, si se omite, incluye todos.

  empresaId requerido

  Empresa o sucursal.

  fechaInicial requerido

  Inicio del rango.

  fechaFinal requerido

  Fin del rango.

  documentos opcional

  Tipos de documento a incluir.

  vendedorId opcional

  Un vendedor puntual, resuelto con buscar_terceros.

  «Compara las ventas por vendedor del primer trimestre de 2026.»

• Ventas por documento

  ventas_por_documento

  Ventas agrupadas por documento en un rango de fechas, indicando qué tipos incluir.

  empresaId requerido

  Empresa o sucursal.

  fechaInicial requerido

  Inicio del rango.

  fechaFinal requerido

  Fin del rango.

  documentos opcional

  Tipos de documento a incluir.

  «Dame las facturas y notas crédito de venta de febrero de 2026.»

Los tres informes de compras comparten el parámetro documentos: indica qué tipos de documento incluir. Si no lo dices, se usa Factura de Compra.

• Compras por documento

  compras_por_documento

  Compras agrupadas por documento en un rango de fechas, indicando qué tipos incluir.

  empresaId requerido

  Empresa o sucursal. El asistente lo resuelve con buscar_empresas.

  fechaInicial requerido

  Inicio del rango.

  fechaFinal requerido

  Fin del rango.

  documentos opcional

  Tipos de documento a incluir. Por defecto Factura de Compra.

  «Dame las facturas de compra de febrero de 2026.»

• Compras por producto

  compras_por_producto

  Compras agrupadas por producto, detalladas por documento. Se puede acotar a un producto o, si se omite, incluye todos.

  empresaId requerido

  Empresa o sucursal.

  fechaInicial requerido

  Inicio del rango.

  fechaFinal requerido

  Fin del rango.

  documentos opcional

  Tipos de documento a incluir.

  productoId opcional

  Un producto puntual, resuelto con buscar_inventarios.

  «¿Qué productos compré más en el primer semestre de 2026?»

• Compras por proveedor

  compras_por_proveedor

  Compras agrupadas por proveedor y comprador. Se puede acotar a un proveedor y/o a un comprador o, si se omiten, incluye todos.

  empresaId requerido

  Empresa o sucursal.

  fechaInicial requerido

  Inicio del rango.

  fechaFinal requerido

  Fin del rango.

  documentos opcional

  Tipos de documento a incluir.

  proveedorId opcional

  Un proveedor puntual, resuelto con buscar_terceros.

  compradorId opcional

  Un comprador puntual, resuelto con buscar_terceros.

  «¿Cuánto le compré al proveedor Acme en 2026?»

• Balance general

  balance_general

  Balance general de una empresa a una fecha de corte.

  empresaId requerido

  Empresa o sucursal.

  fechaCorte requerido

  Fecha hasta la que se acumulan los movimientos.

  «Muéstrame el balance general a corte del 30 de junio de 2026.»

• Estado de resultados

  estado_resultados

  Estado de resultados de una empresa en un rango de fechas.

  empresaId requerido

  Empresa o sucursal.

  fechaInicial requerido

  Inicio del periodo.

  fechaFinal requerido

  Fin del periodo.

  «Genera el estado de resultados del primer semestre de 2026.»

• Libro auxiliar

  libro_auxiliar

  Libro auxiliar de una empresa en un rango de fechas, opcionalmente acotado a un rango de cuentas contables.

  empresaId requerido

  Empresa o sucursal.

  fechaInicial requerido

  Inicio del periodo.

  fechaFinal requerido

  Fin del periodo.

  cuentaInicial opcional

  Código PUC inicial del rango. Por defecto 1 (todas).

  cuentaFinal opcional

  Código PUC final del rango. Por defecto 96 (todas).

  «Dame el libro auxiliar de la cuenta de bancos entre enero y marzo de 2026.»

• Estado de cuenta (cartera)

  estado_cuenta_saldo_movimiento

  Estado de cuenta con saldos y movimientos de un tercero en un periodo. Distingue la fecha de corte del saldo del periodo de movimientos.

  empresaId requerido

  Empresa o sucursal.

  terceroId requerido

  Cliente o proveedor, resuelto con buscar_terceros.

  fechaCorte requerido

  Fecha de corte del saldo.

  fechaInicio requerido

  Inicio del periodo de movimientos.

  fechaFinal requerido

  Fin del periodo de movimientos.

  cuentaContableId opcional

  Una cuenta contable puntual, resuelta con buscar_cuentas_contables.

  «¿Cómo está la cartera del cliente Distribuciones Andinas a hoy, con movimientos del último trimestre?»

• Existencias de inventario por bodega

  existencias_inventarios_bodegas

  Consolidado de existencias por bodega a una fecha de corte. Incluye saldos positivos y negativos. Se puede acotar a un producto o, si se omite, incluye todos.

  empresaId requerido

  Empresa o sucursal.

  fechaCorte requerido

  Fecha de corte de las existencias.

  productoId opcional

  Un producto puntual, resuelto con buscar_inventarios.

  «¿Cuántas unidades del teclado inalámbrico tengo por bodega al 30 de junio de 2026?»

• Informe de nómina de empleados

  informe_nomina_empleados

  Informe de nómina agrupado por empleado, de un documento de nómina concreto. Trabaja en dos pasos: primero localiza el documento por su número (y prefijo, si lo das) y luego trae el informe.

  empresaId requerido

  Empresa o sucursal.

  numeroDocumento requerido

  Número del documento de nómina, solo dígitos, sin prefijo.

  prefijo opcional

  Prefijo del documento. Ayuda a desambiguar.

  documentoId opcional

  Id interno del documento. Solo se usa en un segundo intento, cuando ya elegiste entre varios candidatos.

  «Dame el informe de nómina del documento 1024 de la empresa principal.»

Si hay más de un documento de nómina con ese número, la herramienta no elige por ti: devuelve los candidatos y el asistente te pregunta cuál quieres antes de generar el informe.

• Nombra la empresa o sucursal cuando manejas varias; si no, el asistente tendrá que preguntarte.
• Da fechas explícitas. «Enero de 2026» funciona, pero «del 1 al 31 de enero de 2026» evita ambigüedad. El formato interno es AAAA-MM-DD.
• Di qué documentos quieres en informes de ventas si necesitas algo distinto de Factura de Venta (cotizaciones, POS, notas crédito).
• Usa el nombre o la identificación de clientes, productos y cuentas; no hace falta que conozcas los ids internos.
• Verifica los nombres. Si el asistente dice que no encuentra un tercero o producto, revisa la escritura antes de insistir.
• Pide el formato de salida que necesitas: tabla, resumen ejecutivo, comparación entre periodos o gráfico.
• Encadena preguntas. Tras un informe puedes pedir «ahora solo el top 10» o «compáralo con el mes anterior» en la misma conversación.

• No puedo agregar el conector

  Tu usuario puede no tener el permiso habilitado. Pide a un administrador que lo active en Seguridad → Usuarios → Modificar en World Office Cloud.

• El asistente dice que la empresa o el tercero no existe

  Es el comportamiento esperado cuando no hay coincidencia clara: prefiere avisarte antes que generar un informe con datos equivocados. Revisa la escritura o pide primero «lista mis empresas».

• El informe sale vacío

  Normalmente el rango de fechas, la empresa o el tipo de documento no corresponden a movimientos existentes. Amplía el rango o cambia el tipo de documento.

• La sesión pide login otra vez

  Los tokens viven solo en memoria y tienen vigencia limitada; al expirar, o si el servicio se reinició, el cliente de IA vuelve a pedir autorización. Es normal.

• El asistente pide confirmar cuál documento de nómina

  Existen varios documentos con el mismo número. Indícale el prefijo o elige uno de los candidatos que te muestra.

• Quiero desconectarlo

  Elimina el conector desde la configuración de tu cliente de IA. Eso revoca el acceso; no afecta tu sesión web de World Office.

Si necesitas ayuda con la conexión o con un informe puntual, escríbenos. Para temas de privacidad y tratamiento de datos, consulta la política de privacidad.