Servidor MCP de Marketo

Un servidor del Protocolo de Contexto de Modelo para Adobe Marketo Engage. Ofrece a Claude Desktop, Cursor y otros clientes compatibles con MCP acceso directo y autenticado a la API REST de Marketo: lee y escribe formularios, listas inteligentes, canales, leads, actividades y listas mediante lenguaje natural.

Por qué

Los equipos de operaciones de marketing, crecimiento y RevOps pasan horas haciendo clic en la interfaz de usuario de Marketo para clonar un formulario, aprobar activos, buscar un lead o auditar una lista inteligente. El Servidor MCP de Marketo conecta esas mismas operaciones de la API REST a un agente de LLM, para que puedas decir:

• "Clona el formulario 1234 en la carpeta de Seminarios web del Q2 y apruébalo."

• "Muéstrame las actividades recientes del lead alex@example.com."

• "Crea un nuevo canal de correo electrónico llamado 'Lifecycle Nurture'."

…y el modelo ejecuta las llamadas reales a la API de Marketo en tu nombre.

Related MCP server: Dynamic Form MCP

Tabla de contenidos

• Características

• Inicio rápido

• Requisitos previos

• Configuración

• Herramientas disponibles

• Uso con Claude Desktop

• Uso con Cursor / otros clientes MCP

• Solución de problemas

• Desarrollo

• Contribución

Características

• Gestión de formularios — listar, inspeccionar, clonar y aprobar formularios a través de la API de activos de Marketo

• Operaciones de listas inteligentes — listar e inspeccionar listas inteligentes

• CRUD de canales — crear, leer, actualizar y eliminar canales

• Base de datos de leads — obtener leads por ID o correo electrónico, crear o actualizar leads de forma masiva, eliminar leads

• Registros de actividades y cambios — obtener actividades y cambios de campo para cualquier lead

• Membresía de listas — añadir o eliminar leads de listas estáticas

• Gestión de programas — listar, inspeccionar, clonar programas y recuperar miembros de programas

• Operaciones de correo electrónico — listar, inspeccionar y enviar correos electrónicos de muestra para control de calidad (QA)

• Autenticación automática — flujo de credenciales de cliente OAuth 2.0 con almacenamiento en caché y actualización de tokens

• Transporte stdio — funciona directamente con Claude Desktop, Cursor y cualquier cliente MCP que utilice stdio

Inicio rápido

Opción A — Smithery (recomendado)

npx -y @smithery/cli install @alexleventer/marketo-mcp --client claude

Sigue las instrucciones para pegar tu URL base de Marketo, ID de cliente y secreto de cliente.

Opción B — npx (sin instalación)

Añade lo siguiente a la configuración de tu cliente MCP (por ejemplo, claude_desktop_config.json):

{
  "mcpServers": {
    "marketo": {
      "command": "npx",
      "args": ["-y", "marketo-mcp"],
      "env": {
        "MARKETO_BASE_URL": "https://123-ABC-456.mktorest.com/rest",
        "MARKETO_CLIENT_ID": "your-client-id",
        "MARKETO_CLIENT_SECRET": "your-client-secret"
      }
    }
  }
}

Opción C — desde el código fuente

git clone https://github.com/alexleventer/marketo-mcp.git
cd marketo-mcp
npm install
npm run build

Copia el bloque de configuración impreso por la compilación en tu cliente MCP.

Requisitos previos

• Node.js 18 o superior

• Credenciales de la API de Marketo (ID de cliente y secreto de cliente de un servicio LaunchPoint)

• Una instancia de Marketo con acceso a la API REST habilitado

• Un cliente compatible con MCP — Claude Desktop, Cursor, Cline o cualquier otro

Obtención de credenciales de la API de Marketo

1. Inicia sesión en el administrador de Marketo

2. Admin → Integración → LaunchPoint

3. Nuevo → Nuevo servicio, establece el tipo de servicio en Personalizado y elige un nombre para mostrar (por ejemplo, Servidor MCP)

4. Asigna un usuario exclusivo de API con los permisos que necesites (Solo lectura de activos, Lectura/Escritura de leads, etc.)

5. Guarda el ID de cliente y el Secreto de cliente

6. Tu URL base se encuentra en Admin → Integración → Servicios web → Punto final de la API REST (elimina /rest/v1/* — mantén solo https://<munchkin>.mktorest.com/rest)

Configuración

Toda la configuración se realiza a través de variables de entorno:

Copia .env.example a .env para el desarrollo local.

Herramientas disponibles

Cada herramienta acepta argumentos tipados validados con zod y devuelve la respuesta JSON sin procesar de Marketo. Consulta la referencia de la API REST de Adobe Marketo para obtener detalles a nivel de campo.

Uso con Claude Desktop

1. Instala Claude Desktop

2. Abre la configuración en ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) o %APPDATA%\Claude\claude_desktop_config.json (Windows)

3. Pega el bloque mcpServers de Inicio rápido

4. Reinicia Claude Desktop

Uso con Cursor / otros clientes MCP

Cualquier cliente MCP que admita servidores stdio funcionará. Apúntalo al binario compilado:

{
  "mcpServers": {
    "marketo": {
      "command": "npx",
      "args": ["-y", "marketo-mcp"],
      "env": { "MARKETO_BASE_URL": "...", "MARKETO_CLIENT_ID": "...", "MARKETO_CLIENT_SECRET": "..." }
    }
  }
}

Límites de tasa

Marketo impone varios límites de tasa de API. Tenlos en cuenta al ejecutar operaciones por lotes:

Si recibes 606 Max rate limit reached, espera 20 segundos antes de volver a intentarlo. La API REST de Marketo devuelve una cabecera Retry-After en algunos casos.

Solución de problemas

Puedes inspeccionar las llamadas a herramientas localmente con el inspector de MCP:

npm run inspector

Desarrollo

src/
├── index.ts       # MCP server + all tool registrations
├── auth.ts        # OAuth token manager (caches until expiry)
└── constants.ts   # Env var bindings

npm run dev          # Run with ts-node + .env
npm run typecheck    # Type-check without emit
npm run lint         # ESLint
npm run format       # Prettier
npm run build        # Compile to build/

Contribución

Las incidencias y solicitudes de extracción (pull requests) son bienvenidas en github.com/alexleventer/marketo-mcp.

1. Haz un fork del repositorio

2. Crea una rama de características

3. npm run lint && npm run typecheck

4. Abre una PR

Licencia

ISC — ver LICENSE.

Palabras clave: servidor mcp marketo, protocolo de contexto de modelo marketo, marketo claude, marketo ai, adobe marketo mcp, api marketo claude desktop, automatización marketo llm, marketo engage mcp