Omnisend MCP Server
Ein Model Context Protocol (MCP)-Server, der in Omnisend API V5 integriert ist und in TypeScript geschrieben ist.
Version: 2.2.0
Merkmale
- Kontaktverwaltung (Auflisten, Erstellen, Abrufen, Aktualisieren)
- Produktverwaltung (Auflisten, Erstellen, Abrufen, Ersetzen, Löschen)
- Ereignisverfolgung
- Produktkategorienverwaltung
- Cursorbasierte Paginierungsunterstützung mit nächsten/vorherigen URLs und Limit-/Offset-Informationen
Änderungen in Version 2.2.0
- Refaktorierte Codebasis mit einer modulareren Struktur
- Implementierte domänenspezifische Module (Kontakte, Produkte, Kategorien, Events)
- Organisierter Code in logischen Verzeichnissen (/types, /filters, /api-resources, /resources, /tools)
- Serverversion im Ping-Tool dynamisch gemacht
- Bessere Fehlerbehandlung bei API-Anfragen hinzugefügt
- Verbesserte Code-Wartbarkeit durch Barrel-Exporte
- Redundanter und doppelter Code entfernt
Änderungen in Version 2.1.0
- Aktualisiert auf @modelcontextprotocol/sdk v1.11.0
- Verbesserte Fehlerbehandlung in der gesamten Anwendung
- Verbesserte API-Stabilität mit besseren Fehlermeldungen
- Konfiguration des Anforderungs-Timeouts hinzugefügt, um hängende Verbindungen zu verhindern
- SSE-Verbindungsprobleme mit MCP Inspector behoben
- Optimierte Konsolenausgabe für Kompatibilität mit MCP-Clients
- Cursorbasierter Paginierungskontext in MCP-Antworten hinzugefügt (nächste/vorherige URLs, Limit/Offset)
Änderungen in Version 2.0.0
- Gesamte Codebasis nach TypeScript migriert
- Aktualisierte MCP-Ressourcenstruktur gemäß der neuesten Spezifikation
- Für alle API-Antworten und -Anfragen wurden korrekte Typdeklarationen hinzugefügt.
- Verbesserte Fehlerbehandlung mit typisierten Ausnahmen
- Verbesserte Code-Organisation und Wartbarkeit
Installation
Gebäude
So kompilieren Sie TypeScript-Code:
Ausführen im Entwicklungsmodus
Für die Entwicklung mit automatischem Neuladen:
Konfiguration
Erstellen Sie im Stammverzeichnis eine .env Datei mit Ihrem Omnisend-API-Schlüssel:
OMNISEND_API_KEY=your_api_key_here
OMNISEND_API_URL=https://api.omnisend.com/v5
Verwendung
So starten Sie den MCP-Server:
Interaktion mit dem MCP-Server
Der MCP-Server ist für die Verwendung mit Clients konzipiert, die das Model Context Protocol verstehen. Sie können folgendermaßen mit ihm interagieren:
VS Code-Integration
Für die Verwendung mit VS Code wird eine Konfigurationsdatei in .vscode/mcp.json bereitgestellt. VS Code mit der entsprechenden MCP-Erweiterung kann mit diesem Server kommunizieren.
KI-Assistenten
KI-Assistenten wie Claude, die MCP unterstützen, können mit diesem Server kommunizieren, um auf Omnisend-Daten zuzugreifen und Vorgänge auszuführen.
Verwendung mit Claude Desktop
So verwenden Sie diesen MCP-Server mit Claude Desktop:
- Laden Sie Claude Desktop von der offiziellen Website herunter und installieren Sie es.
- Stellen Sie sicher, dass Node.js auf Ihrem System installiert ist. Führen Sie dazu Folgendes aus:Wenn Node.js nicht installiert ist, laden Sie es von nodejs.org herunter.
- Öffnen Sie das Claude-Menü auf Ihrem Computer und wählen Sie „Einstellungen…“
- Klicken Sie in der linken Leiste des Einstellungsbereichs auf „Entwickler“ und dann auf „Konfiguration bearbeiten“.
- Dadurch wird Ihre Claude Desktop-Konfigurationsdatei geöffnet. Ersetzen Sie den Dateiinhalt durch die folgende Konfiguration oder fügen Sie sie hinzu:
{
"mcpServers": {
"omnisend": {
"command": "node",
"args": [
"/path/to/dist/index.js"
],
"env": {
"OMNISEND_API_KEY": "your_api_key_here"
}
}
}
}
your_api_key_here durch Ihren tatsächlichen Omnisend-API-Schlüssel ersetzen. - Speichern Sie die Konfigurationsdatei und starten Sie Claude Desktop neu.
- Nach dem Neustart sollte in der unteren rechten Ecke des Eingabefelds ein Hammersymbol angezeigt werden.
- Klicken Sie auf das Hammersymbol, um die verfügbaren Omnisend-Tools anzuzeigen.
- Sie können Claude jetzt bitten, folgende Vorgänge auszuführen:
- „Liste meine letzten Kontakte in Omnisend auf“
- „Erstellen Sie ein neues Produkt in meinem Omnisend-Katalog“
- „Senden Sie ein Kundenereignis an Omnisend“
Benutzerdefinierte MCP-Clients
Sie können benutzerdefinierte Clients mit der Bibliothek @modelcontextprotocol/sdk entwickeln:
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 });
API-Dokumentation
Weitere Informationen zur Omnisend-API finden Sie in der offiziellen Dokumentation .
Lizenz
Dieses Projekt ist unter der Apache-Lizenz 2.0 lizenziert – Einzelheiten finden Sie in der Datei LICENSE .