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 Q2 Webinars 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: Xero MCP Server

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 — lista, inspecciona, clona y aprueba formularios a través de la API de activos de Marketo

• Operaciones de listas inteligentes — lista e inspecciona listas inteligentes

• CRUD de canales — crea, lee, actualiza y elimina canales

• Base de datos de leads — obtén leads por ID o correo electrónico, crea o actualiza leads de forma masiva, elimina leads

• Registros de actividades y cambios — obtén actividades y cambios de campo para cualquier lead

• Membresía de listas — añade o elimina leads de listas estáticas

• 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, el ID de cliente y el 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 → Integration → LaunchPoint

3. New → New Service, establece el tipo de servicio en Custom y elige un nombre para mostrar (por ejemplo, MCP Server)

4. Asigna un usuario de solo API con los permisos que necesites (Read-Only Assets, Read-Write Lead, etc.)

5. Guarda el Client ID y el Client Secret

6. Tu URL base se encuentra en Admin → Integration → Web Services → REST API Endpoint (elimina /rest/v1/* — mantén solo https://<munchkin>.mktorest.com/rest)

Configuración

Toda la configuración se realiza mediante 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": "..." }
    }
  }
}

Solución de problemas

Puedes inspeccionar las llamadas a herramientas localmente con el inspector 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 un PR

Licencia

ISC — ver LICENSE.

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