Woodpecker

Gestiona campañas de correo electrónico en Woodpecker usando lenguaje natural.

Documentación

Servidor MCP de Woodpecker

La integración de Woodpecker MCP (Model Context Protocol) transforma la gestión de campañas de correo electrónico en frío en una experiencia conversacional.

Al conectar tu asistente de IA a la potente plataforma de automatización de Woodpecker, puedes crear, gestionar y optimizar campañas de correo electrónico mediante interacciones en lenguaje natural.

Comienza con comandos simples como listar campañas y crear secuencias básicas de divulgación. Luego explora gradualmente funciones avanzadas como pruebas A/B, secuencias de seguimiento complejas e informes analíticos detallados.

Características

Gestión de Campañas: Crear, actualizar, ejecutar, pausar y eliminar campañas de correo electrónico
Operaciones con Prospectos: Añadir prospectos a tu cuenta y campañas, actualizar y eliminar datos de prospectos, buscar prospectos
Composición de Correos: Crear secuencias de correo de varios pasos con capacidades de pruebas A/B
Analítica e Informes: Obtener estadísticas de campañas y métricas de rendimiento
Integración de Buzones: Asignar cuentas de correo a campañas
Configuración Avanzada: Soporte para horarios de entrega, ajustes de zona horaria y cumplimiento del RGPD

Instalación

Requisitos Previos

Antes de configurar la integración, asegúrate de tener:

Cuenta de Woodpecker: Una cuenta con el complemento API e Integración habilitado
Credenciales de API: Clave API de Woodpecker (se encuentra en la configuración de tu cuenta)
Docker: Instalado en tu sistema (para ejecutar el servidor MCP) https://docs.docker.com/desktop/
Agente de IA: Claude Desktop, Continue.dev u otra plataforma de IA compatible con MCP

Cómo Obtener tu Clave API de Woodpecker

Inicia sesión en tu cuenta de Woodpecker (https://login.woodpecker.co/)
Ve al Marketplace en la esquina superior derecha → Integraciones → 'Claves API'
Haz clic en Create a key

Configuración del Agente de IA

Claude Desktop

Paso 1: Localizar el Archivo de Configuración

Encuentra tu archivo de configuración de Claude Desktop:

macOS:

~/Library/Application Support/Claude/claude_desktop_config.json

Windows:

%APPDATA%\Claude\claude_desktop_config.json

Linux:

~/.config/Claude/claude_desktop_config.json

Paso 2: Añadir la Configuración del Servidor MCP

Edita el archivo de configuración para incluir el servidor MCP de Woodpecker:

{
    "mcpServers": {
        "woodpecker": {
            "command": "docker",
            "args": [
                "run",
                "-i",
                "--rm",
                "-e",
                "WOODPECKER_API_KEY",
                "woodpeckerco/woodpecker-mcp-server"
            ],
            "env": {
                "WOODPECKER_API_KEY": "<YOUR_API_KEY>"
            }
        }
    }
}

Paso 3: Reiniciar Claude Desktop

Cierra Claude Desktop por completo
Reinicia la aplicación
Busca las herramientas de Woodpecker en la interfaz

Otros Agentes Compatibles con MCP

Para otras plataformas de IA que soporten MCP:

Asegurar Soporte MCP: Verifica que tu agente de IA soporte el Model Context Protocol
Autenticación: Proporciona las credenciales API de Woodpecker (WOODPECKER_API_KEY) mediante variables de entorno
Protocolo: Usa transporte stdio según lo soportado por tu agente

Verificación y Pruebas

En tu agente de IA, intenta preguntar:

"What Woodpecker tools do you have access to?"
"List my Woodpecker campaigns"

Solución de Problemas

El Servidor MCP No Se Conecta

Síntomas: El agente de IA no puede acceder a las herramientas de Woodpecker

Soluciones:

Prueba con la ruta absoluta de Docker (p. ej., /usr/local/bin/docker) en la Configuración del Servidor MCP
Comprueba si el contenedor Docker está ejecutándose: docker ps
Prueba la clave API: Haz una llamada API directa a Woodpecker

Credenciales API Inválidas

Síntomas: Errores de "No autorizado" o "Clave API inválida"

Soluciones:

Regenera la clave API en la configuración de Woodpecker
Actualiza las variables de entorno con la nueva clave
Reinicia la aplicación del Agente de IA

Herramientas No Disponibles

Síntomas: El agente de IA no ve las funciones de Woodpecker

Soluciones:

Comprueba la configuración del servidor MCP en el agente de IA
Reinicia la aplicación del agente de IA
Revisa los registros del agente de IA para ver errores de conexión MCP

La Creación de Campañas Falló

Síntomas: Error al crear campañas

Soluciones:

Asegúrate de tener al menos una cuenta de correo configurada en Woodpecker
Verifica los IDs de las cuentas de correo con la función listMailboxes
Comprueba que los parámetros de la campaña coinciden con el formato requerido
Asegúrate de que el límite diario de inscripción sea > 0

Ejemplos de Uso

Creando tu Primera Campaña

"Create a new email campaign with these details:
- Name: Product Demo Outreach
- Subject: Quick demo of our new feature
- Message: Hi {{FIRST_NAME}}, I'd love to show {{COMPANY}} our new feature. Are you available for a 15-minute demo?
- Send Monday-Friday, 9 AM to 5 PM
- Daily limit: 25 prospects
- Use my main email account"

Añadiendo Prospectos en Masa

"Add these prospects to campaign 12345:
1. John Doe, john@example.com, Example Corp, Marketing Director
2. Jane Smith, jane@example.com, Tech Solutions, CEO
3. Bob Johnson, bob@example.com, Startup Inc, CTO

Use this personalization for each:
- John: 'I saw your recent blog post about email marketing'
- Jane: 'Congratulations on your recent funding round'
- Bob: 'Your product launch looked impressive'"

Gestión de Campañas

"Pause campaign 12345 and show me its performance statistics"
"Update campaign 'Product Demo Outreach' to send only 15 prospects per day"
"Add a follow-up email to campaign 12345 that sends 3 days after the first email"

Analítica e Informes

"Show me statistics for all my running campaigns"
"Which campaign has the highest open rate?"
"Create a summary report of my campaign performance this month"

Mejores Prácticas

Gestión de Campañas

Empieza Pequeño: Prueba con 5-10 prospectos antes de escalar
Monitorea el Rendimiento: Revisa las estadísticas regularmente
Respeta los Límites: Mantente dentro de los límites diarios de inscripción
Pruebas A/B: Usa múltiples versiones de correo para optimizar

Datos de Prospectos

Calidad de Datos: Asegúrate de que las direcciones de correo sean válidas
Personalización: Usa fragmentos significativos y campos personalizados
Segmentación: Organiza prospectos con etiquetas e industrias
Cumplimiento: Incluye enlaces de cancelación de suscripción y respeta las exclusiones

Interacciones con el Agente de IA

Sé Específico: Proporciona instrucciones claras para la creación de campañas
Verifica Resultados: Comprueba los detalles de la campaña antes de ejecutarla
Usa Ejemplos: Incluye contenido de muestra y personalización
Monitorea la Automatización: Revisa las campañas generadas por IA antes de su implementación

Soporte

Contacta al Equipo de Soporte de Woodpecker en Soporte de Woodpecker

Licencia

Se concede permiso para usar esta imagen Docker con fines personales y comerciales. Se prohíben la redistribución, modificación e ingeniería inversa. No se proporciona ninguna garantía.

Herramientas Disponibles

Gestión de Campañas

`createCampaign`

Crea campañas con configuración básica, incluyendo asuntos, mensajes y ajustes de entrega. Soporta plantillas completas con fragmentos, alternativas y spintax para contenido personalizado.

Parámetros:

name (cadena): Nombre de la campaña
subjects (matriz): Líneas de asunto del correo
messages (matriz): Contenido del cuerpo del correo
emailAccountIds (matriz): IDs de cuentas SMTP
timezone (cadena): Zona horaria de la campaña
dailyEnroll (número): Límite diario de inscripción de prospectos
deliveryDays (matriz): Días de la semana para el envío
deliveryTimeStart/Stop (cadena): Ventana de tiempo de envío
trackOpens (booleano): Habilitar seguimiento de aperturas

`createAdvancedCampaign`

Crea campañas con capacidades API completas, incluyendo pruebas A/B y horarios de entrega complejos.

Parámetros:

campaignPayload (cadena): Configuración completa de la campaña en JSON

`listCampaigns`

Recupera campañas con filtrado opcional por estado.

Parámetros:

pageNumber (número): Número de página (basado en 1)
statuses (matriz): Filtrar por estado (RUNNING, DRAFT, PAUSED, STOPPED, COMPLETED)

`retrieveCampaignDetails`

Obtén la estructura detallada de la campaña, incluyendo todos los pasos y configuraciones.

Parámetros:

campaignId (número): ID de la campaña

`retrieveCampaignStatistics`

Obtén métricas de rendimiento y analítica de la campaña.

Parámetros:

campaignId (número): ID de la campaña

`updateCampaignSettings`

Modifica ajustes generales de la campaña, incluyendo nombre, cuentas de correo, límites diarios y zona horaria.

Parámetros:

campaignId (número): ID de la campaña
name (cadena): Nombre de la campaña
emailAccountIds (matriz): Lista de IDs de cuentas de correo
timezone (cadena): Zona horaria de la campaña
dailyEnroll (número): Límite diario de inscripción

`buildCampaignUrl`

Genera la URL de la aplicación Woodpecker para acceder a la campaña.

Parámetros:

campaignId (número): ID de la campaña

Control de Campañas

runCampaign(campaignId): Iniciar la ejecución de la campaña
pauseCampaign(campaignId): Pausar la campaña
stopCampaign(campaignId): Detener la campaña
deleteCampaign(campaignId): Eliminar la campaña por completo
makeCampaignEditable(campaignId): Habilitar modificaciones de la campaña

Gestión de Pasos de Correo

`addStep`

Añade pasos de seguimiento a campañas existentes.

Parámetros:

campaignId (número): ID de la campaña
payload (cadena): Configuración del paso en JSON

`updateCampaignStep`

Modifica los tiempos de entrega y la programación de los pasos.

Parámetros:

campaignId (número): ID de la campaña
stepId (cadena): ID del paso
payload (cadena): Configuración de entrega actualizada

`updateStepVersion`

Actualiza el contenido del correo, líneas de asunto, firmas y ajustes de seguimiento.

Parámetros:

campaignId (número): ID de la campaña
stepId (cadena): ID del paso
versionId (cadena): ID de la versión
subject (cadena): Asunto del correo
message (cadena): Cuerpo del correo (soporta HTML)
signature (cadena): SENDER o NO_SIGNATURE
trackOpens (booleano): Habilitar seguimiento de aperturas

`deleteCampaignStep`

Elimina pasos de las campañas.

Parámetros:

campaignId (número): ID de la campaña
stepId (cadena): ID del paso

Operaciones con Prospectos

`addProspectsToDatabase`

Añade nuevos prospectos a tu lista global de prospectos sin inscribirlos en ninguna campaña.

Parámetros:

prospectsPayload (cadena): Matriz JSON de datos de prospectos

Notas:

Los prospectos se añaden a tu cuenta pero no a ninguna campaña
Disponibles para futura inscripción en campañas
Útil para construir una base de datos de prospectos antes de crear campañas

`addProspectsToCampaign`

Añade prospectos en masa con información de contacto completa y fragmentos personalizados.

Parámetros:

campaignId (número): ID de la campaña
prospectsPayload (cadena): Matriz de objetos de prospectos

Nota: Siempre verifica los prospectos DUPLICATE en la respuesta. Usa updateProspectsInCampaign para duplicados si se necesitan actualizaciones de datos.

`updateProspectsInDatabase`

Actualiza prospectos existentes en tu base de datos global o añade nuevos si no existen.

Parámetros:

prospectsPayload (cadena): Matriz JSON de datos de prospectos con actualizaciones

Notas:

Los prospectos existentes se actualizan según la dirección de correo
Se añaden nuevos prospectos si el correo no existe
Solo incluye los campos que deseas actualizar
Las actualizaciones se aplican globalmente (afecta a todas las campañas que usan estos prospectos)

`updateProspectsInCampaign`

Actualiza datos de prospectos existentes (requiere solicitud explícita del usuario).

Parámetros:

campaignId (número): ID de la campaña
prospectsPayload (cadena): Matriz de objetos de prospectos con actualizaciones

`listProspectsInDatabase`

Lista prospectos de tu base de datos global de prospectos (no vinculada a ninguna campaña específica).

Parámetros:

pageNumber (entero): Número de página (indexación basada en 1)

Notas:

Devuelve resultados paginados de todos los prospectos en tu cuenta
Estos prospectos pueden añadirse a cualquier campaña
Útil para gestionar tu base de datos general de prospectos

`listProspectsInCampaign`

Recuperación paginada de prospectos de campaña.

Parámetros:

campaignId (número): ID de la campaña
pageNumber (número): Número de página (basado en 1)

`searchProspects`

Busca prospectos que coincidan con criterios específicos en toda tu base de datos.

Parámetros:

pageNumber (entero): Número de página (indexación basada en 1)
searchCriteria (objeto, opcional): Objeto JSON con parámetros de búsqueda
filterCriteria (objeto, opcional): Objeto JSON con filtros adicionales

Campos de búsqueda disponibles:

email - Dirección de correo
first_name - Nombre
last_name - Apellido
company - Nombre de la empresa
organization_id - ID de la organización
industry - Industria
website - URL del sitio web
tags - Etiquetas (sensibles a mayúsculas, sin # inicial)
title - Cargo
phone - Número de teléfono
address - Dirección postal
city - Ciudad
state - Estado/Provincia
country - País
snippet1 hasta snippet15 - Campos personalizados

Campos de filtro disponibles:

id - Lista separada por comas de IDs de prospectos
status - Estado global del prospecto: ACTIVE, BOUNCED, REPLIED, BLACKLIST, INVALID
campaigns_id - Lista separada por comas de IDs de campañas en las que están inscritos los prospectos
contacted - Si un prospecto ha sido contactado alguna vez
interested - Nivel de interés: INTERESTED, MAYBE-LATER, NOT-INTERESTED, NOT-MARKED

Notas:

La búsqueda por etiquetas es sensible a mayúsculas, no uses # inicial al buscar por etiquetas
Los criterios de búsqueda usan OR para el mismo campo, AND para campos diferentes
Para filtrar prospectos OPT-OUT, usa el estado "BLACKLIST"
Los múltiples valores de filtro están separados por comas

`deleteProspects`

Elimina permanentemente prospectos de tu base de datos y/o campañas específicas. Parámetros:

prospectIds (string): Lista separada por comas de IDs de prospectos a eliminar
campaignIds (string, opcional): Lista separada por comas de IDs de campañas de las cuales eliminar prospectos

Notas:

Sin campaignIds: Elimina prospectos globalmente de toda tu base de datos
Con campaignIds: Elimina prospectos solo de las campañas especificadas
Esta acción es permanente y no se puede deshacer
Requiere confirmación explícita del usuario antes de ejecutarse
Usa IDs de prospectos (no direcciones de correo) obtenidos de operaciones de listado/búsqueda

Advertencia: La eliminación global elimina prospectos de todas las campañas y de tu base de datos. La eliminación local (con campaignIds) solo los elimina de las campañas especificadas, manteniéndolos en tu base de datos global.

Gestión de Cuentas

`listMailboxes`

Recupera las cuentas de correo disponibles para la asignación de campañas.

Parámetros: Ninguno

Registro de Cambios

v0.0.9 (2025-07-28)

Mejoras internas y correcciones de errores

v0.0.8 (2025-06-24)

Se añadieron herramientas de listado global de prospectos

v0.0.7 (2025-06-11)

Lanzamiento inicial con herramientas relacionadas con campañas

Documentación

Woodpecker API: https://developers.woodpecker.co/docs/
MCP Protocol: https://modelcontextprotocol.io
Claude Desktop: https://claude.ai/download