MCP mit Claude Desktop
Verwalten Sie Ihre dalvon-Agenten, Anrufe, Kontakte und mehr direkt aus Claude Desktop — per natürlicher Sprache, ohne manuell im Dashboard zu navigieren.
Was ist MCP?
Das Model Context Protocol (MCP) ist ein offener Standard, der es Claude ermöglicht, mit externen Diensten zu kommunizieren. Der dalvon MCP-Server stellt Claude Tools für alle wichtigen Plattformfunktionen bereit:
- Agenten erstellen, bearbeiten und veröffentlichen
- Anrufe starten und Anrufdetails abrufen
- Kontakte anlegen und verwalten
- Kampagnen steuern
- Wissensdatenbanken und Dokumente verwalten
- Telefonnummern und Stimmen konfigurieren
Voraussetzungen
- Node.js v18 oder höher — prüfen Sie mit
node --version - Claude Desktop — herunterladen
- API-Schlüssel aus dem dalvon Dashboard (Einstellungen → API-Schlüssel)
Schritt 1: Claude Desktop konfigurieren
Öffnen Sie die Claude Desktop Konfigurationsdatei:
| Betriebssystem | Pfad |
|---|---|
| Windows | %APPDATA%\Claude\claude_desktop_config.json |
| macOS | ~/Library/Application Support/Claude/claude_desktop_config.json |
| Linux | ~/.config/Claude/claude_desktop_config.json |
Fügen Sie folgenden Eintrag in den mcpServers-Block ein (Datei ggf. anlegen, wenn sie noch nicht existiert):
{
"mcpServers": {
"dalvon": {
"command": "npx",
"args": ["-y", "dalvon-mcp"],
"env": {
"DALVON_API_KEY": "ihr-api-key"
}
}
}
}
Hinweis: Die
-y-Flag sorgt dafür, dassnpxdas Paket beim ersten Start automatisch herunterlädt. Eine manuelle Installation ist nicht erforderlich.
Schritt 2: Claude Desktop neu starten
- Windows: Task Manager → Claude beenden → Neu starten
- macOS: Menüleiste → Beenden (Cmd+Q) → Neu öffnen
- Linux:
killall Claude→ Neu starten
Schritt 3: Verbindung testen
Öffnen Sie einen neuen Chat in Claude Desktop und fragen Sie:
Welche MCP-Server sind verbunden?
Oder direkt:
Liste alle meine Agenten
Claude sollte daraufhin die Tools des dalvon MCP-Servers nutzen und Ihre Agenten-Liste zurückgeben.
Umgebungsvariablen
| Variable | Erforderlich | Beschreibung |
|---|---|---|
DALVON_API_KEY | Ja | Ihr API-Schlüssel aus den dalvon Einstellungen |
TELEFONIEREN_BASE_URL | Nein | API-Basis-URL (Default: https://api.dalvon.ai) |
Ihr Ansprechpartner stellt Ihnen die passende Konfiguration bereit, falls eine abweichende Basis-URL benötigt wird.
Felder, die per MCP gesetzt werden können
Der MCP-Server bildet die API 1:1 ab. Die folgende Tabelle zeigt, welche Agent- und Kontaktfelder per MCP gesetzt werden können und wie sie im UI erscheinen:
Agenten-Felder
| MCP-Parameter | UI-Bezeichnung | Hinweis |
|---|---|---|
name | Agenten-Name | — |
language | Sprache | z.B. de, en |
prompt | Prompt | Vollständiger Text |
llm_model | Sprachmodell | z.B. gpt-4o-mini |
engine_id | Engine | ID der gewünschten Engine |
greeting | Begrüßung | Gesprächseinstieg |
visibility | Sichtbarkeit | private oder organization |
So funktioniert es: Wenn Sie sowohl
engine_idals auch einzelne Felder wiellm_modelsetzen, hat die Engine Vorrang über die Einzelfelder. Setzen Sie daher entweder nur die Engine oder nur einzelne Felder — nicht beides.
Kontakt-Felder
| MCP-Parameter | UI-Bezeichnung | Hinweis |
|---|---|---|
first_name | Vorname | Getrennt von Nachname — kein name-Feld |
last_name | Nachname | Getrennt von Vorname — kein name-Feld |
phone_number | Telefonnummer | Internationales Format, z.B. +491234567890 |
email | — | |
company | Unternehmen | — |
contact_type | Kontakttyp | Steuert u.a. Weiterleitungsverhalten |
Wichtig: Die Kontakt-API kennt kein kombiniertes
name-Feld. Setzen Siefirst_nameundlast_nameimmer getrennt — andernfalls bleiben beide Felder leer.
Beispiele
Agent anlegen
Erstelle einen neuen Agenten namens "Support Bot" mit der Sprache Deutsch
und folgendem Prompt: Du bist ein freundlicher Support-Assistent der Firma Muster GmbH.
Kontakt anlegen
Lege einen neuen Kontakt an: Vorname "Anna", Nachname "Becker", Telefonnummer +49 30 123456
Kampagne starten
Zeige mir alle meine Kampagnen und den Status der letzten
Wissensdatenbank verwalten
Liste alle Wissenssammlungen und zeige mir, welche Dokumente in "Produktinfos" enthalten sind
Fehlerbehebung
”Server disconnected”
- Prüfen Sie die Node-Version:
node --versionmuss v18 oder höher anzeigen - Leeren Sie den npx-Cache:
npx clear-npx-cacheund starten Sie neu - Testen Sie manuell im Terminal:
npx -y dalvon-mcp
”Invalid credentials”
- Prüfen Sie, ob der API-Schlüssel korrekt in der Konfigurationsdatei eingetragen ist
- API-Schlüssel finden Sie unter Einstellungen → API-Schlüssel
Keine Tools sichtbar
- Starten Sie Claude Desktop vollständig neu (Prozess beenden, nicht nur Fenster schließen)
- Prüfen Sie die JSON-Syntax Ihrer Konfigurationsdatei — ein fehlendes Komma reicht, um die Datei ungültig zu machen
Nächste Schritte
- API-Einführung - Direkte REST-API-Nutzung ohne MCP
- Webhooks - Anrufdaten automatisch empfangen
- dalvon-mcp auf npm - Paket-Dokumentation und Changelog