Integraciones con IA mediante MCP

Las Integraciones con IA te permiten usar un asistente compatible para consultar y gestionar tu cuenta de Grupos Inteligentes.

La conexión usa MCP (Model Context Protocol). Funciona como un puente seguro entre el asistente y las funciones que autorizas.

Función en versión Beta

La compatibilidad con OpenCode está verificada. Codex es experimental. Claude Code puede configurarse manualmente, pero Grupos Inteligentes todavía no ha verificado su compatibilidad.

Qué Puedes Hacer

Después de conectarlo, puedes pedir al asistente que:

• Consulte tu plan, límites y configuración.
• Busque redireccionadores y consulte su configuración.
• Enumere los grupos de un redireccionador.
• Consulte el resumen del panel y los informes de rendimiento.
• Analice datos agregados de leads permitidos por tu plan.
• Cree redireccionadores con una configuración segura.
• Añada grupos a un redireccionador.
• Elimine un grupo después de tu confirmación explícita.

Consejo: Haz solicitudes directas, como: “Muestra el rendimiento de este redireccionador durante los últimos 30 días” o “Enumera los grupos llenos de este redireccionador”.

Cómo Conectar un Asistente

Para usar Integraciones con IA, necesitas una suscripción activa o estar en el período de prueba. Sin eso, el elemento Integraciones con IA aparece desactivado en el menú.

Paso 1: Abrir Integraciones con IA

1. Inicia sesión en el panel de Grupos Inteligentes.
2. Selecciona Integraciones con IA en el menú.
3. Haz clic en Conectar un asistente de IA y elige OpenCode o Codex.
4. Sigue Elegir, Configurar y Autorizar. También puedes abrir Ver configuración en la tarjeta del asistente.

Esta pantalla muestra la configuración más reciente para el cliente elegido.

Claude Code todavía no aparece en esta pantalla. Sigue la configuración manual de abajo.

Paso 2: Añadir Grupos Inteligentes

OpenCode

Añade a OpenCode la configuración que aparece en el panel. Tendrá este formato:

{
  "mcp": {
    "grupos-inteligentes": {
      "type": "remote",
      "url": "https://api.gruposinteligentes.com/mcp"
    }
  }
}

Después, ejecuta el comando de autenticación que aparece en el panel:

opencode mcp auth grupos-inteligentes

Codex

Ejecuta los dos comandos que aparecen en el panel:

codex mcp add grupos-inteligentes --url https://api.gruposinteligentes.com/mcp
codex mcp login grupos-inteligentes

Precaución

Codex aparece como Experimental. La conexión puede cambiar mientras mejora la compatibilidad.

Claude Code

Añade el servidor MCP remoto desde tu terminal:

claude mcp add --transport http grupos-inteligentes https://api.gruposinteligentes.com/mcp

Después:

1. Abre Claude Code con el comando claude.
2. Escribe /mcp.
3. Elige grupos-inteligentes.
4. Inicia la autenticación y completa la autorización en tu navegador.

De forma predeterminada, esta configuración solo está disponible en el proyecto actual. Añade --scope user al comando para usarla en todos tus proyectos.

Compatibilidad aún no verificada

Claude Code admite servidores MCP remotos con autenticación en el navegador. Sin embargo, Grupos Inteligentes todavía no ha completado las pruebas de compatibilidad con este cliente.

Paso 3: Autorizar en el Navegador

1. El cliente de IA abrirá una página en tu navegador.
2. Inicia sesión en tu cuenta de Grupos Inteligentes si es necesario.
3. Revisa el nombre del cliente y todos los permisos solicitados.
4. Selecciona Autorizar cliente si estás de acuerdo.

Vuelve a Integraciones con IA y selecciona Actualizar lista. El nuevo cliente aparecerá en Asistentes conectados.

Protege tu cuenta

Inicia sesión solo en el dominio de Grupos Inteligentes. Nunca pegues tu contraseña ni un token de acceso en el cliente de IA.

Permisos de la Conexión

Antes de autorizar, verás lo que el cliente podrá consultar y cambiar:

Permiso	Qué permite
Ver cuenta y plan	Consultar funciones, límites y configuración.
Ver redireccionadores y grupos	Consultar redireccionadores y sus grupos.
Ver rendimiento	Consultar clics, tendencias, capacidad e informes agregados.
Ver análisis de leads	Consultar los análisis agregados disponibles en tu plan.
Gestionar redireccionadores	Crear redireccionadores dentro de los límites de tu plan.
Gestionar grupos	Añadir grupos y eliminarlos solo después de tu confirmación.

El cliente de IA no puede:

• Eliminar redireccionadores ni tu cuenta.
• Gestionar la facturación ni las formas de pago.
• Consultar contraseñas, tokens u otros secretos.
• Acceder a registros individuales de leads.
• Mostrar los enlaces de invitación de tus grupos.

Los conjuntos pequeños de datos agregados de leads también se ocultan. Esta protección reduce el riesgo de identificar a una persona.

Consultar la operación sin hacer cambios

Los permisos whatsapp:read y automations:read permiten consultar WhatsApp y las automatizaciones. La autorización puede mostrar esos nombres.

• Consulta el estado registrado de la conexión y el resultado de una operación específica.
• En Scale, incluida la prueba, consulta los grupos de WhatsApp, los vínculos pendientes, la cola, el historial y la configuración de creación automática.
• Revisa cuándo se actualizaron los datos. Un conteo no disponible no significa cero participantes.

Por ejemplo: “¿Qué grupos todavía necesitan atención?” o “¿Por qué está esperando la creación de este redireccionador?”.

Estas consultas no hacen una nueva comprobación en WhatsApp ni crean, editan, importan, cancelan o repiten operaciones. La configuración guardada no confirma la ejecución. Estar en cola, crear el grupo y habilitarlo en el enlace son pasos diferentes. Si el resultado es desconocido, revisa antes de repetir la creación.

Las conexiones anteriores mantienen el acceso aprobado. Para incluir las consultas nuevas, usa Revocar acceso y conecta el asistente otra vez. Actualizar la lista no concede permisos nuevos.

Cómo Usarlo Después de la Conexión

Abre el cliente conectado y escribe tu solicitud con un lenguaje sencillo. Por ejemplo:

• “Muestra el resumen de mi cuenta de los últimos 30 días.”
• “¿Qué redireccionadores están activos?”
• “Enumera los grupos llenos del redireccionador 123.”
• “Crea un redireccionador llamado Lanzamiento de Agosto con la dirección lanzamiento-agosto.”
• “Añade este grupo al redireccionador 123: [enlace de invitación].”

Para eliminar un grupo, indica el redireccionador y el grupo exactos. El asistente debe pedir tu confirmación antes de completar la eliminación.

Consejo: Comprueba los nombres y números antes de aprobar un cambio. El asistente sigue los mismos límites y reglas de tu cuenta.

Cómo Revocar el Acceso

Puedes desconectar un cliente en cualquier momento:

1. Abre Integraciones con IA en el panel.
2. Busca el cliente en Asistentes conectados. Usa Ver permisos para revisar el acceso.
3. Selecciona Revocar acceso.
4. Revisa la información y confirma.

El acceso de ese cliente se detendrá de inmediato. Los demás clientes y tus sesiones normales seguirán funcionando.

Solución de Problemas

El navegador no se abrió

Ejecuta de nuevo el comando de autenticación de tu cliente.

En Claude Code, escribe /mcp e inicia de nuevo la autenticación. Si el navegador completa la autorización, pero no vuelve a Claude Code, copia la URL completa que aparece en el navegador y pégala en Claude Code.

El cliente no aparece como conectado

Confirma que seleccionaste Autorizar cliente. Después, vuelve al panel y selecciona Actualizar lista.

La solicitud caducó o no está disponible

Inicia de nuevo la autenticación desde el cliente de IA. La solicitud es temporal y solo puede usarse una vez.

El elemento Integraciones con IA está desactivado

Comprueba que tu suscripción esté activa en Configuraciones > Plan actual. Durante la prueba, el acceso también está disponible.

Los análisis de leads no están disponibles

Los análisis de leads dependen de las funciones incluidas en tu plan. Las demás funciones autorizadas siguen disponibles.

¿Todavía necesitas ayuda?

Envía un correo a suporte@gruposinteligentes.com.

Próximos Pasos

• Comprende los informes de rendimiento
• Aprende a gestionar tus grupos
• Consulta cómo crear un redireccionador