Hi Walter MCP-Server

Verbinde Claude, Claude Code und jeden MCP-Client mit Hi Walter. Gib deinem KI-Agenten in einem einzigen Tool-Aufruf Live-Zugriff auf Kontakt-Enrichment, HEM- und IP-Auflösung sowie den vollständigen Identitäts-Graphen.

Klassische Enrichment-Tools sind formularbasiert und manuell. Hi Walter ist Prompt-and-go. Es ist ein MCP, der speziell für KI-Agenten gebaut wurde, sodass dein Agent anonyme Website-Besucher de-anonymisieren, gehashte E-Mails (HEMs) zu echten Identitäten auflösen, Kontakte aus LinkedIn anreichern und die Verbindungen zwischen IP-Adressen, MAIDs und Personen herstellen kann. Der vollständige Identitäts-Graph, zugänglich in einem einzigen Tool-Aufruf.

Was ist der Hi Walter MCP-Server?

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 Hi Walter MCP-Server gibt jedem kompatiblen KI-Tool direkten Zugriff auf die Enrichment-Funktionen von Hi Walter: jeden Endpunkt, jeden Parameter und jedes Response-Schema. So kann dein Agent Kontakte anreichern, Identitäten auflösen und Besucherdaten nachschlagen, ohne die Konversation zu verlassen.

MCP-Server-URL

https://mcp.hiwalter.de/mcp

Warum nutzen?

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 Hi Walter MCP-Server:

Ohne MCP	Mit MCP
KI rät Endpunkt-URLs	KI liest die echte API-Referenz
Veraltete Parameternamen	Immer aktuelle Parameter-Schemas
Falsche Response-Strukturen	Korrekte Response-Strukturen aus der Quelle
Hin und her mit Korrekturen	Korrekter Code beim ersten Versuch

Setup

Claude (claude.ai)

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)

Gehe in Claude.ai zu Customize, dann Connectors.
Klicke auf +, dann auf Add custom connector.
Füge Folgendes in Remote MCP server URL ein:
```
https://mcp.hiwalter.de/mcp
```
Klicke auf Advanced settings und gib deine Hi Walter Connector-Zugangsdaten ein:
- OAuth Client ID: deine Client ID
- OAuth Client Secret: dein Client Secret
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 Hi Walter einladen, da dieser einen Hi Walter Nutzer benötigt, um den Verbindungsprozess abzuschließen.

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

Gehe zu Organization settings, dann Connectors.
Klicke auf Add.
Fahre mit der Maus über Custom und wähle dann Web.
Füge Folgendes in Remote MCP server URL ein:
```
https://mcp.hiwalter.de/mcp
```
Klicke auf Advanced settings und gib die Hi Walter Connector-Zugangsdaten ein (OAuth Client ID und OAuth Client Secret).
Klicke auf Add.

Jedes Mitglied, verbinde dich damit:

Gehe zu Customize, dann Connectors.
Finde den Hi Walter Connector (mit einem Custom-Label markiert).
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

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)

Gehe in Claude Desktop zu Customize, dann Connectors.
Klicke auf +, dann auf Add custom connector.
Füge Folgendes in Remote MCP server URL ein:
```
https://mcp.hiwalter.de/mcp
```
Klicke auf Advanced settings und gib deine Hi Walter Connector-Zugangsdaten ein:
- OAuth Client ID: deine Client ID
- OAuth Client Secret: dein Client Secret
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

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

Gehe zu Organization settings, dann Connectors.
Klicke auf Add.
Fahre mit der Maus über Custom und wähle dann Web.
Füge Folgendes in Remote MCP server URL ein:
```
https://mcp.hiwalter.de/mcp
```
Klicke auf Advanced settings und gib die Hi Walter Connector-Zugangsdaten ein (OAuth Client ID und OAuth Client Secret).
Klicke auf Add.

Jedes Mitglied, verbinde dich damit:

Gehe in Claude Desktop zu Customize, dann Connectors.
Finde den Hi Walter Connector (mit einem Custom-Label markiert).
Klicke auf Connect und schließe die Authentifizierung ab.
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.

Tool-Berechtigungen konfigurieren

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

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

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

Claude Code

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

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 Hi Walter über all deine Projekte hinweg verfügbar zu machen:

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 Hi Walter 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 Hi Walter 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.

Beispiel-Prompts

Sobald du verbunden bist, kannst du mit Hi Walter 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 und Telefonnummer: linkedin.com/in/example”

Einen Besucher nachschlagen

“Ich habe eine IP-Adresse von einem Website-Besucher, 192.0.2.1, kannst du mir sagen, wer das ist?”

Eine gehashte E-Mail auflösen

“Löse diese HEM zu einer echten Identität auf und gib den Namen und das Unternehmen zurück: abc123…”

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.

Tokens und Kosten

Du gibst nur Tokens für verifizierte Daten aus, die tatsächlich zurückgegeben werden. Ein paar Regeln, die der Agent automatisch befolgt:

Keine Daten, keine Kosten. Aufrufe, die not_found zurückgeben, kosten nichts.
Zählen ist kostenlos. search_linkedin_profile mit count_only: true gibt Trefferzahlen zurück, ohne Tokens auszugeben, nutze es, um einen Such-Umfang abzuschätzen, bevor du dich festlegst.
Kostenlose Tools. get_account, get_billing und get_usage kosten nie Tokens. Rufe get_billing auf, um die token_costs-Map pro Tool und dein aktuelles Guthaben zu erhalten.
Telefon-Tokens sind getrennt. linkedin_to_mobile_phone gibt Telefon-Tokens aus, ein von deinem Plan festgelegtes Kontingent, getrennt von deinem regulären Token-Guthaben, zum Satz von 1 Telefon-Token pro zurückgegebenem Ergebnis.

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.

Fehlerbehebung

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 Hi Walter 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.

plan_restricted bei einer persönlichen E-Mail-Abfrage

linkedin_to_personal_email und linkedin_to_best_personal_email sind im 997-Dollar-Plan nicht verfügbar. Aufrufe von einem 997-Dollar-Konto geben 403 zurück:

{
  "error": {
    "code": "plan_restricted",
    "message": "Personal email lookups are not available on your plan. Contact support@hiwalter.de to request access."
  }
}

Das ist eine Plan-Berechtigung, kein fehlendes Datum, erneutes Versuchen oder Umformulieren des Prompts hilft nicht. Nutze stattdessen linkedin_to_business_email oder kontaktiere support@hiwalter.de, um Zugriff anzufragen.