Integración del SDK con IA mediante el MCP de Singular – Centro de ayuda

Descripción general

Integrar un SDK móvil suele implicar horas de leer documentación, escribir código repetitivo y depurar casos límite antes de que se envíe el primer evento. El Singular SDK Integration Skill lo reduce a una sola conversación con tu asistente de programación con IA.

Conecta el MCP de Singular, describe tu app y el asistente se encarga del resto: detecta tu plataforma y framework, pregunta solo lo que no puede deducir por sí mismo, escribe el código y valida el resultado, todo sin salir de tu editor. Al final tendrás un SDK de Singular completamente configurado: inicialización, cumplimiento de privacidad (ATT, COPPA, GDPR, CCPA, LGPD), deep links, seguimiento de ingresos y mapeo de eventos.

Funciona con Claude, Cursor, ChatGPT (Developer Mode), Gemini CLI, VS Code Copilot y otros asistentes compatibles con MCP.

Cómo funciona el flujo

Una vez que conectas el MCP de Singular y abres la carpeta de tu proyecto en tu asistente de programación, el SDK Integration Skill se ejecuta como una conversación guiada. Esto es lo que puedes esperar:

Conectarse al MCP: conecta el MCP de Singular a tu asistente de programación con IA siguiendo la guía de configuración de tu asistente en MCP de Singular. La URL del MCP es https://mcp.singular.net/mcp-server/mcp (OAuth con tu inicio de sesión de Singular).
Escaneo: el asistente escanea tu proyecto para detectar tu plataforma, framework, requisitos de privacidad, configuración de deep links, monetización y los eventos de analítica existentes.
Verificación de una integración existente: si ya hay código de Singular, eliges entre completar lo que falta, empezar de cero o salir.
Preguntas específicas: el asistente pregunta solo lo que no pudo detectar, una pregunta a la vez: plataforma, framework, dónde guardar tu clave y secreto del SDK, requisitos de privacidad, ATT, deep links, ingresos y seguimiento de eventos.
Resumen y confirmación: antes de escribir código, el asistente te muestra un resumen completo de la integración planificada. No se modifica ningún archivo hasta que confirmes.
Implementación: el asistente obtiene la documentación más reciente de Singular para la configuración que confirmaste y escribe el código en tu proyecto.
Memoria del proyecto: el asistente escribe una sección de Singular en el archivo de configuración de tu agente (CLAUDE.md, AGENTS.md o GEMINI.md) y agrega un archivo KNOWN_ISSUES.md para tu framework.
Validación: el asistente ejecuta una lista de verificación de aprobado/reprobado que cubre instalación, inicialización, SKAdNetwork, eventos, deep links, ingresos y privacidad. Si algo falla, propone correcciones.
Lista de verificación "Antes de probar": el asistente muestra el nombre de paquete de Android o el bundle ID de iOS y verifica que la app esté registrada en tu cuenta de Singular. Si no lo está, se te pedirá que crees la app en la plataforma de Singular antes de ejecutarla.

¿Cuánto tiempo toma? Una ejecución típica toma unos 30 minutos. La mayor parte de ese tiempo se dedica a esperar tus respuestas en los pasos de preguntas.

Asistentes de IA compatibles

Cualquier asistente de programación con IA que admita servidores MCP remotos puede ejecutar el SDK Integration Skill. Esto incluye:

Claude / Claude Code (plan de pago)
Cursor
ChatGPT (Developer Mode)
Gemini CLI
VS Code Copilot
Otros asistentes compatibles con MCP, como Codex. La guía de configuración MCP de Singular no los cubre, así que sigue las instrucciones de tu asistente para agregar un servidor MCP remoto.

Plataformas compatibles

Plataforma / Framework	Estado
Android nativo (Kotlin / Java)	Compatible
iOS nativo (Swift / Objective-C)	Compatible
React Native (bare y Expo)	Compatible
Flutter	Compatible
Unity	Beta
Cordova / Ionic	Beta
Unreal Engine	Beta

Qué cubre el skill

Instalación de las dependencias del SDK
Inicialización del SDK con SingularConfig en el punto correcto del ciclo de vida de la app
Almacenamiento seguro de la clave y el secreto del SDK (nunca codificados en el código)
Solicitud de ATT y NSUserTrackingUsageDescription (iOS)
Conexión del consentimiento de privacidad: COPPA, GDPR, CCPA, LGPD
Deep links: Universal Links, App Links, deep links diferidos, callbacks de Singular Link
Ingresos por IAP e ingresos por suscripciones basados en el SDK
Seguimiento de eventos asignado a eventos estándar o personalizados de Singular
ID de usuario (si tu app tiene un flujo de inicio de sesión)

Preguntas frecuentes

¿Puedo usarlo si ya tengo una integración parcial de Singular?

Sí. Cuando el skill detecta código de Singular existente, te pregunta si quieres completar lo que falta, empezar de nuevo o no hacer nada. Está diseñado para funcionar con integraciones parciales.

¿Puedo usar la integración del SDK junto con una configuración de servidor a servidor (S2S)?

Sí. Un patrón común es enviar la mayoría de los eventos por S2S y usar el SDK Integration Skill para la inicialización, el cumplimiento de privacidad, los deep links y algunos eventos seleccionados. Las configuraciones mixtas son totalmente compatibles.

¿Cómo sabe el asistente qué clave del SDK usar?

El skill te pregunta dónde guardar tu clave y secreto del SDK durante la fase de preguntas. Nunca codifica credenciales en tus archivos fuente. Los patrones comunes incluyen variables de entorno, archivos de configuración de compilación y secretos específicos de la plataforma (por ejemplo, secretos de EAS para Expo).

¿Se revisa el código de integración antes de escribirlo en mis archivos?

Sí. El paso 5 del flujo te muestra un resumen completo de lo que se implementará antes de modificar cualquier archivo. Debes confirmar antes de que el asistente escriba código.

¿Se admiten integraciones con proveedores externos de suscripciones y monetización de anuncios?

No directamente. El skill gestiona los ingresos por IAP basados en el SDK y los eventos de suscripción estándar. No configura integraciones con proveedores externos como RevenueCat, Adapty o Superwall, ni flujos de suscripción de servidor a servidor (S2S), ni la atribución de ingresos por monetización de anuncios.

Para estos casos, consulta la documentación de Singular correspondiente:

Guía de implementación del seguimiento de eventos de suscripción: cubre las opciones de SDK, S2S y de terceros
Atribución de ingresos publicitarios Preguntas frecuentes y solución de problemas
Ad Monetization Analytics FAQ
Server-to-Server - Fundamentos

¿Qué más queda fuera del alcance de este skill?

Las siguientes funciones quedan fuera del alcance del SDK Integration Skill. Cada una enlaza a la documentación de Singular correspondiente:

Enlaces cortos de referido: Android, iOS, React Native, Flutter, Unity, Cordova, Unreal Engine. Para crear enlaces cortos desde tu servidor, consulta Enlaces cortos dinámicos y seguimiento de referencias.
Propiedades globales: Android, iOS, React Native, Flutter, Unity, Cordova

El skill te indica la documentación correspondiente si preguntas por estos temas durante una sesión.

Mi plataforma aparece como Beta (Unity, Cordova/Ionic, Unreal Engine). ¿Qué significa?

En las plataformas Beta, el asistente se basa en la documentación actual del Centro de ayuda de Singular en lugar de un archivo de referencia dedicado y validado previamente. La integración debería funcionar en la mayoría de los casos, pero revisa con cuidado el código generado, en especial los diffs, antes de fusionarlo o publicarlo en producción.

¿Qué pasa después de que se escribe la integración?

El asistente ejecuta una lista de verificación (instalación, inicialización, SKAdNetwork, eventos, deep links, ingresos, privacidad) y propone correcciones para cualquier falla. También escribe una sección de Singular en el archivo de configuración del agente de tu proyecto para que las sesiones futuras conserven el contexto de tu integración.