Servidor MCP Marketo Engage
El Protocolo de contexto de modelo (MCP) es un estándar abierto que conecta las herramientas de IA con servicios externos. El servidor MCP Marketo conecta su asistente de IA a Marketo. Admite operaciones en la administración de recursos, datos de posibles clientes y automatización de campañas. Consulte Operaciones MCP compatibles para ver las excepciones y los requisitos de disponibilidad.
Cuando la herramienta de IA llama al servidor MCP, el servidor utiliza las credenciales de esa solicitud para ejecutar la llamada de API de REST correspondiente. No es necesario instalar, implementar ni ejecutar software del lado del servidor.
Para obtener más información sobre cómo se gestionan los datos con la IA de Marketo y el servidor MCP de Marketo Engage, consulte la página Información de datos.
La conexión de clientes o servidores MCP a los productos de Adobe es una configuración elegida por el cliente, y los clientes son responsables de evaluar la seguridad y la idoneidad de cualquier integración MCP. Adobe no se responsabiliza de los problemas que se deriven de una configuración incorrecta, un uso incorrecto del MCP, vulnerabilidades en implementaciones de terceros o acciones no deseadas realizadas a través de flujos de trabajo habilitados para MCP.
Para reducir el riesgo, Adobe recomienda probar las integraciones en un entorno de zona protegida antes de usarlas de forma productiva y revisar y validar cuidadosamente todas las acciones y respuestas iniciadas por MCP antes de confirmarlas o depender de ellas.
Conceptos básicos de MCP
Piense en MCP como un puerto USB-C para aplicaciones de IA. USB-C proporciona una forma estandarizada de conectar sus dispositivos a varios periféricos y accesorios, y MCP proporciona una forma estandarizada de conectar modelos de IA a fuentes de datos y herramientas. — Protocolo de contexto de modelo
MCP permite que una herramienta de IA se conecte simultáneamente a varios servicios externos. Por ejemplo, un asistente de IA puede:
- Conectarse a un procesador de textos para generar documentos con asistencia de IA
- Conéctese a herramientas de animación, como Blender, para crear visualizaciones
- Conectar con Adobe After Effects para la edición de vídeo
Cualquier aplicación puede implementar MCP para exponer los datos y las acciones a las herramientas de IA.
Qué hace y no hace Marketo Engage MCP
Comprender el ámbito de MCP ayuda a establecer expectativas antes de conectar la herramienta de IA.
MCP no:
- Proporcionar acceso a los datos y las capacidades de Marketo mediante las API de REST estándar
- Ejecutar llamadas de API en su nombre mediante las credenciales que proporciona con cada solicitud
- Admitir varios usuarios simultáneos, cada uno conectado con sus propias credenciales
- Controlar la actualización del token de OAuth automáticamente. No es necesario administrar la caducidad del token
- Opere dentro de entornos aislados del inquilino para que los datos nunca se intersecten con la sesión de otro usuario
MCP no:
- Utilice, aloje o ejecute cualquier modelo de IA o aprendizaje automático. Todo el procesamiento de IA se realiza en la herramienta IA, no en el MCP
- Capacite o aprenda de cualquier dato, incluidos los datos de sus clientes
- Generar predicciones, recomendaciones o decisiones. La toma de decisiones es responsabilidad de la herramienta de IA descendente o del usuario
- Almacenar o conservar credenciales, datos de solicitud o estados de sesión entre solicitudes
- Requerir que instale, implemente o administre cualquier software del lado del servidor
MCP puede transmitir datos, incluidos campos potencialmente confidenciales, según el uso de API, pero los datos B2B implican datos empresariales del cliente y no implican datos PII.
Requisitos previos
- Una instancia de Marketo con acceso a la API de REST habilitado
- Acceso de administrador para crear credenciales de API en Marketo LaunchPoint
- Acceso de red a la URL del servidor MCP:
https://marketo-mcp.adobe.io/mcp
Obtener credenciales de Marketo
Necesita los siguientes valores de su instancia de Marketo:
- ID de cliente
- Secreto de cliente
- ID de cuenta de Munchkin
Si ya los tiene, vaya a Configurar la herramienta de IA.
ID de cliente y secreto de cliente
- Vaya a Administración > LaunchPoint.
- Seleccione su servicio API. Si no tiene uno, seleccione Nuevo > Nuevo servicio, elija Personalizado como tipo de servicio y asigne un usuario de API dedicado.
- Seleccione Ver detalles y copie los valores ID de cliente y Secreto de cliente.
ID de cuenta de Munchkin
- Vaya a Administración > Munchkin.
- Copie la cuenta de Munchkin. El formato es
XXX-XXX-XXXy coincide con el prefijo de la dirección URL de la instancia.
Configuración de la herramienta IA
Las configuraciones difieren ligeramente según la herramienta. Esta sección proporciona ejemplos de conexión para herramientas comunes.
marketo-prod y marketo-staging, cada uno con las credenciales correspondientes.Claude Desktop claude-desktop
Para conectarte a Claude Desktop, descarga marketo-mcp-bridge.zip y desempaquete el paquete. Coloque marketo-mcp-bridge.mjs en una ubicación conocida y use su ruta de acceso absoluta en la configuración siguiente.
También necesita una versión LTS compatible de Node.js instalada en el equipo. El puente no requiere paquetes npm adicionales.
- Abra Claude Desktop.
- Abra
claude_desktop_config.json. En macOS, el archivo se encuentra en~/Library/Application Support/Claude/. En Windows, se encuentra en%APPDATA%\Claude\. En las versiones con el menú de configuración de desarrollador, seleccione Configuración > Desarrollador > Editar configuración para abrirlo. - Agregue la siguiente entrada en
mcpServers, conservando la configuración existente. Reemplace la ruta y los marcadores de posición de credenciales por sus valores:
| code language-json |
|---|
|
- Reinicie Claude Desktop.
Si Claude Desktop no encuentra Node.js, reemplace node en command por la ruta absoluta de su ejecutable Node.js. Para obtener más información, consulte Conectarse a servidores MCP locales.
Cursor cursor
Agregue la entrada marketo bajo mcpServers en ~/.cursor/mcp.json para su cuenta de usuario o .cursor/mcp.json en el directorio del proyecto. Conservar los servidores existentes y reemplazar los marcadores de posición de credenciales con sus valores:
| code language-json |
|---|
|
Abra Personalizar en el cursor y confirme que el servidor está activado. Para obtener más información, consulte Configuración del MCP de cursor.
Código Claude (CLI) claude-code
Ejecute el siguiente comando en el terminal, sustituyendo las credenciales:
| code language-bash |
|---|
|
El comando agrega el servidor para el proyecto actual y su cuenta de usuario. Para que esté disponible entre proyectos, agregue --scope user. En el código Claude, ejecute /mcp para comprobar la conexión. Para obtener más información, vea Configuración MCP del código Claude.
Códice OpenAI codex
Agregue lo siguiente a ~/.codex/config.toml, conservando cualquier configuración existente:
| code language-toml |
|---|
|
Establezca MARKETO_CLIENT_ID, MARKETO_CLIENT_SECRET y MARKETO_MUNCHKIN_ID en el entorno del proceso que ejecuta Codex. Los valores de env_http_headers son nombres de variables de entorno, no credenciales.
Inicie una nueva sesión del Codex y ejecute /mcp para comprobar la conexión. Para obtener más información, vea Configuración de MCP del códice.
CLI de Gemini
Para agregar el servidor MCP Marketo Engage a la CLI de Gemini, agregue la siguiente entrada mcpServers a .gemini/settings.json en el directorio del proyecto o ~/.gemini/settings.json para su cuenta de usuario. Conservar la configuración existente y reemplazar los marcadores de posición de credenciales con sus valores.
| code language-json |
|---|
|
También puede establecer MARKETO_CLIENT_ID, MARKETO_CLIENT_SECRET y MARKETO_MUNCHKIN_ID en su entorno de shell y ejecutar el siguiente comando. El shell expande las variables antes de que la CLI almacene los valores del encabezado en la configuración del usuario:
| code language-bash |
|---|
|
Reinicie la sesión y ejecute /mcp para comprobar la conexión. Para obtener más información, consulte Configuración del MCP de CLI de Gemini.
Código VS con el copiloto de GitHub vscode
Utilice la configuración del copiloto portátil para las últimas versiones del código VS. Agregue la siguiente entrada bajo mcpServers en ~/.copilot/mcp-config.json o $COPILOT_HOME/mcp-config.json si establece COPILOT_HOME. Conservar los servidores existentes:
| code language-json |
|---|
|
Establezca las tres variables de entorno en el entorno que ejecuta el código VS o en el host remoto que se conecta al servidor. Inicie una nueva sesión de Copilot y revise las solicitudes de confianza del servidor.
Para usar la configuración guiada en su lugar, ejecute MCP: Agregar servidor, seleccione HTTP (Eventos HTTP o enviados por el servidor), introduzca la URL del servidor y elija Global > Copilot Global. A continuación, añada los encabezados a la configuración guardada.
Las versiones anteriores también admiten MCP: Abrir configuración de usuario o .vscode/mcp.json. Estos archivos utilizan la sintaxis servers en lugar de mcpServers y ${env:MARKETO_CLIENT_ID} para las variables de entorno. No mezcle los dos formatos. Para obtener más información, consulte Configuración de MCP de código VS.
Copilot Studio
Active la orquestación generativa para su agente antes de agregar herramientas de MCP. Use un conector personalizado para definir los tres encabezados Marketo necesarios.
En la página de Herramientas del agente, seleccione Agregar una herramienta > Nueva herramienta > Conector personalizado. En Power Apps, crea un conector personalizado y usa el editor Swagger para escribir la siguiente definición:
| code language-yaml |
|---|
|
Guarde o actualice el conector, vuelva a Copilot Studio y agréguelo a su agente. Cree una conexión y proporcione los tres valores de encabezado cuando se le solicite. Mantenga las credenciales fuera de la definición de OpenAPI y de las instrucciones del agente. Para obtener más información, vea Conectar un agente a un servidor MCP existente.
Espigar glean
Para conectar Glean al servidor MCP Marketo Engage, siga las instrucciones de configuración de MCP remoto de Glean para agregar https://marketo-mcp.adobe.io/mcp. Compruebe primero el catálogo Connectors. Para un servidor personalizado o no enumerado, use Admin Console > Platform > Tools > Import tools from MCP server.
El equipo de soporte técnico de Glean debe configurar los encabezados personalizados siguientes. Incluya el nombre del servidor, la dirección URL y los nombres de encabezado necesarios en la solicitud de asistencia y coordine la administración segura de los valores de credenciales. Una conexión de clave de API estándar por sí sola no proporciona los tres encabezados.
| table 0-row-2 1-row-2 2-row-2 3-row-2 | |
|---|---|
| Encabezado | Valor |
X-Marketo-Client-Id |
Su ID de cliente |
X-Marketo-Client-Secret |
Secreto de cliente |
X-Marketo-Munchkin-Id |
Su ID de cuenta de Munchkin |
Después de que Glean confirme que los encabezados están activos, pruebe la conexión con una solicitud de solo lectura antes de poner las herramientas a disposición de otros usuarios.
Otras herramientas other-tools
Adobe aloja el servidor MCP Marketo y lo expone en una dirección URL pública. Cualquier cliente MCP que admita servidores remotos a través de transporte HTTP transmisible puede conectarse a él.
Los clientes que admiten conexiones HTTP remotas directas no necesitan un puente ni software de servidor instalado localmente. Si la herramienta no aparece en la lista anterior, utilice los detalles de conexión siguientes para configurarla manualmente.
Detalles de conexión:
| table 0-row-2 1-row-2 2-row-2 | |
|---|---|
| Configuración | Valor |
| Transporte | HTTP (HTTP transmisible) |
| URL del servidor | https://marketo-mcp.adobe.io/mcp |
Encabezados de autenticación:
Envíe los tres encabezados con cada solicitud. El lugar donde se introduce la URL del servidor y los encabezados dependen de la herramienta, por lo que consulte su documentación de MCP.
| table 0-row-2 1-row-2 2-row-2 3-row-2 | |
|---|---|
| Encabezado | Valor |
X-Marketo-Client-Id |
Su ID de cliente |
X-Marketo-Client-Secret |
Secreto de cliente |
X-Marketo-Munchkin-Id |
Su ID de cuenta de Munchkin |
Si su herramienta acepta una configuración JSON, comience con los ejemplos de Cursor o Código VS, y ajuste las claves y la sintaxis de las variables de entorno para que coincidan con el esquema de la herramienta.
Después de conectarse, pídale al asistente de IA que use el servidor MCP Marketo para enumerar los canales disponibles sin cambiar ningún dato. Inspeccione la llamada de herramienta y su respuesta para confirmar que la solicitud utiliza el servidor deseado y devuelve datos sin un error de conexión o autenticación.
Operaciones disponibles
Una vez conectado, puede pedir a su asistente de IA que realice operaciones en las siguientes categorías. Para conocer las excepciones y los requisitos de disponibilidad, consulte Operaciones de MCP compatibles.
Formularios
Examinar, crear, clonar y aprobar formularios. Agregue o quite campos, configure reglas de visibilidad de campos e identifique dónde están incrustados los formularios.
Ejemplos de peticiones de datos:
- “Mostrar todos los formularios aprobados”
- “Clone el formulario Contact Us en la carpeta Q2 Campaign”
- “Agregar un campo Compañía al formulario de solicitud de demostración”
Campañas inteligentes
Cree campañas inteligentes, configure filtros de listas inteligentes, agregue pasos de flujo y active o desactive campañas.
Ejemplos de peticiones de datos:
- “¿Qué campañas inteligentes están activas ahora?”
- “Cree una nueva campaña inteligente llamada Actualización de puntuación de posibles clientes en la carpeta Operaciones”
- “Mostrarme los pasos de flujo en la campaña de correo electrónico de bienvenida”
Posibles clientes y listas
Buscar posibles clientes por dirección de correo electrónico, crear registros de posibles clientes y administrar la pertenencia a listas estáticas.
Ejemplos de peticiones de datos:
- “Encontrar el posible cliente con el correo electrónico jane@example.com”
- “Agregar ID de posible cliente 12345 a la lista de MQL del segundo trimestre”
- “Crear una nueva lista estática llamada Asistentes al evento de verano”
Programas
Crear, clonar y etiquetar programas. Examinar programas por tipo, canal o intervalo de fechas.
Ejemplos de peticiones de datos:
- “Clonar el programa de seminario web del cuarto trimestre en la carpeta Eventos de 2026”
- “Cree un nuevo programa de correo electrónico llamado Rebajas de verano en la carpeta Campañas”
- “Mostrar todos los programas etiquetados como seminario web”
Correos electrónicos y fragmentos
Examine correos electrónicos, cree correos electrónicos a partir de plantillas, actualice secciones de contenido y administre fragmentos reutilizables.
Ejemplos de peticiones de datos:
- “Mostrar todos los borradores de correos electrónicos”
- “Actualizar la sección de encabezado del correo electrónico de bienvenida”
- “¿Qué recursos utilizan el fragmento de promoción de vacaciones?”
Estructura de instancia
Para comprender la configuración de Marketo, examine carpetas, canales, tipos de etiquetas y tipos de actividades.
Ejemplos de peticiones de datos:
- “Enumerar todas las carpetas en Marketo”
- “Mostrar todos los canales disponibles”
- “¿Qué tipos de etiquetas están configurados?”
Operaciones masivas
Exportar datos de posibles clientes de forma masiva y comprobar el estado del trabajo de importación o exportación.
Ejemplos de peticiones de datos:
- “Crear una exportación masiva de posibles clientes creada en los últimos 30 días”
- “Comprobar el estado del trabajo de exportación xx”
Resolución de problemas
X-Marketo-Client-Id, X-Marketo-Client-Secret o X-Marketo-Munchkin-Id.Authorization.Consideraciones de seguridad
- Credenciales por solicitud. El ID del cliente, el Secreto del cliente, el ID de Munchkin y el extremo de la API de REST se transmiten en encabezados HTTP con cada solicitud. El servidor no los almacena en caché.
- Aislamiento de varios inquilinos. Cada solicitud utiliza su propio conjunto de credenciales. Los datos no se cruzan con la sesión de ningún otro usuario.
- lista de permitidos de Munchkin ID. El servidor solo acepta solicitudes para instancias de Marketo aprobadas. Las solicitudes que utilizan un ID de Munchkin no autorizado se rechazan con un error 403.
- límites de tasa de API. El servidor MCP hereda los límites de tasa de API de su instancia Marketo. Utilice un usuario de API dedicado para rastrear y administrar el consumo de cuotas.
- Mantener credenciales fuera del control de versiones. Utilice la interpolación de variables de entorno (
${MARKETO_CLIENT_SECRET}) si la herramienta de IA la admite, de modo que las credenciales no se almacenen en texto sin formato en los archivos del repositorio.
Gobernanza y retención de datos
Administración de credenciales
- Las credenciales del cliente no se mantienen en el lado del servidor y las proporciona el cliente por solicitud, lo que ayuda a limitar la exposición de las credenciales dentro del servicio.
Modelo de interacción de API
- Uso del agente: los agentes pueden utilizar el servidor MCP para invocar las API de Marketo admitidas.
- Alineación del modelo de autenticación: El servicio utiliza el mismo modelo de autenticación de API externa documentado para las API de Marketo.
Autenticación y autorización
- Privilegio Least: los permisos efectivos se heredan del usuario solo de la API de Marketo asignado al servicio LaunchPoint del cliente, lo que permite una administración de menos privilegios dentro de la configuración de Marketo del cliente.
- Sin persistencia de tokens del lado del servidor: El servicio sigue evitando el almacenamiento del lado del servidor de credenciales de cliente o tokens.
Registro y monitorización
- Registro de seguridad: los registros JSON estructurados se enrutan a través de Bit fluido a Splunk, con enmascaramiento de datos confidenciales y filtrado adicional para admitir requisitos de cumplimiento.
- Soporte de auditoría: estos controles admiten la monitorización continua de la disponibilidad del servicio, los eventos relevantes para la seguridad y la calidad operativa.
- Sin almacenamiento secreto del lado del servidor: la implementación de MCP no almacena las credenciales del cliente, que deben proporcionarlas los clientes por cada solicitud.
- Administración de tokens: los tokens de acceso son de corta duración, las respuestas de tokens se marcan como sin almacenamiento y los tokens se aceptan a través de mecanismos de autorización estándar en lugar de transmisión de cadena de consulta.
- Acceso operativo basado en funciones: el acceso de implementación administrativa se rige por las funciones de infraestructura de Adobe y los controles basados en grupos, mientras que los permisos del plano de datos se heredan de la configuración de usuario de la API de Marketo del cliente.
- Auditoría y observabilidad: el registro, el enmascaramiento, la monitorización y las alertas de seguridad están habilitados para admitir la investigación, el seguimiento del estado del servicio y la supervisión operativa.