Usted está aquí:
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
| 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ámetro | Tipo | Obligatorio | Descripció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
| Valor | Descripció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ña | Gasto | Ingresos | ROAS |
|---|---|---|---|
| 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.
-
Descargue sus credenciales de API.
- Inicie sesión en Marketing Cloud Intelligence.
- En la barra de navegación, abra la lista desplegable y luego seleccione su nombre para acceder a su configuración de perfil.
- Junto a Token de acceso a API, seleccione Generar/Actualizar.
- Guarde el archivo de credenciales JSON descargado en una ubicación segura, como ~/.mci/credentials.json.
-
Configure su cliente de IA.
- 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
- Identifique la URL de host para su instancia de MCI.
Instancia de MCI URL de host EU https://app-eu.datorama.com/api/mcpUE2 https://app-eu2.datorama.com/api/mcpUS https://app.datorama.com/api/mcpUS2 https://app-us2.datorama.com/api/mcp - 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" } } } - Por
PRIVATE_KEY_PATH, sustituya /absolute/path/to/credentials.json por la ruta absoluta a su archivo de credenciales JSON. PorHOST, sustituya la URL de ejemplo por la URL de host para su instancia de MCI. - Reinicie su cliente de IA para aplicar la configuración.
- Agregue el servidor MCP de MCI a la configuración del servidor MCP de su cliente de IA.
-
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.
