Loading
Integrar y analizar datos de marketing con Marketing Cloud...
Consultar sus datos de Marketing Cloud Intelligence con el servidor MCP

Consultar sus datos de Marketing Cloud Intelligence con el servidor MCP

Utilice el servidor de protocolo de contexto de modelo (MCP) de Marketing Cloud Intelligence (MCI) para consultar datos de marketing, supervisar oportunidades en curso de datos y diagnosticar problemas desde un cliente de IA compatible.

El servidor MCP de MCI le permite utilizar la IA de conversación para explorar datos de marketing, supervisar el estado de las oportunidades en curso y diagnosticar problemas. Formule preguntas en lenguaje sencillo en vez de crear paneles, crear informes o navegar por múltiples páginas.

Con el servidor MCI MCP, puede:

  • Consulte datos de campañas, como las campañas principales por retorno del gasto publicitario (ROAS).
  • Identifique transmisiones de datos con fallos y comprenda por qué fallaron.
  • Traduzca errores técnicos y códigos de error en explicaciones y soluciones recomendadas.
  • Compare el rendimiento mes tras mes o semana tras semana.
  • Vuelva a ejecutar múltiples transmisiones de datos a la vez.
  • Busque mediciones y dimensiones disponibles sin memorizar nombres de campo.

Cómo funciona el servidor MCP de Marketing Cloud Intelligence

El servidor MCP conecta su cuenta MCI con un cliente de IA compatible, como Código Claude o Cursor. Cuando formula una pregunta, el cliente envía la solicitud al servidor. El servidor solo accede a los datos permitidos por sus permisos configurados y devuelve los resultados en un formato legible.

Herramientas de MCP disponibles

Herramientas de MCP de MCI
Categoría Herramienta Descripción
Identidad y Espacios de trabajo mci_whoami Obtenga la identidad y los permisos de usuario actuales.
Identidad y Espacios de trabajo mci_list_workspaces Enumere todos los espacios de trabajo de MCI accesibles.
Identidad y Espacios de trabajo mci_get_workspace Obtenga información detallada del espacio de trabajo.
Conectores y autenticación mci_list_connectors Enumere todos los tipos de conector disponibles.
Conectores y autenticación mci_get_connector_config Obtenga el esquema de configuración del conector.
Conectores y autenticación mci_list_authentications Enumere todas las credenciales de autenticación.
Conectores y autenticación mci_get_authentication Obtenga detalles de autenticación específicos.
Transmisiones de datos mci_list_datastreams Enumere todas las transmisiones de datos.
Transmisiones de datos mci_create_datastream Cree una transmisión de datos.
Transmisiones de datos mci_update_datastream Actualice una configuración de transmisión de datos.
Transmisiones de datos mci_process_datastream Procesar una transmisión de datos.
Transmisiones de datos mci_process_datastreams_bulk Procese múltiples transmisiones de datos de forma masiva.
Transmisiones de datos mci_get_datastream_status Obtenga el estado de procesamiento de una transmisión de datos.
Transmisiones de datos mci_get_process_log Obtenga registros de procesamiento para una transmisión de datos.
Transmisiones de datos mci_upload_data Cargue datos en una transmisión de TotalConnect.
Perfiles y plantillas mci_get_profiles Enumere todos los perfiles de datos.
Perfiles y plantillas mci_get_sub_profiles Obtenga subperfiles para un perfil.
Perfiles y plantillas mci_get_templates Enumere todas las plantillas disponibles.
Consulta y descubrimiento mci_query Consulte datos de marketing agregados.
Consulta y descubrimiento mci_query_batch Ejecute múltiples consultas en un lote.
Consulta y descubrimiento mci_list_measurements Enumere mediciones y mediciones disponibles.
Consulta y descubrimiento mci_list_dimensions Enumere las dimensiones disponibles.
Consulta y descubrimiento mci_get_dimension_values Obtenga valores exclusivos para una dimensión.
Paneles mci_list_dashboards Enumere todos los paneles en un espacio de trabajo.
Paneles mci_get_dashboard_widgets Obtenga todos los widgets en un panel.
Paneles mci_share_dashboard Comparta un panel con usuarios.
Informes mci_list_reports Enumere todos los informes disponibles.
Informes mci_run_report Inicie la generación de informes.
Informes mci_download_report Descargue un archivo de informe generado.
Mediciones y dimensiones personalizadas mci_create_calculated_metric Cree una medición calculada con una fórmula.
Gestión y gobernanza de datos mci_validate_taxonomy Valide la nomenclatura con respecto a los estándares.
Objetivos, usuarios y marca mci_list_goals Enumere objetivos y metas de KPI.
Objetivos, usuarios y marca mci_list_users Enumere los usuarios del espacio de trabajo y sus funciones.

Parámetros para mci_query

Parámetros de mci_query
ParámetroTipoObligatorioDescripción
workspaceId Cadena Sí Id. de espacio de trabajo de destino.
dateRange Enum Sí Intervalo de fechas o CUSTOM predefinido.
startDate Cadena Condicional Obligatorio cuando dateRange es CUSTOM. Utilice el formato de YYYY-MM-DD.
endDate Cadena Condicional Obligatorio cuando dateRange es CUSTOM. Utilice el formato de YYYY-MM-DD.
mediciones Matriz Sí Mediciones para recuperar.
dimensiones Matriz No Campos de agrupación.
filtros Matriz No Condiciones de filtro.
sortBy Cadena No Campo y dirección de clasificación.
límite Entero No Número máximo de filas devueltas.

Intervalos de fechas admitidos

Valores de intervalo de fechas
ValorDescripción
CUSTOM Gama personalizada. Requiere startDate y endDate.
YESTERDAY Día anterior.
LAST_7_DAYS Rodando 7 días.
LAST_30_DAYS Rodando 30 días.
LAST_90_DAYS Rodando 90 días.
THIS_MONTH Mes de calendario actual.
LAST_MONTH Mes de calendario anterior.
THIS_QUARTER Trimestre actual.
LAST_QUARTER Trimestre anterior.
THIS_YEAR Año de calendario actual.
LAST_YEAR Año de calendario anterior.
MONTH_TO_DATE Inicio del mes hasta hoy.
YEAR_TO_DATE Inicio del año hasta hoy.

Seguridad

El servidor MCI MCP utiliza sus credenciales y permisos de MCI configurados para acceder a datos. Su cuenta solo tiene acceso a sus datos y espacios de trabajo autorizados. El servidor MCP de MCI envía todas las solicitudes a través de HTTPS.

Ejemplo de conversación con el servidor MCP

Muéstreme las campañas principales de la semana pasada por ROAS.

El cliente de IA devuelve las campañas principales por ROAS para el periodo solicitado.

CampañaGastoIngresosROAS
Summer_Sale_2026 $12,400 $89,200 7,19x
Brand_Awareness_Q3 $8,750 $52,100 5,95x

Compárelos con el mes pasado.

El cliente de IA compara los resultados con el mes anterior y resume los cambios.

Configurar el servidor MCP de Marketing Cloud Intelligence

Configure el servidor MCP de MCI para consultar datos de marketing desde Código Claude, Cursor u otro cliente de IA compatible con MCP.

Antes de empezar, asegúrese de que tiene:

  • Una cuenta de Marketing Cloud Intelligence con acceso de API.
  • Un cliente de IA compatible con MCP.
  1. Descargue sus credenciales de API.

    1. Inicie sesión en Marketing Cloud Intelligence.
    2. En la barra de navegación, abra la lista desplegable y luego seleccione su nombre para acceder a su configuración de perfil.
    3. Junto a Token de acceso a API, seleccione Generar/Actualizar.
    4. Guarde el archivo de credenciales JSON descargado en una ubicación segura, como ~/.mci/credentials.json.
  2. Configure su cliente de IA.

    1. Agregue el servidor MCP de MCI a la configuración del servidor MCP de su cliente de IA.

      Para Código Claude, el archivo de configuración se encuentra normalmente aquí:

      • MacOS y Linux ~/.config/claude/mcp_servers.json
      • Windows %APPDATA%\claude\mcp_servers.json
    2. Identifique la URL de host para su instancia de MCI.
      Instancia de MCIURL de host
      EU https://app-eu.datorama.com/api/mcp
      UE2 https://app-eu2.datorama.com/api/mcp
      US https://app.datorama.com/api/mcp
      US2 https://app-us2.datorama.com/api/mcp
    3. Agregue esta configuración. Este ejemplo utiliza la URL de host de EE.UU.
      {
        "mci": {
          "command": "npx",
          "args": ["-y", "@datorama/mci-mcp-sdk"],
          "env": {
            "PRIVATE_KEY_PATH": "/absolute/path/to/credentials.json",
            "HOST": "https://app.datorama.com/api/mcp"
          }
        }
      }
    4. Por PRIVATE_KEY_PATH, sustituya /absolute/path/to/credentials.json por la ruta absoluta a su archivo de credenciales JSON. Por HOST, sustituya la URL de ejemplo por la URL de host para su instancia de MCI.
    5. Reinicie su cliente de IA para aplicar la configuración.
  3. Pruebe su configuración. En su cliente de IA, pregunte:

    Muéstrame mi cuenta y los espacios de trabajo a los que tengo acceso.

    Si la respuesta incluye su cuenta y espacios de trabajo accesibles, la configuración se completa. De lo contrario, verifique la ruta del archivo de credenciales, el extremo regional y los permisos de cuenta, y luego inténtelo de nuevo.

 
Cargando
Salesforce Help | Article