Integração do SDK com IA via MCP da Singular – Centro de ajuda

Visão geral

Integrar um SDK móvel costuma levar horas de leitura de documentação, escrita de código repetitivo e depuração de casos extremos antes que o primeiro evento seja enviado. O Singular SDK Integration Skill reduz isso a uma única conversa com seu assistente de programação com IA.

Conecte o MCP da Singular, descreva seu app e o assistente faz o resto: detecta sua plataforma e framework, pergunta apenas o que não consegue descobrir sozinho, escreve o código e valida o resultado, tudo sem sair do seu editor. No final, você tem um SDK da Singular totalmente configurado: inicialização, conformidade com privacidade (ATT, COPPA, GDPR, CCPA, LGPD), deep links, rastreamento de receita e mapeamento de eventos.

Funciona com Claude, Cursor, ChatGPT (Developer Mode), Gemini CLI, VS Code Copilot e outros assistentes compatíveis com MCP.

Como o fluxo funciona

Depois que você conecta o MCP da Singular e abre a pasta do projeto no seu assistente de programação, o SDK Integration Skill é executado como uma conversa guiada. Veja o que esperar:

Conectar ao MCP: conecte o MCP da Singular ao seu assistente de programação com IA seguindo o guia de configuração do seu assistente em MCP da Singular. A URL do MCP é https://mcp.singular.net/mcp-server/mcp (OAuth com seu login da Singular).
Varredura: o assistente varre seu projeto para detectar a plataforma, o framework, os requisitos de privacidade, a configuração de deep links, a monetização e os eventos de analytics existentes.
Verificação de integração existente: se já houver código da Singular, você escolhe entre completar o que falta, começar do zero ou sair.
Perguntas direcionadas: o assistente pergunta apenas o que não conseguiu detectar, uma pergunta por vez: plataforma, framework, onde armazenar a chave e o segredo do SDK, requisitos de privacidade, ATT, deep links, receita e rastreamento de eventos.
Resumo e confirmação: antes de escrever qualquer código, o assistente mostra um resumo completo da integração planejada. Nenhum arquivo é alterado até você confirmar.
Implementação: o assistente busca a documentação mais recente da Singular para a configuração confirmada e escreve o código no seu projeto.
Memória do projeto: o assistente escreve uma seção da Singular no arquivo de configuração do seu agente (CLAUDE.md, AGENTS.md ou GEMINI.md) e adiciona um arquivo KNOWN_ISSUES.md para o seu framework.
Validação: o assistente executa um checklist de aprovação/reprovação que cobre instalação, inicialização, SKAdNetwork, eventos, deep links, receita e privacidade. Se algo falhar, ele propõe correções.
Checklist "Antes de testar": o assistente exibe o nome do pacote Android ou o bundle ID do iOS e verifica se o app está registrado na sua conta da Singular. Se não estiver, você será solicitado a criar o app na plataforma da Singular antes de executá-lo.

Quanto tempo leva? Uma execução típica leva cerca de 30 minutos. A maior parte desse tempo é gasta esperando suas respostas nas etapas de perguntas.

Assistentes de IA compatíveis

Qualquer assistente de programação com IA que suporte servidores MCP remotos pode executar o SDK Integration Skill. Isso inclui:

Claude / Claude Code (plano pago)
Cursor
ChatGPT (Developer Mode)
Gemini CLI
VS Code Copilot
Outros assistentes compatíveis com MCP, como o Codex. O guia de configuração MCP da Singular não os cobre, então siga as instruções do seu assistente para adicionar um servidor MCP remoto.

Plataformas compatíveis

Plataforma / Framework	Status
Android nativo (Kotlin / Java)	Compatível
iOS nativo (Swift / Objective-C)	Compatível
React Native (bare e Expo)	Compatível
Flutter	Compatível
Unity	Beta
Cordova / Ionic	Beta
Unreal Engine	Beta

O que o skill cobre

Instalação das dependências do SDK
Inicialização do SDK com SingularConfig no ponto correto do ciclo de vida do app
Armazenamento seguro da chave e do segredo do SDK (nunca fixados no código)
Solicitação de ATT e NSUserTrackingUsageDescription (iOS)
Configuração do consentimento de privacidade: COPPA, GDPR, CCPA, LGPD
Deep links: Universal Links, App Links, deep links diferidos, callbacks do Singular Link
Receita de IAP e receita de assinaturas baseada no SDK
Rastreamento de eventos mapeado para eventos padrão ou personalizados da Singular
ID de usuário (se o seu app tiver um fluxo de login)

Perguntas frequentes

Posso usar isso se já tenho uma integração parcial da Singular?

Sim. Quando o skill detecta código da Singular existente, ele pergunta se você quer completar o que falta, começar de novo ou não fazer nada. Ele foi projetado para funcionar com integrações parciais.

Posso usar a integração do SDK junto com uma configuração servidor a servidor (S2S)?

Sim. Um padrão comum é enviar a maioria dos eventos via S2S e usar o SDK Integration Skill para inicialização, conformidade com privacidade, deep links e eventos selecionados. Configurações mistas são totalmente suportadas.

Como o assistente sabe qual chave do SDK usar?

O skill pergunta onde armazenar a chave e o segredo do SDK durante a fase de perguntas. Ele nunca fixa credenciais nos seus arquivos de código-fonte. Padrões comuns incluem variáveis de ambiente, arquivos de configuração de build e segredos específicos da plataforma (por exemplo, segredos do EAS para Expo).

O código de integração é revisado antes de ser gravado nos meus arquivos?

Sim. A etapa 5 do fluxo mostra um resumo completo do que será implementado antes de qualquer arquivo ser modificado. Você precisa confirmar antes que o assistente escreva qualquer código.

Integrações com fornecedores terceirizados de assinaturas e monetização de anúncios são suportadas?

Não diretamente. O skill trata a receita de IAP baseada no SDK e os eventos de assinatura padrão. Ele não configura integrações com fornecedores terceirizados como RevenueCat, Adapty ou Superwall, nem fluxos de assinatura servidor a servidor (S2S), nem a atribuição de receita de monetização de anúncios.

Para esses casos, consulte a documentação da Singular correspondente:

Guia de Implementação de Rastreamento de Eventos de Assinatura: cobre as opções de SDK, S2S e de terceiros
Perguntas frequentes sobre atribuição de receita de anúncios e solução de problemas
Ad Monetization Analytics FAQ
Server-to-Server - Fundamentos

O que mais está fora do escopo deste skill?

Os recursos a seguir estão fora do escopo do SDK Integration Skill. Cada um leva à documentação da Singular correspondente:

Links curtos de indicação: Android, iOS, React Native, Flutter, Unity, Cordova, Unreal Engine. Para criar links curtos a partir do seu servidor, consulte Links curtos dinâmicos e rastreamento de indicações.
Propriedades globais: Android, iOS, React Native, Flutter, Unity, Cordova

O skill indica a documentação correspondente se você perguntar sobre esses temas durante uma sessão.

Minha plataforma aparece como Beta (Unity, Cordova/Ionic, Unreal Engine). O que isso significa?

Nas plataformas Beta, o assistente usa a documentação atual da Central de Ajuda da Singular em vez de um arquivo de referência dedicado e pré-validado. A integração deve funcionar na maioria dos casos, mas revise com atenção o código gerado, principalmente os diffs, antes de fazer o merge ou publicar em produção.

O que acontece depois que a integração é escrita?

O assistente executa um checklist de validação (instalação, inicialização, SKAdNetwork, eventos, deep links, receita, privacidade) e propõe correções para qualquer falha. Ele também escreve uma seção da Singular no arquivo de configuração do agente do seu projeto, para que as próximas sessões mantenham o contexto da sua integração.