Servidor MCP de Marketo

Un servidor de Protocolo de Contexto de Modelo para interactuar con la API de Marketo. Este servidor proporciona herramientas para gestionar formularios de Marketo, incluyendo su listado, clonación y aprobación.

Prerrequisitos

Node.js (v14 o superior)
Credenciales de la API de Marketo (ID de cliente y secreto de cliente)
Una instancia de Marketo con acceso API habilitado
Claude Desktop instalado

Empezando

1. Obtener las credenciales de la API de Marketo

Inicie sesión en su panel de administración de Marketo
Vaya a Administración > Integración > LaunchPoint
Haga clic en Nuevo > Nuevo servicio
Complete los detalles del servicio:
- Servicio: Personalizado
- Nombre para mostrar: (por ejemplo, "Servidor MCP")
Guarde el ID de cliente y el secreto de cliente proporcionados

2. Configurar variables de entorno

Cree un archivo .env en el directorio raíz:

# Your Marketo instance URL (required)
# Example: https://123-ABC-456.mktorest.com/rest
MARKETO_BASE_URL=your-marketo-instance-url

# Your API credentials (required)
MARKETO_CLIENT_ID=your-client-id
MARKETO_CLIENT_SECRET=your-client-secret

3. Instalación y configuración

# Install dependencies
npm install

# Build the project
npm run build

# The build process will output configuration settings in your console
# Copy these settings into your Claude Desktop developer configuration

4. Configuración del escritorio de Claude

Abra Claude Desktop
Vaya a Configuración de desarrollador
Pegue las configuraciones que se generaron durante el proceso de compilación
Guardar la configuración
Reiniciar Claude Desktop

Herramientas disponibles

Obtener lista de formularios

marketo_get_forms({
  maxReturn: 200,  // optional, default: 200
  offset: 0,       // optional, default: 0
  status: 'draft'  // optional, 'draft' or 'approved'
})

Obtener formulario por ID

marketo_get_form_by_id({
  formId: 1234
})

Forma de clonación

marketo_clone_form({
  formId: 1234,           // ID of form to clone
  name: "New Form Name",  // Name for the cloned form
  description: "Form description",  // optional
  folderId: 5678         // optional, destination folder ID
})

Formulario de aprobación

marketo_approve_form({
  formId: 1234,
  comment: "Approved by MCP server"  // optional
})

Manejo de errores

Escenarios de error comunes y soluciones:

Errores de autenticación
- Verifique que su ID de cliente y su secreto de cliente sean correctos
- Comprueba que tu acceso a la API esté habilitado en Marketo
- Asegúrese de que la URL de su instancia sea correcta
Errores de permisos
- Verifique que su usuario de API tenga permisos suficientes
- Comprobar los permisos de acceso a la carpeta para las operaciones de formulario
Limitación de velocidad
- El servidor gestiona automáticamente la actualización del token.
- Considere implementar lógica de reintento para solicitudes con frecuencia limitada

Mejores prácticas

Gestión del medio ambiente
- Nunca envíe archivos .env al control de versiones
- Utilice diferentes credenciales para el desarrollo y la producción
- Rote periódicamente sus credenciales de API
Seguridad
- Almacenar credenciales de forma segura
- Utilice variables de entorno para datos confidenciales
- Supervisar los registros de acceso a la API
Actuación
- Almacenar en caché los datos del formulario cuando sea apropiado
- Utilice la paginación para listas de formatos grandes
- Gestionar los límites de velocidad de forma adecuada

Desarrollo

Estructura del proyecto

├── src/
│   ├── index.ts        # Server entry point
│   ├── auth.ts         # Token management
│   └── constants.ts    # Configuration
├── .env                # Environment variables (not in git)
├── .env.example        # Example environment file
└── .gitignore         # Git ignore rules

Contribuyendo

Bifurcar el repositorio
Crear una rama de características
Realiza tus cambios
Enviar una solicitud de extracción

Apoyo

Para problemas y preguntas:

Consulte la documentación de la API REST de Marketo
Revise los escenarios de error comunes anteriores
Enviar un problema al repositorio

Marketo MCP Server

Integrations