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. 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.

Cómo pedir un análisis sin cifras inventadas

Di el periodo. Puedes pedir 7 días, 30 días, 90 días, el mes en curso, o un rango de fechas de hasta 366 días.

Pega esta instrucción la primera vez, y repítela si la respuesta se sale de los datos:

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.

Ejemplos que respetan ese límite:

• Resume los últimos 30 días y lista solo las acciones que el conector ya calculó.
• Compara el origen de los leads de este mes. Si un desglose no está disponible, no lo completes.
• ¿Qué asesores tienen actividad en los últimos 7 días? No agregues nombres que no vengan en la respuesta.

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

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

• 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

¿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.