Volkern MCP-Server (v2.0.0)

MCP-Server (Model Context Protocol) zur Integration von Volkern CRM mit KI-Agenten wie Claude, GPT und anderen MCP-kompatiblen Clients.

Neuheiten v2.0.0 - Vollständiger Vertriebszyklus

Neue Module

• Kontakte: Vollständiges CRUD für Kontakte (Personen und Unternehmen)

• Deals/Pipeline: Erstellen und Auflisten von Deals in der Vertriebspipeline

• Angebote: Erstellen von Angeboten aus Katalogartikeln mit Preisen, Rabatten und Steuern

• Verkaufsaufträge: Auflisten, Abfragen und Umwandeln von Angeboten in Verkaufsaufträge

• Verträge: Umwandeln akzeptierter Angebote in Verträge mit Zahlungsbedingungen

Vollständiger Vertriebsablauf via MCP

1. volkern_create_lead → Lead erfassen

2. volkern_create_deal → Verkaufschance in der Pipeline eröffnen

3. volkern_create_cotizacion → Angebot aus dem Katalog generieren

4. volkern_create_orden_from_cotizacion → In Verkaufsauftrag umwandeln

5. volkern_create_contrato_from_cotizacion → Vertrag formalisieren

Verbesserter Katalog (v1.1.0)

• Benutzerdefinierte Felder: Dynamische Attribute pro Artikel (m², Zimmer, Sprache, etc.)

• Mehrstufige Kategorien: Hierarchische Organisation (Immobilien > Büro > Luxus)

• Etiketten: Tags für schnelles Filtern (VIP, Chance, Neu)

• Mediengalerie: Bilder, Videotouren, technische Dokumente, 360°-Touren

• Flexible Preise: Einmalzahlung, wiederkehrend oder stündlich mit Mengenrabatten

Related MCP server: Customer Support MCP Server

Installation

Option 1: Globale Installation via NPM (Empfohlen)

npm install -g volkern-mcp-server

Option 2: Verwendung von npx (ohne Installation)

npx volkern-mcp-server

Option 3: Aus dem Quellcode

git clone https://github.com/volkern/mcp-server.git
cd mcp-server
npm install
npm run build

Konfiguration

Der Server benötigt die folgenden Umgebungsvariablen:

export VOLKERN_API_KEY="tu_api_key_aqui"
export VOLKERN_API_URL="https://volkern.app/api"  # Opcional, usa este valor por defecto

Verwendung mit Claude Desktop

Fügen Sie die folgende Konfiguration zu Ihrer claude_desktop_config.json Datei hinzu:

Wenn Sie mit NPM installiert haben (Empfohlen)

{
  "mcpServers": {
    "volkern": {
      "command": "volkern-mcp",
      "env": {
        "VOLKERN_API_KEY": "tu_api_key_aqui"
      }
    }
  }
}

Wenn Sie npx verwenden

{
  "mcpServers": {
    "volkern": {
      "command": "npx",
      "args": ["volkern-mcp-server"],
      "env": {
        "VOLKERN_API_KEY": "tu_api_key_aqui"
      }
    }
  }
}

Wenn Sie aus dem Quellcode installiert haben

macOS/Linux:

{
  "mcpServers": {
    "volkern": {
      "command": "node",
      "args": ["/ruta/a/volkern-mcp-server/dist/index.js"],
      "env": {
        "VOLKERN_API_KEY": "tu_api_key_aqui"
      }
    }
  }
}

Windows:

{
  "mcpServers": {
    "volkern": {
      "command": "node",
      "args": ["C:\\ruta\\a\\volkern-mcp-server\\dist\\index.js"],
      "env": {
        "VOLKERN_API_KEY": "tu_api_key_aqui"
      }
    }
  }
}

Verfügbare Tools (35 Tools)

Kontakte

Lead-Management

Termine/Appointments

Dienstleistungen

Aufgaben

Messaging

Interaktionen

Notizen

Deals / Pipeline

Angebote

Verkaufsaufträge

Verträge

Anwendungsbeispiele

Einen Lead erstellen und einen Termin vereinbaren

Usuario: Crea un lead para Juan Pérez, email juan@example.com, y agenda una cita para mañana a las 10am

Agente:
1. volkern_create_lead(nombre: "Juan Pérez", email: "juan@example.com")
2. volkern_check_disponibilidad(fecha: "2026-02-09")
3. volkern_create_cita(leadId: "...", fechaHora: "2026-02-09T10:00:00Z", titulo: "Reunión inicial")

Verfügbarkeit prüfen

Usuario: ¿Qué horarios hay disponibles para el lunes?

Agente:
1. volkern_check_disponibilidad(fecha: "2026-02-10")

Nachverfolgungsaufgabe erstellen

Usuario: Crea un recordatorio para llamar a Juan mañana

Agente:
1. volkern_list_leads(search: "Juan")
2. volkern_create_task(leadId: "...", tipo: "llamada", titulo: "Llamar a Juan", fechaVencimiento: "2026-02-09T09:00:00Z")

Entwicklung

# Ejecutar en modo desarrollo
npm run dev

# Compilar
npm run build

# Ejecutar compilado
npm start

Fehlerbehebung

Fehler: VOLKERN_API_KEY not set

Stellen Sie sicher, dass Sie die Umgebungsvariable konfiguriert haben, bevor Sie den Server starten.

Fehler 401: Nicht autorisiert

Überprüfen Sie, ob Ihr API-Key in Volkern über die erforderlichen Berechtigungen verfügt (Einstellungen → API-Keys).

Fehler 409: Terminüberschneidung

Der angeforderte Slot ist bereits belegt. Prüfen Sie die Verfügbarkeit mit volkern_check_disponibilidad.

Lizenz

MIT