MCP da Singular

O MCP (Model Context Protocol) é um framework que permite enviar dados da Singular para seus clientes de LLM, como ChatGPT e Claude. Assim, você pode combinar todos os poderosos recursos nativos de análise e visualização do LLM com os dados provenientes da Singular.

• Conecte seu LLM ao MCP da Singular (veja as instruções abaixo)
• Agora seu LLM pode interagir com os seus dados da Singular. O processo é o seguinte:
  • Quando o LLM recebe um prompt relevante, ele redireciona o prompt para o MCP da Singular.
  • O MCP da Singular traduz o prompt em uma consulta à API da Singular e gera os resultados.
  • Os resultados retornados são enviados de volta ao LLM do usuário junto com contexto adicional que ajuda o LLM a entender os dados e analisá-los melhor.
  • O LLM pode analisar os dados com mais profundidade conforme os prompts solicitados pelo usuário.

• ChatGPT
• Claude e Claude Code (versão paga)
• Cursor
• Visual Studio Copilot
• E quaisquer outros que ofereçam suporte a servidores MCP (entre em contato com o nosso suporte para solicitar uma integração)

• O MCP da Singular pode retornar todos os dados disponíveis no relatório principal da Singular. Isso inclui tanto os dados agregados do tracker provenientes do SDK ou de S2S quanto os dados de custo obtidos das redes.
• Os dados de SKAN estarão disponíveis em breve

• Quais são as minhas campanhas com melhor desempenho?
• Mostre um gráfico de barras com as minhas campanhas de melhor desempenho dos últimos 30 dias
• Mostre uma tabela com app, origem, instalações e ROI D7 dos últimos 90 dias

1. Acesse a página do GPT da Singular aqui - você verá a seguinte tela:
   
2. Comece perguntando qualquer coisa: o ChatGPT solicitará automaticamente que você faça login com o MCP da Singular:
   
3. Faça login na sua conta da Singular:
   
4. Depois disso, você deve voltar ao ChatGPT com a confirmação da conexão. Agora clique em “Confirm”:
   
5. Para permitir sempre as consultas ao MCP da Singular, acesse “Privacy settings” e altere o domínio do MCP para “Always allow”:
   
6. Agora você pode perguntar o que quiser sobre os seus dados de marketing:
   

O ChatGPT oferece outra opção em beta para conectar MCPs no modo de desenvolvedor, dentro da interface principal em vez de um app de GPT separado.

Para a maioria dos usuários, recomendamos a configuração padrão descrita acima. Usuários avançados podem seguir as etapas abaixo.

1. Primeiro, você precisará habilitar o modo de desenvolvedor do ChatGPT. Clique no botão "+", em "Use connectors", "Add sources" e "Connect more":
   
2. Na tela Connectors, role até "Advanced settings" e habilite "Developer mode":
   
3. De volta à tela Connectors, agora você pode clicar no botão "Create" e configurar o MCP da Singular com a seguinte URL:
   https://mcp.singular.net/mcp-server/mcp
   
4. Depois de salvar, o ChatGPT direcionará você para a página de login da Singular:
   
5. Ao voltar ao ChatGPT, você verá uma notificação informando "Singular is now connected". Em seguida, confirme que ainda está no modo de desenvolvedor, clique novamente no botão "+", selecione "Developer Mode" e "Add sources" e ative o conector da Singular conforme mostrado abaixo:
6. Hora de testar. Pergunte o que quiser sobre os seus dados de marketing e clique em "Confirm" quando o ChatGPT quiser usar as ferramentas da Singular:
   

1. Na interface do Claude, clique em Customize [ícone de caixa de ferramentas] no painel de navegação à esquerda.
   
2. Clique em Connectors
   
3. Em Connectors [painel de navegação central], clique no ícone de sinal de mais [+] no canto superior direito do painel.
   
4. Clique em Add custom connector .
   Isso abrirá a janela pop-up do conector.
5. Na janela pop-up do conector:
   • Preencha um nome, por exemplo Singular (este será o nome exibido na interface do Claude posteriormente)
   • A Integration URL é: https://mcp.singular.net/mcp-server/mcp
   
6. A integração da Singular deve aparecer agora na lista.

   Observação: Se a integração não aparecer com um botão "Connect" ao lado, aguarde 30 segundos ou tente atualizar o Claude.

7. Clique no botão Connect:
   
   Observação : Se o Claude retornou um erro "Invalid authorization" depois que você clicou em Connect, isso pode significar que você não está conectado ao Claude no seu navegador. Tente fazer login em https://claude.ai/ e depois clique em Connect novamente.
8. Faça login na sua conta da Singular
   
9. Você está conectado: a conexão da Singular deve aparecer na sua lista de integrações ativas
   
10. Se você clicar na integração da Singular, verá a quais APIs a integração está conectada. get_report é a API da Singular
    
11. Digite um prompt na interface de chat do Claude.
12. Permita que o Claude use a integração externa
    
13. Ao usar o Claude Code, ele será configurado automaticamente com os MCPs adicionados na interface. Execute o comando a seguir no seu terminal para validar:

    claude mcp list

    Depois, basta executar claude no seu terminal e perguntar o que quiser sobre os seus dados:

1. Confirme que você está usando a versão mais recente do Cursor, que inclui suporte a MCP remoto. Baixe ou atualize em: https://cursor.com/home
2. Acesse a página da Singular no diretório de MCPs do Cursor e basta clicar em "Add to cursor":
   https://cursor.directory/mcp/singular
   Como alternativa, você pode adicioná-lo manualmente nas configurações do Cursor: acesse "Tools & Integrations", clique em "New MCP Server" e edite o arquivo mcp.json aberto com o seguinte:
   

   {
     "mcpServers": {
       "singular-mcp": {
         "url": "https://mcp.singular.net/mcp-server/mcp",
         "transport": "http",
         "auth": {
           "type": "oauth",
           "loginUrl": "https://app2.singular.net/login"
         }
       }
     }
   }

3. Depois que o MCP da Singular for adicionado, você deve voltar à seção Tools & Integrations e vê-lo como uma nova ferramenta. Em seguida, clique no link "Needs login" para iniciar o fluxo de autenticação:
   
4. Faça login na sua conta da Singular:
   
5. Depois disso, você deve voltar ao IDE do Claude e ver a ferramenta da Singular habilitada:
6. Por último, abra o painel de IA do Cursor (a interface de chat dele), confirme que o modo "Agent" está selecionado e pergunte o que quiser sobre os seus dados de marketing:

1. Confirme que você tem a versão mais recente do Gemini-CLI instalada seguindo as instruções aqui: https://github.com/google-gemini/gemini-cli
2. Para adicionar o MCP da Singular, inclua o seguinte no seu arquivo ~/.gemini/settings.json:
   

   {
     "mcpServers": {
       "singular-mcp": {
         "httpUrl": "https://mcp.singular.net/mcp-server/mcp",
         "oauth": {
           "enabled": true,
           "authorizationUrl": "https://mcp.singular.net/oauth_server/authorize",
           "tokenUrl": "https://mcp.singular.net/oauth_server/token",
           "clientId": "Gemini",
           "clientSecret": null,
           "scopes": [
             "mcp:read"
           ]
         }
       }
     }
   }

3. Depois que o MCP da Singular for adicionado, inicie o gemini-cli executando "gemini" no seu terminal e execute o seguinte: /mcp auth singular-mcp
   Faça login na Singular e volte ao Gemini CLI para confirmar que você está autenticado:
4. Depois disso, basta perguntar o que quiser sobre os seus dados de marketing e permitir que o Gemini chame as ferramentas da Singular:

1. Confirme que você está usando o VS Code versão 1.101 ou superior. Baixe ou atualize em:
   https://code.visualstudio.com/updates/
2. Você precisa de uma assinatura ativa do GitHub Copilot. O administrador da sua organização no GitHub precisa habilitar o recurso "MCP servers" no seu workspace (você o encontra nas configurações do Copilot do GitHub, em "Policies"):
   
3. Abra as configurações do IDE do Visual Studio Code, acesse as configurações de Chat em Features e confirme que o MCP está habilitado:
   
4. Na paleta de comandos do VS Code (Shift+Command+P), escolha "MCP: Add Server", selecione a opção "HTTP" e informe a seguinte URL do MCP:
   https://mcp.singular.net/mcp-server/mcp
   
   Depois disso, o VS Code iniciará o processo de autenticação.
5. Faça login na sua conta da Singular:
   
6. Depois disso, você deve voltar ao IDE do VS Code e ver o MCP da Singular instalado no menu Extensions:
7. Por último, abra a interface de chat do Copilot no VS Code, confirme que o modo "Agent" está ativado e pergunte o que quiser sobre os seus dados de marketing:

• Cada LLM tem os seus pontos fortes. Recomendamos testar várias opções e ver qual funciona melhor para as suas perguntas.

• Sim, os clientes de LLM têm limites para a quantidade de dados que os MCPs podem retornar na resposta.
• O ChatGPT, por exemplo, é limitado a 50 mil caracteres por consulta para evitar problemas, enquanto o Claude suporta até 100 mil caracteres.

• Sim. Por padrão, o MCP da Singular retorna as métricas e dimensões mais comuns relevantes para a sua conta. Porém, em alguns casos, pode faltar um campo específico que não está na lista padrão.
• Para esses casos, o MCP da Singular oferece ferramentas úteis para você ver e atualizar os campos relevantes:
  • get_supported_fields - retorna todos os campos disponíveis atualmente no MCP
  • update_supported_fields - adiciona ou remove campos adicionais do MCP
• Por exemplo, se você não encontrar um campo chamado "ABC" nos dados retornados, tente o seguinte:
  • "Mostre todos os meus campos compatíveis": veja a lista completa e verifique se ABC está disponível com outro nome
  • "Adicione 'ABC' aos meus campos compatíveis": se o nome existir na Singular, ele será adicionado como campo relevante
  • "Mostre o meu ABC dos últimos 30 dias": agora você deve receber os resultados correspondentes

• Se você usa um workspace do ChatGPT, é possível que a sua conta tenha os GPTs de terceiros desabilitados. Para que o GPT da Singular funcione, peça ao seu administrador para acessar as configurações de GPT do workspace abaixo e confirmar que está habilitado:
  https://chatgpt.com/admin/gpts

  

Não. Por padrão, nenhum dado enviado ao nosso MCP é usado para otimização ou treinamento de modelos pela Singular . A Singular garante que os seus dados contextuais permaneçam isolados no seu ambiente e sejam usados apenas para atender às suas próprias consultas.

Não. Atualmente o MCP só pode acessar os dados agregados, conforme aparecem na página do relatório principal da Singular.

Sim. O MCP tem o mesmo acesso aos dados que o usuário utilizado para conectar a integração do MCP da Singular ao LLM.

Sim. Todos os dados de contexto são criptografados em trânsito e em repouso usando protocolos de criptografia padrão do setor.