Servidor MCP de Omnisend
Un servidor de Protocolo de Contexto de Modelo (MCP) que se integra con Omnisend API V5, escrito en TypeScript.
Versión: 2.2.0
Características
- Gestión de contactos (listar, crear, obtener, actualizar)
- Gestión de productos (enumerar, crear, obtener, reemplazar, eliminar)
- Seguimiento de eventos
- Gestión de categorías de productos
- Compatibilidad con paginación basada en cursor con URL siguientes/anteriores e información de límite/desplazamiento
Cambios en la versión 2.2.0
- Base de código refactorizada a una estructura más modular
- Se implementaron módulos específicos del dominio (contactos, productos, categorías, eventos)
- Código organizado en directorios lógicos (/tipos, /filtros, /api-resources, /recursos, /herramientas)
- Se hizo dinámica la versión del servidor en la herramienta ping
- Se agregó un mejor manejo de errores en las solicitudes de API
- Mantenibilidad de código mejorada con exportaciones de barril
- Se eliminó el código redundante y duplicado.
Cambios en la versión 2.1.0
- Actualizado a @modelcontextprotocol/sdk v1.11.0
- Manejo de errores mejorado en toda la aplicación
- Estabilidad de API mejorada con mejores mensajes de error
- Se agregó configuración de tiempo de espera de solicitud para evitar conexiones colgadas
- Se solucionaron los problemas de conexión SSE con MCP Inspector
- Salida de consola optimizada para que sea compatible con los clientes MCP
- Se agregó contexto de paginación basado en cursor en las respuestas de MCP (URL siguientes/anteriores, límite/desplazamiento)
Cambios en la versión 2.0.0
- Se migró toda la base de código a TypeScript
- Estructura de recursos MCP actualizada según la última especificación
- Se agregaron declaraciones de tipo adecuadas para todas las respuestas y solicitudes de API
- Manejo de errores mejorado con excepciones tipificadas
- Organización y mantenibilidad de código mejoradas
Instalación
Edificio
Para compilar código TypeScript:
Ejecutando en modo de desarrollo
Para desarrollo con recarga automática:
Configuración
Cree un archivo .env en el directorio raíz con su clave API de Omnisend:
OMNISEND_API_KEY=your_api_key_here
OMNISEND_API_URL=https://api.omnisend.com/v5
Uso
Para iniciar el servidor MCP:
Interactuar con el servidor MCP
El servidor MCP está diseñado para usarse con clientes que comprenden el Protocolo de Contexto de Modelo. Aquí se muestran algunas maneras de interactuar con él:
Integración de VS Code
Para usar con VS Code, se proporciona un archivo de configuración en .vscode/mcp.json . VS Code con la extensión MCP adecuada puede comunicarse con este servidor.
Asistentes de IA
Los asistentes de IA como Claude que admiten MCP pueden comunicarse con este servidor para acceder a los datos de Omnisend y realizar operaciones.
Uso con Claude Desktop
Para utilizar este servidor MCP con Claude Desktop:
- Descargue e instale Claude Desktop desde el sitio web oficial .
- Asegúrate de tener Node.js instalado en tu sistema. Puedes comprobarlo ejecutando:Si Node.js no está instalado, descárguelo desde nodejs.org .
- Abra el menú Claude en su computadora y seleccione "Configuración..."
- Haga clic en "Desarrollador" en la barra izquierda del panel de Configuración y luego haga clic en "Editar configuración".
- Esto abrirá el archivo de configuración de Claude Desktop. Reemplace el contenido del archivo con la siguiente configuración o agréguela:
{
"mcpServers": {
"omnisend": {
"command": "node",
"args": [
"/path/to/dist/index.js"
],
"env": {
"OMNISEND_API_KEY": "your_api_key_here"
}
}
}
}
your_api_key_here con su clave API de Omnisend real. - Guarde el archivo de configuración y reinicie Claude Desktop.
- Después de reiniciar, debería ver un ícono de martillo en la esquina inferior derecha del cuadro de entrada.
- Haga clic en el icono del martillo para ver las herramientas Omnisend disponibles.
- Ahora puedes pedirle a Claude que realice operaciones como:
- "Enumere mis contactos recientes en Omnisend"
- "Crear un nuevo producto en mi catálogo Omnisend"
- Enviar un evento de cliente a Omnisend
Clientes MCP personalizados
Puede desarrollar clientes personalizados utilizando la biblioteca @modelcontextprotocol/sdk :
import { McpClient } from '@modelcontextprotocol/sdk/client/mcp';
import { ProcessClientTransport } from '@modelcontextprotocol/sdk/client/process';
const transport = new ProcessClientTransport(serverProcess);
const client = new McpClient(transport);
// Connect to the server
await client.connect();
// Execute tools
const result = await client.executeTool("listContacts", { limit: 10 });
Documentación de la API
Para obtener más información sobre la API de Omnisend, consulte la documentación oficial .
Licencia
Este proyecto está licenciado bajo la Licencia Apache 2.0: consulte el archivo de LICENCIA para obtener más detalles.