Conectar un asistente de IA a tu subcuenta

Qué hace esta conexión

Esta conexión deja que Claude, ChatGPT o Gemini CLI lean las cifras de una subcuenta. Son las mismas del tablero, para el periodo que pidas. No hay una clave en Ajustes: cada persona entra con su usuario de NovaFlow y elige la subcuenta en la pantalla Autorizar lectura.

La conexión es de solo lectura. No envía mensajes, no cambia contactos ni oportunidades, y no puede saltar a otra subcuenta dentro del chat.

Antes de empezar

• Usa el usuario de NovaFlow que ya puede ver esa subcuenta. El asistente verá lo mismo que ese usuario: toda la subcuenta, o solo lo asignado.
• Cada persona autoriza con su propio usuario. No compartas la contraseña ni pegues una clave de API.
• Ten a mano la dirección del conector: https://api.gonovaflow.com/mcp.
• Si el asistente pide un identificador o un secreto de cliente, déjalos vacíos.

Pantalla de autorización

Al conectar, el asistente abre NovaFlow.

• Entra con tu usuario.
• Elige una subcuenta. Esa elección queda fija.
• Pulsa Autorizar lectura. El permiso dice que solo puede leer métricas. No puede enviar mensajes ni cambiar datos.
• Si la ventana dice que el código volverá a este equipo, continúa solo si tú abriste esa ventana. Eso pasa con Gemini CLI.

Para cambiar de subcuenta, quita el conector en el asistente y vuelve a crearlo. Elegir otra en el chat no cambia la conexión.

Claude

Sirve en los planes Free, Pro, Max, Team y Enterprise. En Free solo puedes tener un conector personalizado. En Team y Enterprise, un Owner lo agrega primero para la organización. La guía de Anthropic está en conectores personalizados con MCP remoto.

Plan Pro o Max

• Abre Customize y luego Connectors.
• Pulsa + Add y elige Add custom connector.
• Nombre: Analista de subcuenta.
• Dirección: https://api.gonovaflow.com/mcp. Continúa.
• En autenticación elige Sign in now.
• En cliente OAuth elige Register automatically. No uses un cliente propio y no pegues un secreto.
• Pulsa Add e inicia sesión en NovaFlow.

Plan Team o Enterprise

• Un Owner abre Organization settings, luego Connectors, pulsa Add, pasa el cursor por Custom y elige Web.
• Usa el mismo nombre, la misma dirección, Sign in now y Register automatically.
• Cada miembro entra en Customize, luego Connectors, y pulsa Connect en ese conector. Cada quien autoriza su propio usuario.

En un chat, abre el botón +, entra a Connectors y activa el conector. Puedes permitir sus herramientas: no modifican el CRM.

ChatGPT

OpenAI documenta los conectores personalizados en el modo desarrollador, en la web. El plan Pro puede usar consultas de lectura. En Business, Enterprise y Edu un administrador activa el modo, crea la app y la publica. El plan gratuito no incluye este conector. La guía está en modo desarrollador y apps MCP.

• Entra a Settings, luego Apps, luego Advanced settings, y activa Developer mode. En Enterprise o Edu el administrador concede ese permiso antes.
• Crea la app en Apps y luego Create. Un administrador también puede hacerlo en Workspace settings, Apps, Create.
• Dirección: https://api.gonovaflow.com/mcp.
• Autenticación: OAuth. No pegues una clave.
• Pulsa Scan tools. Cuando pida entrar, inicia sesión en NovaFlow, elige la subcuenta y pulsa Autorizar lectura. Espera a que termine el escaneo y pulsa Create.
• En Business, Enterprise y Edu la app puede quedar en borrador. Un administrador la publica en Workspace settings, Apps, Drafts.

En un chat nuevo, elige la app en el menú de herramientas o menciónala cuando necesites cifras nuevas. Luego usa los textos listos de la sección Después de conectar: cómo pedirle el análisis. Estas consultas son de lectura. Si más adelante una consulta deja de responder, un administrador puede actualizar la lista de herramientas de la app sin crear otra.

Gemini

El camino que sí está soportado es Gemini CLI, no la app de Gemini en el navegador. Google no publica una dirección de retorno fija para esa app, y NovaFlow no acepta una dirección cualquiera. Si la app de Gemini rechaza la conexión, usa la terminal. La guía de Google está en servidores MCP en Gemini CLI.

• Instala Gemini CLI e inicia sesión con tu cuenta de Google.
• En la terminal escribe gemini mcp add --transport http Analista https://api.gonovaflow.com/mcp.
• No agregues una cabecera Authorization ni un token. El inicio de sesión es el de NovaFlow.
• Abre Gemini CLI. Si no abre el navegador, escribe /mcp auth Analista.
• En NovaFlow elige la subcuenta y pulsa Autorizar lectura.

Después de conectar: cómo pedirle el análisis

El conector no exige un orden fijo de herramientas. Puedes pedir el tablero, los asesores o el embudo en cualquier momento. Lo que sí importa es: activar el conector en ese chat, decir el periodo y pedirle que use solo lo que el conector devolvió.

En ChatGPT

• Abre un chat nuevo en la web.
• En el menú de herramientas o apps, activa el conector Analista de subcuenta (o el nombre que le pusiste).
• Pega uno de los textos de abajo y envíalo.
• Si ChatGPT pide permiso para usar una herramienta, acéptalo. Son de solo lectura.

Texto para pegar la primera vez

Copia y pega esto tal cual:

Activa el conector de NovaFlow. Confirma qué subcuenta quedó conectada y si ves toda la subcuenta o solo lo asignado. Luego, con los últimos 30 días, dame: 1) resumen del tablero con las acciones que el conector ya calculó, 2) desempeño por colaborador con leads, cerrados, conversión e importe, 3) embudo u oportunidades por etapa si está disponible. Usa solo cifras del conector. Si un dato viene como no disponible, dilo y no lo inventes. No pidas ni inventes contactos, teléfonos, correos ni mensajes.

Con ese mensaje el asistente suele consultar el alcance, el tablero, los asesores y el embudo. No tienes que escribir los nombres técnicos de las herramientas.

Otras peticiones listas para pegar

• Solo tablero: Con el conector activo, resume los últimos 7 días con las mismas cifras del tablero y lista solo las acciones que el conector ya calculó. No inventes nada.
• Desempeño del equipo: Con el conector activo, en los últimos 30 días dame el desempeño individual de todos los colaboradores: leads, cerrados, conversión e importe. Si no hay filas, dilo.
• Orígenes de leads: Con el conector activo, en este mes compara el origen de los leads. Si el desglose no está disponible, no lo completes.
• Embudo / etapas: Con el conector activo, resume el embudo y las oportunidades abiertas por etapa. Si una etapa no viene, no la inventes.
• Periodo a medida: Con el conector activo, analiza del 2026-09-01 al 2026-09-30. Usa solo lo que el conector devuelva.

Cambia las fechas o el periodo (7 días, 30 días, 90 días, mes en curso) según lo que necesites. El rango personalizado admite hasta 366 días.

Regla anti-invención (repítela si se sale del tema)

Usa solo cifras que el conector haya devuelto. Si un dato figura como no disponible, dilo y no lo estimes. No inventes contactos, teléfonos, correos, mensajes ni causas. La subcuenta es la de esta conexión.

En Claude o Gemini CLI

El mismo texto funciona. En Claude, activa el conector en el chat con el botón + y Connectors. En Gemini CLI, asegúrate de haber autenticado el servidor antes de pegar la petición.

Si una cifra no aparece, no está en el tablero para ese usuario y ese periodo. Pedirle que la “calcule de otra forma” hace que invente.

Subcuentas con operación distinta (piso / demos)

Algunas subcuentas no viven en la bandeja: registran demostraciones y ventas en piso. En esas cuentas el conector lee ese modelo, no el contactado de WhatsApp.

• Pide demos, ventas, conversión e importe, no “leads contactados”.
• Si ves oportunidades abiertas en Nuevo con valor 0, son seguimientos de demos sin venta, no el embudo de ingresos.
• Para el desempeño de todo el equipo, autoriza con un usuario admin que vea toda la subcuenta. Un agente con alcance solo asignado no puede comparar al equipo.
• Primero pide el alcance de la conexión: debe decir el modelo operativo y si `assignedScope` es falso.

Qué puede consultar

• Alcance. Qué subcuenta está conectada, tu rol y si las cifras son de toda la subcuenta o solo de lo asignado.
• Tablero. Leads, contacto y señales del periodo, con las mismas cifras del dashboard. Las acciones recomendadas ya vienen calculadas.
• Leads del periodo. Cuántos entraron, orígenes y volumen. Si una suma no cuadra con los leads del periodo, ese desglose viene como no disponible y no debe citarse.
• Asesores. Actividad por asesor en el periodo. Si tu usuario no ve toda la subcuenta, esta consulta no trae filas del equipo. Si el nombre guardado es un correo, verás Asesor 1, Asesor 2, y así.
• Embudo. Oportunidades abiertas ahora, por etapa, y el embudo del periodo. Las oportunidades abiertas no se filtran por las fechas que pediste.

Qué no puede hacer

• No lista nombres de contactos, teléfonos, correos ni el texto de los mensajes.
• No envía WhatsApp, correo ni mensajes internos.
• No crea, edita ni borra contactos, oportunidades ni citas.
• No junta varias subcuentas ni cambia de subcuenta.
• No acepta una consulta SQL ni un identificador de otra subcuenta.

Si algo falla

• La sesión de lectura expiró. Quita el conector en el asistente y vuelve a autorizarlo una vez. Las conexiones nuevas renuevan la sesión solas. No hace falta una clave.
• No se pudo autorizar la conexión. Cierra esa página. No la recargues. Quita el conector en el asistente y empieza de nuevo desde ahí. Entra con el usuario que pertenece a la subcuenta y pulsa Autorizar lectura una sola vez.
• El asistente pide entrar otra vez. Usa el mismo usuario. La subcuenta sigue siendo la que elegiste.
• Las cifras no coinciden con lo que esperabas. Revisa el periodo y si tu usuario ve toda la subcuenta o solo lo asignado. El asistente no puede ver más que tú.
• Inventó un número o un nombre. Pide que vuelva a consultar el conector y que cite solo lo devuelto. Si el dato está como no disponible, la respuesta correcta es decirlo.
• ChatGPT no muestra crear una app. Tu plan no lo incluye, o un administrador todavía no activó el modo desarrollador.
• Claude no deja agregar el conector. En Team y Enterprise lo agrega un Owner. En Free ya tienes el único conector personalizado permitido.
• Gemini en el navegador no conecta. Usa Gemini CLI, con el comando de esta guía.

Preguntas frecuentes

¿La conexión deja de leer después de un rato? Vuelve a autorizar una vez. A partir de esa autorización, la sesión se renueva sola mientras el conector siga activo.

¿Dónde está la clave? No hay clave. La autorización es tu usuario de NovaFlow y la subcuenta que eliges.

¿Puedo conectar dos subcuentas en el mismo chat? No. Cada conexión es una subcuenta. Crea otra conexión si necesitas la segunda, y no mezcles sus cifras en la misma respuesta.

¿El asistente puede escribirle a un lead? No. Esta conexión no tiene permiso de escritura.

¿Por qué no me dice el teléfono de un contacto? Porque no sale del servidor. Ábrelo en el CRM si necesitas el dato.