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

Related MCP server: MCP Personal Assistant Agent

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

npm install

Edificio

Para compilar código TypeScript:

npm run build

Ejecutando en modo de desarrollo

Para desarrollo con recarga automática:

npm run dev

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:

npm start

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:
node --version
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" } } } }
Asegúrese de reemplazar 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 });