MCP de Singular

El MCP (Model Context Protocol) es un framework que te permite enviar datos de Singular a tus clientes de LLM, como ChatGPT y Claude. Esto te permite combinar todas las potentes capacidades de análisis y visualización propias del LLM con los datos provenientes de Singular.

• Conecta tu LLM al MCP de Singular (consulta las instrucciones a continuación)
• Ahora tu LLM puede interactuar con tus datos de Singular. El proceso es el siguiente:
  • Cuando el LLM recibe un prompt relevante, lo redirige al MCP de Singular.
  • El MCP de Singular traduce el prompt a una consulta de la API de Singular y genera los resultados.
  • Los resultados obtenidos se envían de vuelta al LLM del usuario junto con contexto adicional que ayuda al LLM a entender los datos y analizarlos mejor.
  • El LLM puede analizar los datos con mayor profundidad según los prompts que solicite el usuario.

• ChatGPT
• Claude y Claude Code (versión de pago)
• Cursor
• Visual Studio Copilot
• Y cualquier otro que admita servidores MCP (contacta a nuestro equipo de soporte para solicitar una integración)

• El MCP de Singular puede devolver todos los datos disponibles en el reporte principal de Singular. Esto incluye tanto los datos agregados del tracker provenientes del SDK o de S2S como los datos de costo obtenidos de las redes.
• Los datos de SKAN estarán disponibles próximamente

• ¿Cuáles son mis campañas con mejor rendimiento?
• Muéstrame un gráfico de barras con mis campañas de mejor rendimiento de los últimos 30 días
• Muéstrame una tabla con app, fuente, instalaciones y ROI D7 de los últimos 90 días

1. Ve a la página de GPT de Singular aquí - deberías ver la siguiente pantalla:
   
2. Empieza preguntando cualquier cosa; ChatGPT te pedirá automáticamente iniciar sesión con el MCP de Singular:
   
3. Inicia sesión en tu cuenta de Singular:
   
4. Una vez hecho esto, deberías volver a ChatGPT con la confirmación de la conexión. Ahora haz clic en “Confirm”:
   
5. Para permitir siempre las consultas al MCP de Singular, ve a “Privacy settings” y cambia el dominio del MCP a “Always allow”:
   
6. Ahora puedes preguntar lo que quieras sobre tus datos de marketing:
   

ChatGPT ofrece otra opción en beta para conectar MCP en el modo de desarrollador, dentro de su interfaz principal en lugar de una app de GPT separada.

Para la mayoría de los usuarios, recomendamos la configuración estándar descrita arriba. Los usuarios avanzados pueden seguir los pasos que se indican a continuación.

1. Primero deberás habilitar el modo de desarrollador de ChatGPT. Haz clic en el botón "+", luego en "Use connectors", "Add sources" y "Connect more":
   
2. En la pantalla de Connectors, desplázate hasta "Advanced settings" y habilita "Developer mode":
   
3. De vuelta en la pantalla de Connectors, ya puedes hacer clic en el botón "Create" y configurar el MCP de Singular con la siguiente URL:
   https://mcp.singular.net/mcp-server/mcp
   
4. Una vez guardado, ChatGPT te redirigirá a la página de inicio de sesión de Singular:
   
5. Al volver a ChatGPT, deberías ver una notificación que indica "Singular is now connected". A continuación, asegúrate de seguir en el modo de desarrollador, vuelve a hacer clic en el botón "+", selecciona "Developer Mode" y "Add sources", y activa el conector de Singular como se muestra a continuación:
6. Es momento de probarlo. Pregunta lo que quieras sobre tus datos de marketing y haz clic en "Confirm" cuando ChatGPT quiera usar las herramientas de Singular:
   

1. En la interfaz de Claude, haz clic en Customize [icono de caja de herramientas] en el panel de navegación izquierdo.
   
2. Haz clic en Connectors
   
3. En Connectors [panel de navegación central], haz clic en el icono de signo más [+] en la parte superior derecha del panel.
   
4. Haz clic en Add custom connector .
   Esto te llevará a la ventana emergente del conector.
5. En la ventana emergente del conector:
   • Completa un nombre, por ejemplo Singular (este será el nombre que aparezca después en la interfaz de Claude)
   • La Integration URL es: https://mcp.singular.net/mcp-server/mcp
   
6. La integración de Singular ahora debería aparecer en la lista.

   Nota: Si la integración no aparece con un botón "Connect" al lado, espera 30 segundos o intenta actualizar Claude.

7. Haz clic en el botón Connect:
   
   Nota : Si Claude te devolvió un error "Invalid authorization" después de hacer clic en Connect, puede significar que no has iniciado sesión en Claude en tu navegador. Intenta iniciar sesión en https://claude.ai/ y luego haz clic en Connect de nuevo.
8. Inicia sesión en tu cuenta de Singular
   
9. Ya estás conectado: deberías ver la conexión de Singular en tu lista de integraciones activas
   
10. Si haces clic en la integración de Singular, verás a qué API está conectada la integración. get_report es la API de Singular
    
11. Escribe un prompt en la interfaz de chat de Claude.
12. Permite que Claude use la integración externa
    
13. Cuando uses Claude Code, se configurará automáticamente con los MCP agregados en su interfaz. Ejecuta lo siguiente en tu terminal para validarlo:

    claude mcp list

    Y luego simplemente ejecuta claude en tu terminal y pregunta lo que quieras sobre tus datos:

1. Asegúrate de usar la última versión de Cursor, que incluye compatibilidad con MCP remoto. Descárgala o actualízala en: https://cursor.com/home
2. Ve a la página de Singular en el directorio de MCP de Cursor y simplemente haz clic en "Add to cursor":
   https://cursor.directory/mcp/singular
   También puedes agregarlo manualmente en la configuración de Cursor: ve a "Tools & Integrations", haz clic en "New MCP Server" y edita el archivo mcp.json que se abre con lo siguiente:
   

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

3. Una vez agregado el MCP de Singular, deberías volver a la sección Tools & Integrations y verlo como una nueva herramienta. A continuación, haz clic en el enlace "Needs login" para iniciar el flujo de autenticación:
   
4. Inicia sesión en tu cuenta de Singular:
   
5. Una vez hecho esto, deberías volver al IDE de Claude y ver la herramienta de Singular habilitada:
6. Por último, abre el panel de IA de Cursor (su interfaz de chat), asegúrate de tener seleccionado el modo "Agent" y pregunta lo que quieras sobre tus datos de marketing:

1. Asegúrate de tener instalada la última versión de Gemini-CLI siguiendo las instrucciones aquí: https://github.com/google-gemini/gemini-cli
2. Para agregar el MCP de Singular, añade lo siguiente en tu archivo ~/.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. Una vez agregado el MCP de Singular, inicia gemini-cli ejecutando "gemini" en tu terminal y ejecuta lo siguiente: /mcp auth singular-mcp
   Inicia sesión en Singular y vuelve a Gemini CLI para verificar que estés autenticado:
4. Una vez hecho esto, simplemente pregunta lo que quieras sobre tus datos de marketing y permite que Gemini llame a las herramientas de Singular:

1. Asegúrate de usar la versión 1.101 de VS Code o una posterior. Descárgala o actualízala en:
   https://code.visualstudio.com/updates/
2. Debes tener una suscripción activa a GitHub Copilot. El administrador de tu organización de GitHub debe habilitar la función "MCP servers" en tu espacio de trabajo (la encontrarás en la configuración de Copilot de GitHub, en "Policies"):
   
3. Abre la configuración del IDE de Visual Studio Code, ve a la configuración de Chat en Features y asegúrate de que MCP esté habilitado:
   
4. En la paleta de comandos de VS Code (Shift+Command+P), elige "MCP: Add Server", selecciona la opción "HTTP" e introduce la siguiente URL del MCP:
   https://mcp.singular.net/mcp-server/mcp
   
   Una vez hecho esto, VS Code iniciará el proceso de autenticación.
5. Inicia sesión en tu cuenta de Singular:
   
6. Una vez hecho esto, deberías volver al IDE de VS Code y ver el MCP de Singular instalado en tu menú de Extensions:
7. Por último, abre la interfaz de chat de Copilot en VS Code, asegúrate de tener activado el modo "Agent" y pregunta lo que quieras sobre tus datos de marketing:

• Cada LLM tiene sus propias fortalezas. Te recomendamos probar varias opciones y ver cuál funciona mejor para tus preguntas.

• Sí, los clientes de LLM tienen límites sobre la cantidad de datos que los MCP pueden devolver en su respuesta.
• ChatGPT, por ejemplo, está limitado a 50.000 caracteres por consulta para evitar problemas, mientras que Claude admite hasta 100.000 caracteres.

• Sí. De forma predeterminada, el MCP de Singular devuelve las métricas y dimensiones más comunes que son relevantes para tu cuenta. Sin embargo, en algunos casos puede faltar un campo específico que no está en la lista predeterminada.
• Para estos casos, el MCP de Singular ofrece herramientas útiles que te permiten ver y actualizar los campos relevantes:
  • get_supported_fields - devuelve todos los campos disponibles actualmente en el MCP
  • update_supported_fields - agrega o quita campos adicionales del MCP
• Por ejemplo, si no encuentras un campo llamado "ABC" en los datos devueltos, prueba lo siguiente:
  • "Muéstrame todos mis campos compatibles": revisa la lista completa y comprueba si ABC está disponible con otro nombre
  • "Agrega 'ABC' a mis campos compatibles": si el nombre existe en Singular, se agregará como campo relevante
  • "Muéstrame mi ABC de los últimos 30 días": ahora deberías recibir los resultados correspondientes

• Si usas un espacio de trabajo de ChatGPT, es posible que tu cuenta tenga los GPT de terceros deshabilitados. Para que el GPT de Singular funcione, pide a tu administrador que abra la configuración de GPT del espacio de trabajo que aparece a continuación y verifique que esté habilitado:
  https://chatgpt.com/admin/gpts

  

No. De forma predeterminada, ningún dato enviado a nuestro MCP se usa para la optimización o el entrenamiento de modelos por parte de Singular . Singular garantiza que tus datos contextuales permanezcan aislados en tu entorno y se usen únicamente para responder a tus propias consultas.

No. Actualmente el MCP solo puede acceder a los datos agregados, tal como aparecen en la página del reporte principal de Singular.

Sí. El MCP tiene el mismo acceso a los datos que el usuario que se utilizó para conectar la integración del MCP de Singular con el LLM.

Sí. Todos los datos de contexto se encriptan tanto en tránsito como en reposo mediante protocolos de encriptación estándar del sector.