MCP-Integration
Model Context Protocol für KI-Assistenten
Model Context Protocol (MCP) ist ein offener Standard von Anthropic, der KI-Assistenten (wie Claude, Cursor, VS Code Copilot) die Integration mit externen Tools und Datenquellen ermöglicht.
So funktioniert es
Der KI-Assistent kommuniziert mit dem MCP-Server über das STDIO-Protokoll, und der MCP-Server führt Operationen auf NetSendo über die REST API v1 aus.
┌─────────────────┐ STDIO ┌─────────────────┐ HTTP/S ┌─────────────────┐ │ Claude/Cursor │ ◄──────────► │ MCP Server │ ◄───────────► │ NetSendo │ │ (AI Client) │ │ (Docker/npx) │ │ (Your inst.) │ └─────────────────┘ └─────────────────┘ └─────────────────┘
Installation
Voraussetzungen
- Node.js 18+
- API-Schlüssel von NetSendo
Schritte
- API-Schlüssel generieren: Einstellungen → API-Schlüssel
- Node.js von nodejs.org installieren
- KI-Tool mit der folgenden Konfiguration einrichten
{
"mcpServers": {
"netsendo": {
"command": "npx",
"args": [
"-y",
"@netsendo/mcp-client",
"--url",
"https://your-domain.com",
"--api-key",
"YOUR_API_KEY"
]
}
}
}Ersetze https://your-domain.com durch deine NetSendo-URL und YOUR_API_KEY durch deinen API-Schlüssel.
Speicherorte der Konfigurationsdateien
| Client | Dateipfad |
|---|---|
| Claude Desktop (macOS) | ~/Library/Application Support/Claude/claude_desktop_config.json |
| Claude Desktop (Windows) | %APPDATA%\Claude\claude_desktop_config.json |
| Cursor IDE | Einstellungen → MCP → Server hinzufügen |
| VS Code | .vscode/mcp.json |
Unterstützte KI-Clients
Offizielle Claude Desktop-App von Anthropic
IDE mit integrierter KI für Entwickler
Visual Studio Code mit MCP-Erweiterung
Verfügbare Funktionen
Abonnenten
Kontakte verwalten – hinzufügen, bearbeiten, löschen
Kontaktlisten
Mailinglisten durchsuchen und organisieren
E-Mail-Nachrichten
Personalisierte E-Mails versenden
SMS-Nachrichten
SMS an Kontakte senden
Tags
Abonnenten mit Tags kategorisieren
Statistiken
Konto- und Zustellstatistiken prüfen
Verfügbare Tools
Abonnentenverwaltung
| Tool | Beschreibung |
|---|---|
| list_subscribers | Abonnenten mit Filter und Pagination auflisten |
| get_subscriber | Abonnent nach ID oder E-Mail abrufen |
| create_subscriber | Neuen Abonnenten erstellen |
| update_subscriber | Abonnentendaten aktualisieren |
| delete_subscriber | Abonnent löschen |
| sync_subscriber_tags | Abonnenten-Tags synchronisieren |
Kontaktlisten & Tags
| Tool | Beschreibung |
|---|---|
| list_contact_lists | Alle Kontaktlisten abrufen |
| get_contact_list | Listendetails abrufen |
| get_list_subscribers | Abonnenten einer Liste abrufen |
| list_tags | Alle verfügbaren Tags abrufen |
| list_custom_fields | Benutzerdefinierte Felddefinitionen abrufen |
Nachrichten
| Tool | Beschreibung |
|---|---|
| list_mailboxes | Verfügbare Postfächer abrufen |
| send_email | E-Mail an Abonnent senden |
| get_email_status | E-Mail-Zustellungsstatus prüfen |
| list_sms_providers | Verfügbare SMS-Anbieter abrufen |
| send_sms | SMS senden |
| get_sms_status | SMS-Zustellungsstatus prüfen |
Konto
| Tool | Beschreibung |
|---|---|
| test_connection | API-Verbindung testen |
| get_account_info | Kontoinformationen abrufen |
Beispielanfragen
Sicherheit
Fehlerbehebung
- Stelle sicher, dass NetSendo läuft und erreichbar ist
- Prüfe, ob der API-Schlüssel gültig ist
- Überprüfe die URL (inkl. https://)
Starte dein KI-Tool nach Konfigurationsänderungen neu.
Installiere Node.js von nodejs.org (enthält npm/npx).
Mehrere NetSendo-Instanzen
Du kannst dich mit mehreren NetSendo-Instanzen verbinden, indem du verschiedene Servernamen verwendest:
{
"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"]
}
}
}