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.

IMPORTANT
El Modelo de Protocolo de Contexto (MCP) es un estándar de código abierto emergente y puede presentar riesgos de seguridad o fiabilidad. Las integraciones del servidor de Adobe MCP y la documentación relacionada se proporcionan "tal cual", sin garantías de ningún tipo.
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

  1. Vaya a Administración > LaunchPoint.
  2. 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.
  3. Seleccione Ver detalles y copie los valores ID de cliente y Secreto de cliente.

ID de cuenta de Munchkin

  1. Vaya a Administración > Munchkin.
  2. Copie la cuenta de Munchkin. El formato es XXX-XXX-XXX y 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.

TIP
Para conectarse a varias instancias de Marketo, agregue entradas independientes en la configuración de MCP con nombres únicos: marketo-prod y marketo-staging, cada uno con las credenciales correspondientes.
Escritorio Claude

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.

  1. Abra Claude Desktop.
  2. 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.
  3. 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
{
  "mcpServers": {
    "marketo-mcp": {
      "command": "node",
      "args": ["/path/to/marketo-bridge/marketo-mcp-bridge.mjs"],
      "env": {
        "MARKETO_MCP_PROD_CLIENT_ID": "<your-client-id>",
        "MARKETO_MCP_PROD_CLIENT_SECRET": "<your-client-secret>",
        "MARKETO_MCP_PROD_MUNCHKIN_ID": "<your-munchkin-id>"
      }
    }
  }
}
  1. 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 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
{
  "mcpServers": {
    "marketo": {
      "url": "https://marketo-mcp.adobe.io/mcp",
      "headers": {
        "X-Marketo-Client-Id": "YOUR-CLIENT-ID",
        "X-Marketo-Client-Secret": "YOUR-CLIENT-SECRET",
        "X-Marketo-Munchkin-Id": "YOUR-MUNCHKIN-ID"
      }
    }
  }
}

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.

CLI de código Claude

Código Claude (CLI) claude-code

Ejecute el siguiente comando en el terminal, sustituyendo las credenciales:

code language-bash
claude mcp add --transport http marketo \
  https://marketo-mcp.adobe.io/mcp \
  --header "X-Marketo-Client-Id: YOUR-CLIENT-ID" \
  --header "X-Marketo-Client-Secret: YOUR-CLIENT-SECRET" \
  --header "X-Marketo-Munchkin-Id: YOUR-MUNCHKIN-ID"

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

Códice OpenAI codex

Agregue lo siguiente a ~/.codex/config.toml, conservando cualquier configuración existente:

code language-toml
[mcp_servers.marketo]
url = "https://marketo-mcp.adobe.io/mcp"

[mcp_servers.marketo.env_http_headers]
X-Marketo-Client-Id = "MARKETO_CLIENT_ID"
X-Marketo-Client-Secret = "MARKETO_CLIENT_SECRET"
X-Marketo-Munchkin-Id = "MARKETO_MUNCHKIN_ID"

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

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
{
  "mcpServers": {
    "marketo": {
      "httpUrl": "https://marketo-mcp.adobe.io/mcp",
      "headers": {
        "X-Marketo-Client-Id": "YOUR-CLIENT-ID",
        "X-Marketo-Client-Secret": "YOUR-CLIENT-SECRET",
        "X-Marketo-Munchkin-Id": "YOUR-MUNCHKIN-ID"
      }
    }
  }
}

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
gemini mcp add --transport http -s user marketo https://marketo-mcp.adobe.io/mcp \
  -H "X-Marketo-Client-Id: $MARKETO_CLIENT_ID" \
  -H "X-Marketo-Client-Secret: $MARKETO_CLIENT_SECRET" \
  -H "X-Marketo-Munchkin-Id: $MARKETO_MUNCHKIN_ID"

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

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
{
  "mcpServers": {
    "marketo": {
      "type": "http",
      "url": "https://marketo-mcp.adobe.io/mcp",
      "headers": {
        "X-Marketo-Client-Id": "${MARKETO_CLIENT_ID}",
        "X-Marketo-Client-Secret": "${MARKETO_CLIENT_SECRET}",
        "X-Marketo-Munchkin-Id": "${MARKETO_MUNCHKIN_ID}"
      }
    }
  }
}

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

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
swagger: '2.0'
info:
  title: Marketo MCP Server
  description: Connect to the Marketo MCP server.
  version: 1.0.0
host: marketo-mcp.adobe.io
basePath: /
schemes:
  - https
paths:
  /mcp:
    post:
      summary: Marketo MCP Server
      description: Invoke the Marketo MCP server.
      operationId: InvokeServer
      x-ms-agentic-protocol: mcp-streamable-1.0
      parameters:
        - name: X-Marketo-Client-Id
          in: header
          description: Client ID.
          type: string
          required: true
        - name: X-Marketo-Client-Secret
          in: header
          description: Client secret.
          type: string
          required: true
        - name: X-Marketo-Munchkin-Id
          in: header
          description: Munchkin ID.
          type: string
          required: true
      responses:
        '200':
          description: Immediate Response
securityDefinitions: {}
security: []

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.

Glean

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

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

Error
Causa
Corregir
“No se han proporcionado las credenciales de Marketo”
Falta uno o más de X-Marketo-Client-Id, X-Marketo-Client-Secret o X-Marketo-Munchkin-Id.
Compruebe que todos los encabezados de credenciales del cliente de Marketo estén presentes en la configuración.
“401 No autorizado”
Faltan las credenciales, no son válidas o han caducado. Con las credenciales del cliente de Marketo, el ID o el secreto del cliente son incorrectos. Con un token de IMS, el token no es válido o ha caducado.
Compruebe las credenciales del método de autenticación. Para obtener las credenciales de cliente, vuelva a comprobar el ID de cliente y el secreto de cliente en Admin > LaunchPoint. Para un token de IMS, genere un nuevo token y actualice el encabezado Authorization.
“403 Prohibido”
Sus credenciales son válidas, pero la instancia de Marketo no está habilitada para el acceso a MCP.
Póngase en contacto con su administrador de MCP Marketo para habilitar el acceso de MCP a su ID de cuenta de Munchkin.
“Demasiadas solicitudes” (límite de tasa)
Ha enviado demasiadas solicitudes en un breve período o demasiadas solicitudes al mismo tiempo y ha alcanzado los límites de API de su instancia de Marketo.
Reduzca la frecuencia y la cantidad de solicitudes que envía a la vez y espere un poco antes de volver a intentarlo. Use un usuario de API dedicado para rastrear y administrar su cuota.
Tiempo de espera de conexión o rechazado
No se puede acceder al servidor MCP desde la red.
Confirme que puede acceder a la URL del servidor desde su entorno. Compruebe los requisitos de VPN si corresponde.
Las llamadas a herramientas devuelven resultados vacíos
El usuario de la API carece de permisos para el tipo de recurso solicitado.
Pida al administrador de Marketo que revise la función de usuario y los permisos de la API.

Consideraciones de seguridad

IMPORTANT
Use un usuario de API dedicado en Marketo con solo los permisos necesarios para su trabajo. No reutilice las credenciales de administrador para el acceso a la API.
  • 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.
recommendation-more-help
marketo-developer-help