Guía para agentes

Conectar con OAuth

URL del servidor: https://api.gonovaflow.com/mcp

1. En Claude: Customize → Connectors → Add custom connector. Pega la URL.
2. En ChatGPT: Settings → Apps → Advanced → developer mode, y crea un conector con esa URL.
3. En Gemini CLI: agrega el transporte HTTP con la misma URL.
4. El navegador abre https://app.gonovaflow.com/oauth/mcp/authorize. Entra con tu usuario de NovaFlow y elige una subcuenta.

El permiso que se otorga es novaflow:read. No hay permiso de escritura ni de envío en esta conexión.

Alcance

La subcuenta queda fija en la autorización. Cada consulta usa tu sesión, con las reglas de acceso de la base, y vuelve a comprobar que sigues siendo miembro. Si tu visibilidad es solo lo asignado, no verás el resto del equipo. No envíes subAccountId: la tool responde subaccount_locked. Un id de otra subcuenta responde not_found.

Catálogo de tools

• Alcance de la conexión

  get_workspace_scope

  Alcance de esta conexión: subcuenta, rol, visibilidad y modelo operativo (CRM estándar o piso/demos). Read-only. No acepta otra subcuenta.

• Tablero del periodo

  get_dashboard_snapshot

  Tablero del periodo según el modelo de la subcuenta: CRM (dashboard móvil) o piso (demostraciones/ventas). Signals ya calculados. Sin nombres, teléfonos ni mensajes.

• Desglose de leads del periodo

  get_period_lead_breakdown

  Desglose del periodo: leads/orígenes (CRM) o demos por día/origen (piso). Si no cuadra, va en unavailable.

• Desempeño por colaborador

  get_advisor_performance

  Desempeño por colaborador del periodo (CRM o piso). Requiere visibilidad de toda la subcuenta; con alcance asignado no hay comparación de equipo.

• Resumen del pipeline

  get_pipeline_summary

  Embudo/pipeline: etapas CRM, o en piso el significado de seguimientos no_sale (Nuevo $0) frente a ventas cerradas.

• Buscar contactos

  contacts_search

  Busca contactos de esta subcuenta por nombre, teléfono, correo, etiqueta o lista. Ej.: {"q":"Ana","tag":"N1"}. No acepta otra subcuenta.

• Ficha de contacto

  contacts_get

  Ficha de un contacto: nombre, teléfono, correo, etiquetas, campos, dueño y hasta 20 oportunidades. Ej.: {"contactId":"<uuid>"}.

• Pipelines y etapas

  pipelines_list

  Pipelines de esta subcuenta con sus etapas e IDs. Ej.: {}.

• Buscar oportunidades

  deals_search

  Oportunidades por etapa, dueño o fechas de creación (YYYY-MM-DD). Ej.: {"stageId":"<uuid>","from":"2026-10-01","to":"2026-10-31"}.

• Ficha de oportunidad

  deals_get

  Una oportunidad de esta subcuenta. Ej.: {"dealId":"<uuid>"}.

• Listar conversaciones

  conversations_list

  Conversaciones de esta subcuenta, con canal y si están sin leer. Ej.: {"channel":"whatsapp"}.

• Leer mensajes

  conversations_get

  Una conversación y una página de mensajes (máximo 50, texto recortado). Ej.: {"conversationId":"<uuid>"}.

• Listar calendarios

  calendars_list

  Calendarios de reserva de esta subcuenta (nombre, duración, activo). Ej.: {}.

• Listar citas

  appointments_list

  Citas por fechas o por contacto. Ej.: {"from":"2026-10-01","to":"2026-10-07","contactId":"<uuid>"}.

• Listar tareas

  tasks_list

  Tareas de contactos. Ej.: {"contactId":"<uuid>","status":"pending"}.

• Listar notas

  notes_list

  Notas ligadas a un contacto o una oportunidad. Ej.: {"contactId":"<uuid>"}.

• Listar listas

  lists_list

  Listas de contactos de esta subcuenta. Ej.: {}.

• Miembros de una lista

  lists_members

  Contactos de una lista de esta subcuenta, paginados. Ej.: {"listId":"<uuid>"}.

• Listar workflows

  workflows_list

  Workflows de automatización y si están activos. No devuelve el grafo. Ej.: {}.

• Saldo de consumibles

  usage_balance

  Saldo del mes (America/Mexico_City) de WhatsApp masivo, correo, llamadas, IA de voz y líneas. Ej.: {}.

Límites

• 30 llamadas a tools por minuto, por usuario y subcuenta.
• 60 peticiones por minuto por IP.
• 10 registros de cliente por hora por IP.
• Las listas devuelven como máximo 50 filas. Usa nextCursor para la siguiente página.

Uso seguro

• No inventes contactos, teléfonos ni cifras. Usa solo lo que devolvió la tool.
• Si un dato está en unavailable, di que el servidor no lo devolvió.
• No pidas enviar WhatsApp, correo o llamadas: esta conexión no puede gastar saldo.
• No pegues tokens de acceso en el chat.

You are connected to NovaFlow for exactly one sub-account. Use only numbers and records returned by tools. Do not invent contacts, phones, emails, or causes. If a field is listed in unavailable, or a tool returns not_found, say the server did not return it. Do not send messages, book, or edit records. This connection is read-only (novaflow:read). Do not pass subAccountId. The sub-account is fixed by the OAuth grant. Pages return at most 50 rows. Pass nextCursor to continue.