FAQ: API & MCP

Hi Walter bietet dir zwei Wege zu derselben Identitätsauflösung und denselben Kontaktdaten: eine REST-API und einen MCP-Server. Diese Seite erklärt, wie beide zusammenhängen, wann du welchen nutzt und wie Abrechnung, Limits und Tools über beide hinweg funktionieren.

API oder MCP wählen

Was ist der Unterschied zwischen der Hi-Walter-API und dem MCP?

Es sind zwei Eingangstüren zum selben Produkt. Die REST-API ist für Code: Backends, Skripte und Automatisierungsplattformen rufen sie über HTTPS auf. Der MCP-Server ist für KI-Assistenten und Agenten: Er stellt dieselben Hi-Walter-Tools bereit, sodass ein Modell wie Claude sie direkt in einer Konversation aufrufen kann. Beide laufen auf demselben Konto, denselben Daten und demselben Guthaben. Jedes Tool, das in einem verfügbar ist, ist auch im anderen verfügbar.

Verbinde ich Claude über die API oder den MCP?

Nutze den MCP. Der MCP-Server ist für KI-Clients gebaut, sodass Claude nach dem Hinzufügen die Hi-Walter-Tools als Teil eines Chats aufrufen kann, ohne dass du Request-Code schreibst. Die API ist die richtige Wahl, wenn du eigene Software schreibst, die direkt mit Hi Walter spricht, statt über einen Assistenten zu arbeiten.

Welchen sollte ich für meinen Anwendungsfall wählen?

Nutze den MCP, wenn ein KI-Assistent die Arbeit erledigen soll, zum Beispiel wenn du Claude bittest, einen Kontakt zu finden und mit einer geschäftlichen E-Mail-Adresse anzureichern, innerhalb einer Konversation oder eines Agenten-Workflows. Nutze die API, wenn du dein eigenes Produkt baust, einen Backend-Job ausführst oder eine No-Code-Plattform wie Clay oder n8n anbindest, die HTTP spricht. Wenn du unsicher bist, ist der MCP der schnellere Einstieg, weil es nichts zu bauen gibt.

Kann ich beide gleichzeitig nutzen?

Ja. Viele Konten nutzen den MCP für Ad-hoc-Arbeit in Claude und die API für Produktions-Pipelines. Beide ziehen vom selben Guthaben ab, sodass du den gesamten Verbrauch an einer Stelle über get_usage und get_billing nachverfolgen kannst.

Verbinden

Wie bekomme ich einen API-Key?

Erzeuge einen Key in deinem Hi-Walter-Konto. Keys folgen dem Format hw_ gefolgt von einer Zeichenkette. Behandle den Key als Geheimnis, denn wer ihn besitzt, kann dein Guthaben verbrauchen.

Wie authentifiziere ich API-Anfragen?

Übergib deinen API-Key als Bearer-Token im Authorization-Header:

Authorization: Bearer hw_XXXXXXXXXXX

Jeder Endpunkt ist eine POST-Anfrage mit einem JSON-Body, gesendet an die Basis-URL https://api.hiwalter.de/api/v1/tools. Ein Aufruf, der ein LinkedIn-Profil in eine geschäftliche E-Mail-Adresse auflöst, geht zum Beispiel an https://api.hiwalter.de/api/v1/tools/linkedin_to_business_email.

Wie verbinde ich den MCP mit Claude?

Füge Hi Walter als Connector über die MCP-Server-URL https://mcp.hiwalter.de/mcp hinzu und autorisiere ihn dann mit deinem Hi-Walter-Konto. Nach dem Verbinden erscheinen die Hi-Walter-Tools automatisch bei Claude und können während einer Konversation aufgerufen werden. Dieselbe Verbindung funktioniert in anderen MCP-fähigen Clients. Mehr dazu findest du im Hi-Walter-MCP-Leitfaden.

Braucht der MCP auch einen API-Key?

Der MCP nutzt dasselbe Hi-Walter-Konto und dasselbe Guthaben wie die API. Du autorisierst den Connector beim Hinzufügen mit deinem Konto, sodass du keinen rohen Request-Code einfügst und keine Header verwaltest. Die Nutzung über den MCP wird genauso gegen dein Guthaben verrechnet wie die API-Nutzung.

Nutzung

Kann ich eine ganze Liste von LinkedIn-URLs in einem Call anreichern?

Ja. Die Enrichment-Tools akzeptieren einen Batch-Parameter für bis zu 100 Werte pro Call. Für LinkedIn-Tools übergibst du linkedin_urls als Array statt des einzelnen linkedin_url. Für E-Mail-Lookups übergibst du emails als Array. Du kannst den Einzel- und den Batch-Parameter nicht in derselben Anfrage mischen.

Kann ich prüfen, wie viele Ergebnisse eine Suche liefert, bevor ich Credits ausgebe?

Ja. search_linkedin_profile akzeptiert count_only. Setze es auf true, um die Zahl der passenden Ergebnisse zu erhalten, ohne Daten abzurufen und ohne Credits zu berechnen. So kannst du abschätzen, ob du deine Suche verengen oder erweitern solltest, bevor du dich auf einen vollen Lookup festlegst.

Wie hoch sind die Rate-Limits?

Limits gelten pro Konto und bestehen aus zwei Teilen: einem Limit für Anfragen pro Minute und einem täglichen Ergebnis-Limit, beide durch deinen Tarif festgelegt. Jeder Call zählt zum Anfragelimit, einschließlich leerer Ergebnisse und Konto-Calls. Ausführliche Informationen zu Rate-Limits findest du in unseren Docs.

Credits und Abrechnung

Werde ich belastet, wenn keine Daten gefunden werden?

Nein. Dir wird nur dann etwas berechnet, wenn ein Call Daten zurückgibt. Findet ein Lookup keinen Treffer, betragen die Credit-Kosten für diesen Call null. In einer API-Antwort kannst du das im metadata-Objekt bestätigen, wo tokens_charged zeigt, was der Call gekostet hat, und tokens_remaining dein Guthaben danach anzeigt.

Sind Konto- und Verbrauchs-Calls kostenlos?

Ja. get_account, get_billing und get_usage verbrauchen keine Credits. Du kannst sie so oft abfragen, wie du möchtest, um Guthaben und Verbrauch zu verfolgen.

Wie prüfe ich mein Guthaben und meinen Verbrauch?

Rufe get_billing für deinen Tarif, dein aktuelles Guthaben und die Kosten pro Tool auf. Rufe get_usage mit einem Zeitraum von today, week, month oder billing_cycle auf, um eine tageweise Aufschlüsselung deiner Calls, verbrauchten Credits, erfolgreichen Lookups, leeren Ergebnisse und Fehler samt Zeitraum-Summen zu erhalten.