🌐 ITENFRESDE

Wie Sie Hermes Agent mit Ihrem CRM Integrieren: Praktischer Leitfaden zu den MCP-APIs

· Hermes Agent Experts

Wie Sie Hermes Agent mit Ihrem CRM Integrieren: Praktischer Leitfaden zu den MCP-APIs

Einer der Hauptgründe, warum Unternehmen sich für Hermes Agent entscheiden, ist die Möglichkeit, ihn mit den Systemen zu verbinden, die sie bereits nutzen — und das CRM steht fast immer an erster Stelle. Ob Sie HubSpot, Salesforce, Zoho CRM oder eine eigene Lösung einsetzen: Das Model Context Protocol (MCP) von Hermes Agent schafft eine bidirektionale Brücke zwischen Ihrem KI-Agenten und Ihren Geschäftsdaten.

In diesem Leitfaden erfahren Sie, wie MCP funktioniert, wie Sie einen Connector für Ihr CRM konfigurieren und welche Aufgaben Sie sofort automatisieren können.

Was ist MCP (Model Context Protocol)

Das Model Context Protocol ist ein offener Standard, der von Nous Research entwickelt wurde und Hermes Agent die strukturierte und sichere Kommunikation mit externen Tools ermöglicht. Stellen Sie sich MCP als „USB-C für KI-Agenten” vor: eine universelle Schnittstelle, die jedes Tool implementieren kann, um Teil des Ökosystems Ihres Agenten zu werden.

MCP arbeitet mit drei Kernkomponenten:

  • MCP-Server: Ein Prozess, der Funktionen (Datenbankabfragen, E-Mail-Versand, CRM-Abfragen) über eine standardisierte Schnittstelle bereitstellt
  • MCP-Client: Hermes Agent selbst, der sich mit dem Server verbindet und dessen Funktionen aufruft
  • Skills: Python-Module, die der Agent nutzt, um MCP-Funktionen zu komplexen Workflows zu orchestrieren

Wenn Hermes Agent mit Ihrem CRM interagieren muss, läuft die Kommunikation wie folgt ab:

  1. Der Agent empfängt einen Befehl in natürlicher Sprache (z. B. „Finde den Kontakt Hans Müller und aktualisiere seine Telefonnummer”)
  2. Er identifiziert, welcher Skill und welcher MCP-Server für die Operation benötigt werden
  3. Er sendet eine strukturierte Anfrage an den MCP-Server des CRMs
  4. Der MCP-Server führt die Operation im CRM aus und gibt das Ergebnis zurück
  5. Der Agent verarbeitet die Antwort und präsentiert sie dem Benutzer

Dies alles geschieht in Echtzeit, ohne dass der Benutzer für jede Operation eine einzige Zeile Code schreiben muss.

Warum Hermes Agent mit Ihrem CRM Integrieren

Das CRM ist das operative Herz vieler KMU: Es enthält Kontakte, Opportunities, Kommunikationsverlauf, Rechnungen und geplante Aktivitäten. Die Integration von Hermes Agent mit Ihrem CRM gibt dem Agenten die Fähigkeit:

  • Kontakte zu suchen und zu aktualisieren, ohne das CRM manuell öffnen zu müssen
  • Notizen und Aktivitäten zu erfassen nach jeder Kundeninteraktion
  • Leads automatisch zu qualifizieren basierend auf vordefinierten Kriterien
  • Berichte zu erstellen über die Vertriebspipeline und die Vertriebsleistung
  • E-Mails zu senden und Erinnerungen zu planen direkt aus dem CRM

Für einen Vertriebsmitarbeiter, der die Hälfte seiner Arbeitszeit im CRM verbringt, kann die Automatisierung durch Hermes Agent wertvolle Stunden pro Woche freisetzen.

Schritt-für-Schritt-Einrichtung: Hermes Agent mit Ihrem CRM Verbinden

Voraussetzungen

Bevor Sie beginnen, stellen Sie sicher, dass Sie Folgendes haben:

  • Hermes Agent installiert und funktionsfähig (Version 0.4 oder höher)
  • Zugriff auf die API Ihres CRMs (API-Schlüssel oder OAuth)
  • Python 3.10+ mit den Paketen requests und mcp
  • Einen laufenden MCP-Server (lokal oder in Ihrem internen Netzwerk)

Schritt 1: Einen MCP-Server Installieren

Der MCP-Server ist die Komponente, die die Brücke zwischen Hermes Agent und Ihrem CRM bildet. Sie können einen generischen MCP-Server installieren und spezifische Connectors für Ihr CRM konfigurieren.

# Installieren Sie das MCP-Server-Paket
pip install mcp-server

# Erstellen Sie einen neuen MCP-Server für das CRM
mcp-server init crm-connector
cd crm-connector

Der Befehl mcp-server init erstellt die grundlegende Serverstruktur mit einer Konfigurationsdatei und einem Grundgerüst für die Tools, die Sie bereitstellen werden.

Schritt 2: CRM-Zugangsdaten Konfigurieren

Jedes CRM stellt seine API mit unterschiedlichen Authentifizierungsmethoden zur Verfügung. Hier erfahren Sie, wie Sie die gängigsten konfigurieren:

HubSpot: Verwendet ein Private-App-Token (oder OAuth für komplexere Integrationen). Generieren Sie ein Token in Ihrem HubSpot-Konto unter Einstellungen → Integrationen → Private Apps.

# In der .env-Datei des MCP-Servers
HUBSPOT_API_TOKEN=pat-xxxxxx-xxxxxx-xxxxxx
HUBSPOT_BASE_URL=https://api.hubapi.com

Salesforce: Erfordert OAuth 2.0 mit Client-ID, Client-Secret und Security-Token. Sie erhalten die Zugangsdaten im Abschnitt App-Manager Ihres Salesforce-Kontos.

SALESFORCE_CLIENT_ID=your_client_id
SALESFORCE_CLIENT_SECRET=your_client_secret
SALESFORCE_USERNAME=[email protected]
SALESFORCE_SECURITY_TOKEN=your_security_token

Zoho CRM: Verwendet eine Client-ID und ein Grant-Token aus der Zoho Developer Console. Der OAuth-Ablauf erfordert ein Refresh-Token, das Sie einmalig generieren können.

ZOHO_CLIENT_ID=your_client_id
ZOHO_GRANT_TOKEN=your_grant_token
ZOHO_REFRESH_TOKEN=your_refresh_token
ZOHO_BASE_URL=https://www.zohoapis.eu/crm

Schritt 3: MCP-Tools für das CRM Definieren

„Tools” sind die spezifischen Operationen, die Hermes Agent im CRM aufrufen kann. Hier ist ein Beispiel für die Konfiguration mit HubSpot:

# tools/crm_tools.py
from mcp.server import Tool

class SearchContact(Tool):
    """Sucht einen Kontakt im CRM nach Name, E-Mail oder Telefon."""
    name = "crm_search_contact"
    parameters = {
        "query": {"type": "string", "description": "Name, E-Mail oder Telefon des Kontakts"},
        "limit": {"type": "integer", "description": "Maximale Anzahl der Ergebnisse", "default": 5}
    }
    
    def execute(self, query: str, limit: int = 5):
        # HubSpot-API-Aufruf
        response = requests.get(
            f"{HUBSPOT_BASE_URL}/crm/v3/objects/contacts/search",
            headers={"Authorization": f"Bearer {HUBSPOT_API_TOKEN}"},
            json={"query": query, "limit": limit}
        )
        return response.json()

class CreateNote(Tool):
    """Fügt einem Kontakt oder einer Opportunity eine Notiz hinzu."""
    name = "crm_create_note"
    parameters = {
        "object_type": {"type": "string", "description": "Objekttyp: contact, deal, company"},
        "object_id": {"type": "string", "description": "Objekt-ID"},
        "content": {"type": "string", "description": "Notiztext"}
    }
    
    def execute(self, object_type: str, object_id: str, content: str):
        # API-Aufruf zum Erstellen einer Notiz
        ...

Schritt 4: MCP-Server Starten und Hermes Agent Verbinden

Sobald die Tools konfiguriert sind, starten Sie den MCP-Server:

python mcp_server.py --port 8080

Konfigurieren Sie dann Hermes Agent, um diesen Server zu verwenden. Fügen Sie den Server zur Konfigurationsdatei von Hermes Agent hinzu (~/.hermes/config.yaml):

mcp_servers:
  crm:
    transport: http
    url: http://localhost:8080/mcp
    timeout: 30
    retry: 3

Starten Sie Hermes Agent neu und überprüfen Sie die Verbindung:

hermes mcp status
# Ausgabe: crm (http://localhost:8080) — verbunden

Schritt 5: Eine CRM-Skill Erstellen

Nachdem die Verbindung hergestellt ist, erstellen Sie einen Skill, den Hermes Agent für die Interaktion mit dem CRM verwendet:

# skills/crm_assistant.py
from hermes.skill import Skill

class CRMAssistant(Skill):
    name = "crm-assistant"
    description = "CRM-Assistent: Kontakte suchen, Notizen erstellen, Opportunities aktualisieren"
    
    async def run(self, context):
        # Beispiel: Der Benutzer sagt „füge eine Notiz zum Kontakt Hans Müller hinzu"
        if "notiz hinzufügen" in context.query.lower():
            # 1. Kontakt über MCP suchen
            contact = await context.mcp.crm_search_contact(
                query=context.extract_name(),
                limit=1
            )
            # 2. Notiz über MCP erstellen
            result = await context.mcp.crm_create_note(
                object_type="contact",
                object_id=contact["id"],
                content=context.extract_note_text()
            )
            return f"Notiz zu {contact['name']} hinzugefügt"

Automatisierbare Aufgaben mit Hermes Agent + CRM

Sobald die Integration abgeschlossen ist, können Sie folgende Aufgaben automatisieren:

Kontaktsuche und -anreicherung

  • Suchen Sie einen Kontakt innerhalb von Sekunden nach Name, E-Mail oder Telefon
  • Aktualisieren Sie Profilfelder mit Informationen aus anderen Quellen (E-Mail, LinkedIn, Webformulare)
  • Führen Sie Duplikate automatisch basierend auf vordefinierten Regeln zusammen

Opportunity- und Pipeline-Management

  • Verschieben Sie Opportunities automatisch zwischen Pipeline-Phasen basierend auf Triggern (E-Mail geöffnet, Demo durchgeführt, Vertrag unterschrieben)
  • Berechnen Sie den gewichteten Wert laufender Verhandlungen
  • Benachrichtigen Sie Vertriebsmitarbeiter, wenn eine Opportunity Aufmerksamkeit erfordert

Kommunikationsautomatisierung

  • Senden Sie automatische Folge-E-Mails nach einer Demo
  • Erstellen Sie Aufgaben und Erinnerungen für Ihr Vertriebsteam
  • Erfassen Sie den Kommunikationsverlauf im CRM ohne manuelle Eingabe

Berichtswesen

  • Erstellen Sie wöchentliche Berichte zur Vertriebsleistung
  • Berechnen Sie Konversionsraten pro Pipeline-Phase
  • Identifizieren Sie „heiße” Leads, die sofortigen Kontakt benötigen

Fallstudien

Fallstudie 1: Marketingagentur — Berlin, 12 Mitarbeiter

Eine Marketingagentur mit 12 Mitarbeitern nutzte HubSpot zur Verwaltung von über 500 aktiven Kontakten. Die Vertriebsmitarbeiter verbrachten täglich durchschnittlich 45 Minuten damit, das CRM nach jedem Anruf oder jeder E-Mail manuell zu aktualisieren. Mit Hermes Agent, integriert über MCP, automatisierten sie die Notizerfassung und die Aufgabenerstellung. Ergebnis: 3 Stunden eingesparte Zeit pro Woche und Vertriebsmitarbeiter, CRM-Daten in Echtzeit aktualisiert.

Fallstudie 2: Unternehmensberatung — München, 25 Mitarbeiter

Eine Unternehmensberatung mit 25 Fachleuten nutzte Salesforce zur Nachverfolgung von über 200 offenen Opportunities. Die Herausforderung war die Lead-Qualifizierung: Vertriebsmitarbeiter verschwendeten Zeit mit Kontakten, die noch nicht kaufbereit waren. Mit Hermes Agent entwickelten sie ein automatisches Lead-Scoring-System — der Agent analysiert Interaktionen (E-Mail, Website, Anrufe) und bewertet jeden Lead, wobei hoch bewertete Leads automatisch in „priorisiertes Follow-up” verschoben werden.

Fallstudie 3: Wirtschaftsberatung — Hamburg, 6 Mitarbeiter

Eine Wirtschaftsberatung mit 6 Beratern nutzte Zoho CRM für das Kundenmanagement. Jeder Berater musste nach jedem Kundentermin manuell die CRM-Felder ausfüllen. Sie konfigurierten Hermes Agent so, dass er Meetings (über lokale automatische Transkription) mithört und die CRM-Felder eigenständig befüllt. Ergebnis: Aktualisierungszeit um 70 % reduziert.

FAQ

Was genau ist MCP und warum sollte ich es verwenden?

MCP (Model Context Protocol) ist ein Standardprotokoll, das es Hermes Agent ermöglicht, mit externen Tools wie CRMs, Datenbanken und APIs zu interagieren. Sie nutzen es, weil es die Notwendigkeit eliminiert, für jede Integration eigenen Code zu schreiben — Sie definieren die Tools einmal, und der Agent verwendet sie autonom.

Muss ich Code schreiben, um das CRM zu integrieren?

Teilweise ja, aber Sie müssen kein professioneller Entwickler sein. Die grundlegende Einrichtung erfordert das Definieren von MCP-Tools in Python mit einer klaren, gut dokumentierten Struktur. Wenn Sie dies lieber Experten überlassen möchten, bietet Studio Synapse einen kompletten Integrationsservice an.

Welche CRMs werden unterstützt?

Hermes Agent kann mit jedem CRM verbunden werden, das eine REST-API bereitstellt. Die gängigsten sind HubSpot, Salesforce, Zoho CRM, Pipedrive, Monday.com und Odoo. Für CRMs ohne öffentliche APIs ist es möglich, Connectors über die Datenbankebene oder durch Datenexport/-import zu erstellen.

Wie lange dauert die Integration?

Eine Basisintegration mit einem gängigen CRM dauert zwischen 2 und 5 Arbeitstagen. Die Einrichtung des MCP-Servers ist schnell (ca. 1 Tag), während die Erstellung benutzerdefinierter Skills je nach Komplexität der zu automatisierenden Workflows mehr Zeit in Anspruch nimmt.

Ist MCP sicher für Unternehmensdaten?

Ja. MCP arbeitet vollständig innerhalb Ihres Netzwerks. Der MCP-Server verbindet sich mit Ihren CRM-APIs unter Verwendung Ihrer eigenen Zugangsdaten, aber die Daten verlassen niemals Ihre Infrastruktur. Alle Kommunikationen zwischen Hermes Agent und dem MCP-Server sind verschlüsselt. Sie können sogar alles auf localhost ausführen, um maximale Sicherheit zu gewährleisten.

Kann ich mehrere CRMs mit demselben Hermes Agent verbinden?

Ja. Sie können mehrere MCP-Server konfigurieren, einen für jedes CRM, und Hermes Agent wird sie je nach Kontext der Anfrage alle nutzen. Jeder MCP-Server muss auf einem anderen Port laufen und separat in ~/.hermes/config.yaml konfiguriert werden.

Funktioniert die Integration auch ohne Internetzugang?

Wenn Ihr CRM on-premise betrieben wird (z. B. Odoo, SuiteCRM, SugarCRM) und der MCP-Server sich im selben Netzwerk befindet, funktioniert die Integration auch ohne Internetverbindung. Für Cloud-CRMs (HubSpot, Salesforce) ist eine Internetverbindung zu deren Servern erforderlich.

Fazit

Die Integration von Hermes Agent mit Ihrem CRM über MCP ist eine der effektivsten Methoden, um die Produktivität Ihres Vertriebsteams zu steigern. Die anfängliche Investition in die Einrichtung amortisiert sich innerhalb weniger Wochen durch die Automatisierung wiederkehrender Aufgaben, die derzeit wertvolle Stunden pro Tag beanspruchen.

Ob Sie HubSpot, Salesforce, Zoho oder ein individuelles CRM verwenden — Hermes Agent kann sich verbinden und zu Ihrem persönlichen CRM-Assistenten werden: Kontakte suchen, Opportunities aktualisieren, Aktivitäten erfassen und jede Interaktion mit Ihren Kunden nachverfolgen.

Bereit, Hermes Agent mit Ihrem CRM zu integrieren? Kontaktieren Sie uns für eine kostenlose Beratung — wir analysieren Ihren Tech-Stack, konfigurieren den MCP-Connector und zeigen Ihnen, was der Agent mit Ihren Daten leisten kann.

Schreiben Sie an [email protected]

Richiedi una consulenza gratuita →

← Torna al blog