Integración MCP

Model Context Protocol para Asistentes de IA

Model Context Protocol (MCP) es un estándar abierto introducido por Anthropic que permite a los asistentes de IA (como Claude, Cursor, VS Code Copilot) integrarse con herramientas y fuentes de datos externas.

Hacer preguntas: '¿Cuántos suscriptores tengo?'

Gestionar suscriptores usando lenguaje natural

Enviar mensajes: 'Enviar un correo a jan@example.com'

Obtener estadísticas: 'Analizar la calidad de mi lista'

Cómo Funciona

El asistente de IA se comunica con el servidor MCP a través del protocolo STDIO, y el servidor MCP realiza operaciones en NetSendo usando la API REST v1.

┌─────────────────┐     STDIO      ┌─────────────────┐     HTTP/S     ┌─────────────────┐
│  Claude/Cursor  │ ◄──────────► │   MCP Server    │ ◄───────────► │    NetSendo     │
│   (AI Client)   │               │   (Docker/npx)  │               │  (Your inst.)   │
└─────────────────┘               └─────────────────┘               └─────────────────┘

Instalación

Instalación Remota (npx)

Recomendado

Ideal para NetSendo alojado en un servidor (ej. https://app.miempresa.com)

Requisitos

Node.js 18+
Clave API de NetSendo

Pasos

Generar clave API: Configuración → Claves API
Instalar Node.js desde nodejs.org
Configurar tu herramienta de IA usando la configuración de abajo

{
  "mcpServers": {
    "netsendo": {
      "command": "npx",
      "args": [
        "-y",
        "@netsendo/mcp-client",
        "--url",
        "https://your-domain.com",
        "--api-key",
        "YOUR_API_KEY"
      ]
    }
  }
}

Reemplaza https://your-domain.com con la URL de tu instancia NetSendo y YOUR_API_KEY con tu clave API generada.

Ubicaciones de Archivos de Configuración

Cliente	Ubicación del Archivo
Claude Desktop (macOS)	~/Library/Application Support/Claude/claude_desktop_config.json
Claude Desktop (Windows)	%APPDATA%\Claude\claude_desktop_config.json
Cursor IDE	Configuración → MCP → Añadir Servidor
VS Code	.vscode/mcp.json

Clientes de IA Compatibles

🤖

Claude Desktop

Aplicación de escritorio oficial Claude de Anthropic

💻

Cursor IDE

IDE con IA integrada para desarrolladores

📝

VS Code

Visual Studio Code con extensión MCP

Funciones Disponibles

Suscriptores

Gestionar contactos – añadir, editar, eliminar

Listas de Contactos

Explorar y organizar listas de correo

Mensajes de Email

Enviar mensajes de correo personalizados

Mensajes SMS

Enviar mensajes SMS a contactos

Etiquetas

Categorizar suscriptores usando etiquetas

Estadísticas

Verificar estadísticas de cuenta y entregabilidad

Herramientas Disponibles

Gestión de Suscriptores

Herramienta	Descripción
list_subscribers	Listar suscriptores con filtrado y paginación
get_subscriber	Obtener suscriptor por ID o email
create_subscriber	Crear un nuevo suscriptor
update_subscriber	Actualizar datos del suscriptor
delete_subscriber	Eliminar un suscriptor
sync_subscriber_tags	Sincronizar etiquetas del suscriptor

Listas de Contactos y Etiquetas

Herramienta	Descripción
list_contact_lists	Obtener todas las listas de contactos
get_contact_list	Obtener detalles de la lista
get_list_subscribers	Obtener suscriptores de una lista
list_tags	Obtener todas las etiquetas disponibles
list_custom_fields	Obtener definiciones de campos personalizados

Mensajes

Herramienta	Descripción
list_mailboxes	Obtener buzones disponibles
send_email	Enviar email al suscriptor
get_email_status	Verificar estado de entrega del email
list_sms_providers	Obtener proveedores SMS disponibles
send_sms	Enviar mensaje SMS
get_sms_status	Verificar estado de entrega del SMS

Cuenta

Herramienta	Descripción
test_connection	Probar conexión API
get_account_info	Obtener información de la cuenta

Consultas de Ejemplo

"Mostrar mis listas de correo"

"¿Cuántos suscriptores tengo?"

"Añadir suscriptor jan@example.com a la lista Newsletter"

"Enviar un mensaje de bienvenida a anna@example.com"

"Analizar la calidad de mi lista de correo"

Seguridad

🔐 Las claves API nunca se registran ni se exponen

🔒 Todas las llamadas API respetan los permisos de NetSendo

⚡ Límite de velocidad: 60 solicitudes/minuto

🚫 Los datos sensibles (contraseñas, pagos) nunca se devuelven

📝 Todas las operaciones se registran en el log de actividad

Solución de Problemas

Conexión Fallida

Asegúrate de que NetSendo esté ejecutándose y sea accesible
Verifica que la clave API sea válida
Verifica que la URL sea correcta (incluye https://)

Las Herramientas No Aparecen

Reinicia tu herramienta de IA después de cambios de configuración.

Comando npx No Encontrado

Instala Node.js desde nodejs.org (incluye npm/npx).

Múltiples Instancias de NetSendo

Puedes conectarte a múltiples instancias de NetSendo usando diferentes nombres de servidor:

{
  "mcpServers": {
    "netsendo-production": {
      "command": "npx",
      "args": ["-y", "@netsendo/mcp-client", "--url", "https://app.company.com", "--api-key", "prod-key"]
    },
    "netsendo-staging": {
      "command": "npx",
      "args": ["-y", "@netsendo/mcp-client", "--url", "https://staging.company.com", "--api-key", "staging-key"]
    }
  }
}

Enlaces de Documentación

Documentación Completa de NetSendo MCP Model Context Protocol Paquete npm @netsendo/mcp-client