Skip to content

HiWalter MCP-Server

Verbinde Claude, Claude Code und jeden MCP-Client mit HiWalter. Gib deinem KI-Agenten in einem einzigen Tool-Aufruf Live-Zugriff auf Kontakt-Enrichment und Firmen-Identifikation per IP.

Klassische Enrichment-Tools sind formularbasiert und manuell. HiWalter ist Prompt-and-go. Es ist ein MCP, der speziell für KI-Agenten gebaut wurde, sodass dein Agent Kontakte aus LinkedIn anreichern, verifizierte Business-E-Mails holen und per IP die Firma hinter deinem B2B-Traffic identifizieren kann. Alles zugänglich in einem einzigen Tool-Aufruf.

Das Model Context Protocol (MCP) ist ein offener Standard, der KI-Assistenten erlaubt, sich direkt mit externen Tools und Datenquellen zu verbinden, statt sich auf ihre Trainingsdaten zu verlassen.

Der HiWalter MCP-Server gibt jedem kompatiblen KI-Tool direkten Zugriff auf die Enrichment-Funktionen von HiWalter: jeden Endpunkt, jeden Parameter und jedes Response-Schema. So kann dein Agent Kontakte anreichern und die Firma hinter einer IP nachschlagen, ohne die Konversation zu verlassen.

MCP-Server-URL

https://mcp.hiwalter.de/mcp

KI-Modelle werden auf statischen Momentaufnahmen des Internets trainiert. Wenn sie Code für eine API generieren, passiert häufig Folgendes:

  • Sie halluzinieren Endpunkte, die nicht existieren
  • Sie verwenden veraltete Parameternamen
  • Sie geben falsche Response-Strukturen zurück

Mit verbundenem HiWalter MCP-Server:

Ohne MCPMit MCP
KI rät Endpunkt-URLsKI liest die echte API-Referenz
Veraltete ParameternamenImmer aktuelle Parameter-Schemas
Falsche Response-StrukturenKorrekte Response-Strukturen aus der Quelle
Hin und her mit KorrekturenKorrekter Code beim ersten Versuch

Wie du den Connector hinzufügst, hängt von deinem Kontotyp ab. In einem persönlichen Plan fügst du ihn selbst hinzu. In einem Team- oder Enterprise-Plan fügt ein Owner ihn einmal für die gesamte Organisation hinzu, und danach verbindet jedes Mitglied seine eigenen Zugangsdaten.

Persönliches Konto (Free, Pro oder Max)

  1. Gehe in Claude.ai zu Customize, dann Connectors.

  2. Klicke auf +, dann auf Add custom connector.

  3. Füge Folgendes in Remote MCP server URL ein:

    https://mcp.hiwalter.de/mcp
  4. Klicke auf Advanced settings und gib deine HiWalter Connector-Zugangsdaten ein:

    • OAuth Client ID: deine Client ID
    • OAuth Client Secret: dein Client Secret
  5. Klicke auf Add.

Free-Konten sind auf einen einzigen Custom-Connector beschränkt. Pro- und Max-Konten können mehrere hinzufügen.

Team- oder Enterprise-Konto

Nur ein Owner oder Primary Owner kann einer Team- oder Enterprise-Organisation einen Custom-Connector hinzufügen. Nach dem Hinzufügen verbindet sich jedes Mitglied einzeln damit, Claude greift also immer nur auf Daten zu, die das verbindende Mitglied sehen darf. Bevor du beginnst, musst du zuerst den Owner oder Primary Owner deines Claude Team-/Enterprise-Kontos zu HiWalter einladen, da dieser einen HiWalter Nutzer benötigt, um den Verbindungsprozess abzuschließen.

Owner / Primary Owner, füge den Connector für die Organisation hinzu:

  1. Gehe zu Organization settings, dann Connectors.

  2. Klicke auf Add.

  3. Fahre mit der Maus über Custom und wähle dann Web.

  4. Füge Folgendes in Remote MCP server URL ein:

    https://mcp.hiwalter.de/mcp
  5. Klicke auf Advanced settings und gib die HiWalter Connector-Zugangsdaten ein (OAuth Client ID und OAuth Client Secret).

  6. Klicke auf Add.

Jedes Mitglied, verbinde dich damit:

  1. Gehe zu Customize, dann Connectors.
  2. Finde den HiWalter Connector (mit einem Custom-Label markiert).
  3. Klicke auf Connect und schließe die Authentifizierung ab.

Um deine Zugangsdaten zu erhalten, melde dich bei app.hiwalter.de an und gehe zu Connectors, um einen neuen Connector zu erstellen.

Claude Desktop nutzt dieselben Connectors wie dein Claude-Konto, es ist kein Bearbeiten einer Konfigurationsdatei nötig, und ein Connector, den du auf Claude.ai hinzufügst, ist hier bereits verfügbar. Wie du ihn hinzufügst, hängt von deinem Kontotyp ab. In einem persönlichen Plan fügst du ihn selbst hinzu. In einem Team- oder Enterprise-Plan fügt ein Owner ihn einmal für die gesamte Organisation hinzu, und danach verbindet jedes Mitglied seine eigenen Zugangsdaten.

Persönliches Konto (Free, Pro oder Max)

  1. Gehe in Claude Desktop zu Customize, dann Connectors.

  2. Klicke auf +, dann auf Add custom connector.

  3. Füge Folgendes in Remote MCP server URL ein:

    https://mcp.hiwalter.de/mcp
  4. Klicke auf Advanced settings und gib deine HiWalter Connector-Zugangsdaten ein:

    • OAuth Client ID: deine Client ID
    • OAuth Client Secret: dein Client Secret
  5. Klicke auf Add und starte danach Claude Desktop neu, damit der Connector erkannt wird.

Free-Konten sind auf einen einzigen Custom-Connector beschränkt. Pro- und Max-Konten können mehrere hinzufügen.

Team- oder Enterprise-Konto

Nur ein Owner oder Primary Owner kann einer Team- oder Enterprise-Organisation einen Custom-Connector hinzufügen. Nach dem Hinzufügen verbindet sich jedes Mitglied einzeln damit, Claude greift also immer nur auf Daten zu, die das verbindende Mitglied sehen darf.

Owner / Primary Owner, füge den Connector für die Organisation hinzu:

  1. Gehe zu Organization settings, dann Connectors.

  2. Klicke auf Add.

  3. Fahre mit der Maus über Custom und wähle dann Web.

  4. Füge Folgendes in Remote MCP server URL ein:

    https://mcp.hiwalter.de/mcp
  5. Klicke auf Advanced settings und gib die HiWalter Connector-Zugangsdaten ein (OAuth Client ID und OAuth Client Secret).

  6. Klicke auf Add.

Jedes Mitglied, verbinde dich damit:

  1. Gehe in Claude Desktop zu Customize, dann Connectors.
  2. Finde den HiWalter Connector (mit einem Custom-Label markiert).
  3. Klicke auf Connect und schließe die Authentifizierung ab.
  4. Starte Claude Desktop neu, damit der Connector erkannt wird.

Um deine Zugangsdaten zu erhalten, melde dich bei app.hiwalter.de an und gehe zu Connectors, um einen neuen Connector zu erstellen.

Standardmäßig sind alle HiWalter Tools auf Needs Approval gesetzt, Claude fragt dich also bei der ersten Nutzung jedes Tools nach. So aktualisierst du die Berechtigungen im Bulk:

  1. Gehe zu Customize, dann Connectors.
  2. Klicke auf Configure neben dem HiWalter Connector.
  3. Nutze das Bulk-Change-Tool, um alle Tools auf Always Allow zu setzen.

Um bestimmte Tools einzuschränken, setze sie einzeln auf Blocked.

Führe den folgenden Befehl in deinem Terminal aus und ersetze die Platzhalterwerte durch deine Zugangsdaten:

Terminal window
claude mcp add --transport http hiwalter https://mcp.hiwalter.de/mcp \
--client-id YOUR_CLIENT_ID \
--client-secret

Das Flag --client-secret nimmt keinen Wert entgegen, Claude Code fragt dich nach dem Secret (oder liest es aus der Umgebungsvariable MCP_CLIENT_SECRET). Standardmäßig wird der Server im lokalen Scope hinzugefügt (nur aktuelles Projekt). Füge --scope user hinzu, um HiWalter über all deine Projekte hinweg verfügbar zu machen:

Terminal window
claude mcp add --transport http hiwalter https://mcp.hiwalter.de/mcp \
--scope user \
--client-id YOUR_CLIENT_ID \
--client-secret

Claude Code öffnet ein Browser-Fenster und fordert dich auf, den Zugriff auf dem HiWalter Consent-Screen freizugeben. Nach der Freigabe wird dein Token gespeichert und automatisch verwaltet.

Persönliches Konto: der obige Befehl funktioniert unverändert. Team- oder Enterprise-Konto: in Business-Plänen können nur Admins MCP-Server zu Claude Code hinzufügen. Wenn du dich in Claude Code mit deinem Claude.ai-Konto anmeldest, ist jeder dort bereits hinzugefügte HiWalter Connector in Claude Code automatisch verfügbar, es ist also kein claude mcp add nötig.

Um deine Zugangsdaten zu erhalten, melde dich bei app.hiwalter.de an und gehe zu Connectors, um einen neuen Connector zu erstellen.

Sobald du verbunden bist, kannst du mit HiWalter so sprechen, wie du mit einer Kollegin oder einem Kollegen sprechen würdest. Hier sind ein paar Prompts für den Einstieg:

Einen Kontakt aus LinkedIn anreichern

“Reichere dieses LinkedIn-Profil an und gib mir die Business-E-Mail: linkedin.com/in/example”

Die Firma hinter einer IP nachschlagen

“Ich habe eine IP-Adresse aus meinen Website-Logs, 192.0.2.1, welche Firma steckt dahinter?”

Eine Liste im Bulk anreichern

“Hier sind 10 LinkedIn-URLs. Reichere jede für die Business-E-Mail an und gib die Ergebnisse als Tabelle zurück.”

Besuche “I Have X, I Want Y” für weitere Beispiel-Prompts.

E-Mails und Firmendaten liefern wir unbegrenzt aus unserem eigenen, verifizierten Datenbestand, ohne Kosten pro Abfrage. Ein paar Regeln, die der Agent automatisch befolgt:

  • Zählen ist kostenlos. search_linkedin_profile mit count_only: true gibt Trefferzahlen zurück, ohne eine vollständige Suche auszulösen, nutze es, um einen Such-Umfang abzuschätzen, bevor du dich festlegst.
  • Frei abfragbar. get_account, get_billing und get_usage kannst du jederzeit aufrufen, um Plan, Nutzung und deine Fair-Use-Kontingente zu prüfen.

Eine vollständige Aufschlüsselung findest du im Leitfaden zu Rate Limits.

Neu bei der API? Beginne mit Authentication, um deine Keys zu erstellen, und durchstöbere dann die API Reference Overview für jeden Endpunkt, jeden Parameter und jedes Response-Schema, das der MCP bereitstellt.

Verbindung schlägt nach dem Hinzufügen der Konfiguration fehl

Starte dein KI-Tool nach dem Hinzufügen der MCP-Konfiguration neu. Die meisten Clients benötigen einen vollständigen Neustart, um neue MCP-Server zu erkennen. Prüfe, dass die URL exakt so lautet:

https://mcp.hiwalter.de/mcp

Kein abschließender Schrägstrich, keine zusätzlichen Pfadsegmente.

Authentifizierungsfehler (ungültige Zugangsdaten)

Prüfe genau, dass deine Client ID und dein Client Secret korrekt von app.hiwalter.de kopiert wurden, keine zusätzlichen Leerzeichen, keine Kürzung. Falls deine Zugangsdaten kürzlich rotiert oder widerrufen wurden, erstelle einen neuen Connector über die Connectors-Seite und aktualisiere deine Konfiguration mit den neuen Werten. Starte danach dein KI-Tool neu.

Netzwerk- oder Timeout-Fehler

Prüfe deine Netzwerkverbindung und versuche es erneut. Falls das Problem bestehen bleibt, prüfe die Erreichbarkeit des Servers, indem du https://mcp.hiwalter.de/mcp in deinem Browser öffnest. Wenn du eine Antwort siehst (auch eine Fehlerseite), ist der Server erreichbar und das Problem liegt wahrscheinlich lokal in deiner Konfiguration.

internal_error / 500-Antworten

Ein 500 mit internal_error bedeutet, dass der Endpunkt selbst vorübergehend offline ist:

{
"error": {
"code": "internal_error",
"message": "Unexpected connection error."
},
"metadata": {}
}

Nichts an dem Aufruf hat das verursacht, Zugangsdaten, Parameter und Plan sind alle in Ordnung. Das HiWalter Team wird automatisch alarmiert, es ist also keine Meldung nötig. Die Lösungszeit hängt davon ab, wann die Störung beginnt, eine Störung während der Bürozeiten wird früher bemerkt als eine über Nacht oder am Wochenende, es gibt also keine sinnvolle feste Wartezeit. Lass deinen Agenten das Tool nicht weiter versuchen, arbeite an etwas anderem und komm später in der Session oder in einem Folgelauf darauf zurück.