DocumentaciónGuía para desarrolladores de Marketo

[Disponibilidad limitada]{class="badge informative" title="Actualmente, esta función está en versión beta limitada"}

Servidor MCP Marketo Engage

Última actualización: 8 de mayo de 2026

Creado para:

  • {"id":"ff6a42d2-313e-452e-93a6-792e4fad9ff8"}
AVAILABILITY
Esta función tiene disponibilidad limitada. Para solicitar acceso, rellene este formulario. Asegúrese de tener preparado el Munchkin ID de su suscripción.

El Protocolo de contexto de modelo (MCP) es un estándar abierto que permite a las herramientas de IA comunicarse con servicios externos. El servidor MCP Marketo actúa como un puente entre su asistente de IA y Marketo. Expone más de 100 operaciones en formularios, programas, campañas inteligentes, posibles clientes, correos electrónicos, fragmentos de código, listas y carpetas.

Cuando la herramienta de IA llama al servidor MCP, el servidor ejecuta la llamada de API de REST correspondiente en su nombre, utilizando las credenciales proporcionadas en cada solicitud. No es necesario instalar, implementar ni ejecutar ningún software del lado del servidor.

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 espacio aislado antes de usarlas de forma productiva y revisar y validar cuidadosamente todas las acciones y respuestas iniciadas por MCP antes de confirmarlas o confiar en ellas.

Conceptos básicos de MCP

Piense en MCP como un puerto USB-C para aplicaciones de IA. Al igual que USB-C ofrece una forma estandarizada de conectar sus dispositivos a varios periféricos y accesorios, MCP ofrece 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 a varios servicios externos al mismo tiempo. Por ejemplo, un asistente de IA podría:

  • 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

MCP es un protocolo de comunicación: un estándar abierto que cualquier aplicación puede implementar para exponer sus datos y 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
  • Una de las siguientes herramientas de IA: Claude Desktop, Cursor, Codex, Claude Code (CLI) o VS Code con GitHub Copilot
  • 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

Cada herramienta de IA tiene una configuración ligeramente diferente. Se proporcionan 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.

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 para que pueda hacer referencia al siguiente paso.

También necesitará esto:

  • Node.js v18+
  • npm
  1. Abrir Claude Desktop
  2. Vaya a Configuración > Desarrollador > Editar configuración
  3. Agregar lo siguiente a claude_desktop_config.json:
{
  "preferences": {
    ...
  },
  "mcpServers": {
    "marketo-mcp": {
      "command": "node",
      "args": ["/path/to/marketo-bridge/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. Reiniciar Claude Desktop

Cursor cursor

Si la configuración de MCP de cursor ya contiene otros servidores, agregue la entrada marketo en mcpServers. El siguiente ejemplo muestra el bloque mcpServers completo en Configuración > MCP o .cursor/mcp.json en el directorio del proyecto:

Credenciales de cliente de Marketo
code language-json 
{
  "mcpServers": {
    "marketo": {
      "type": "http",
      "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"
      }
    }
  }
}
Token de IMS
code language-json 
{
  "mcpServers": {
    "marketo": {
      "type": "http",
      "url": "https://marketo-mcp.adobe.io/mcp",
      "headers": {
        "Authorization": "Bearer YOUR-IMS-TOKEN",
        "x-gw-ims-org-id": "YOUR-IMS-ORG-ID"
      }
    }
  }
}

Reiniciar cursor.

Código Claude (CLI) claude-code

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

Credenciales de cliente de Marketo
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"
Token de IMS
code language-bash 
claude mcp add --transport http marketo \
  https://marketo-mcp.adobe.io/mcp \
  --header "Authorization: Bearer YOUR-IMS-TOKEN" \
  --header "x-gw-ims-org-id: YOUR-IMS-ORG-ID"

Códice OpenAI codex

  1. Vaya a Configuración > Servidores MCP > Agregar servidor
  2. Agregar la dirección URL del servidor: https://marketo-mcp.adobe.io/mcp
  3. Añada los encabezados del método de autenticación:
Credenciales de cliente de Marketo
  • X-Marketo-Client-Id: “YOUR-CLIENT-ID”
  • X-Marketo-Client-Secret: “YOUR-CLIENT-SECRET”
  • X-Marketo-Munchkin-Id: “YOUR-MUNCHKIN-ID”
Token de IMS
  • Autorización: “Portador YOUR-IMS-TOKEN”
  • x-gw-ims-org-id: “YOUR-IMS-ORG-ID”
  1. Haga clic en Guardar para completar el proceso.

Código VS con el copiloto de GitHub vscode

Presione Ctrl+Mayús+P (o Cmd+Mayús+P en macOS), escriba MCP: Abrir configuración de usuario y presione Entrar. Se abre mcp.json. Agregar la entrada marketo dentro del objeto servers:

Credenciales de cliente de Marketo
code language-json 
{
  "servers": {
    "marketo": {
      "type": "http",
      "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"
      }
    }
  }
}
Token de IMS
code language-json 
{
  "servers": {
    "marketo": {
      "type": "http",
      "url": "https://marketo-mcp.adobe.io/mcp",
      "headers": {
        "Authorization": "Bearer YOUR-IMS-TOKEN",
        "x-gw-ims-org-id": "YOUR-IMS-ORG-ID"
      }
    }
  }
}
NOTE
Por motivos de seguridad, utilice la interpolación de variables de entorno en archivos de configuración en lugar de pegar las credenciales directamente. Puede hacer referencia a variables mediante sintaxis como ${MARKETO_CLIENT_SECRET} y establecerlas en su entorno. Esto evita que las credenciales se almacenen en texto sin formato en archivos con control de versiones.

Operaciones disponibles

Una vez conectado, puede pedir a su asistente de IA que realice operaciones en las siguientes categorías. Para obtener la lista completa de operaciones compatibles con referencias de API, 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 o actualizar 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.
recommendation-more-help
marketo-developer-help