FAQ: API & MCP
HiWalter 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 Nutzung, Limits und Tools über beide hinweg funktionieren.
API oder MCP wählen
Section titled “API oder MCP wählen”Was ist der Unterschied zwischen der HiWalter-API und dem MCP?
Section titled “Was ist der Unterschied zwischen der HiWalter-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 HiWalter-Tools bereit, sodass ein Modell wie Claude sie direkt in einer Konversation aufrufen kann. Beide laufen auf demselben Konto und denselben Daten. Jedes Tool, das in einem verfügbar ist, ist auch im anderen verfügbar.
Verbinde ich Claude über die API oder den MCP?
Section titled “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 HiWalter-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 HiWalter spricht, statt über einen Assistenten zu arbeiten.
Welchen sollte ich für meinen Anwendungsfall wählen?
Section titled “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?
Section titled “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 laufen über dasselbe Konto, sodass du den gesamten Verbrauch an einer Stelle über get_usage und get_billing nachverfolgen kannst.
Verbinden
Section titled “Verbinden”Wie bekomme ich einen API-Key?
Section titled “Wie bekomme ich einen API-Key?”Erzeuge einen Key in deinem HiWalter-Konto. Keys folgen dem Format hw_ gefolgt von einer Zeichenkette. Behandle den Key als Geheimnis, denn wer ihn besitzt, kann in deinem Namen Anfragen stellen.
Wie authentifiziere ich API-Anfragen?
Section titled “Wie authentifiziere ich API-Anfragen?”Übergib deinen API-Key als Bearer-Token im Authorization-Header:
Authorization: Bearer hw_XXXXXXXXXXXJeder 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?
Section titled “Wie verbinde ich den MCP mit Claude?”Füge HiWalter als Connector über die MCP-Server-URL https://mcp.hiwalter.de/mcp hinzu und autorisiere ihn dann mit deinem HiWalter-Konto. Nach dem Verbinden erscheinen die HiWalter-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 HiWalter-MCP-Leitfaden.
Braucht der MCP auch einen API-Key?
Section titled “Braucht der MCP auch einen API-Key?”Der MCP nutzt dasselbe HiWalter-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 zählt genauso gegen deine Fair-Use-Kontingente wie die API-Nutzung.
Nutzung
Section titled “Nutzung”Kann ich eine ganze Liste von LinkedIn-URLs in einem Call anreichern?
Section titled “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 die vollständige Suche starte?
Section titled “Kann ich prüfen, wie viele Ergebnisse eine Suche liefert, bevor ich die vollständige Suche starte?”Ja. search_linkedin_profile akzeptiert count_only. Setze es auf true, um die Zahl der passenden Ergebnisse zu erhalten, ohne Daten abzurufen und ohne Records zu verbrauchen. 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?
Section titled “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.
Nutzung und Abrechnung
Section titled “Nutzung und Abrechnung”Zählt es gegen mein Kontingent, wenn keine Daten gefunden werden?
Section titled “Zählt es gegen mein Kontingent, wenn keine Daten gefunden werden?”Nein. Bezahlte Tarife sind unbegrenzt, es fallen keine Kosten pro Abfrage an. Erfolglose Lookups zählen nicht einmal gegen deine Fair-Use-Kontingente: Gezählt werden nur Calls, die tatsächlich Daten zurückgeben, ein Lookup ohne Treffer bleibt unberührt.
Sind Konto- und Verbrauchs-Calls kostenlos?
Section titled “Sind Konto- und Verbrauchs-Calls kostenlos?”Ja. get_account, get_billing und get_usage sind kostenlos. Du kannst sie so oft abfragen, wie du möchtest, um Plan und Verbrauch zu verfolgen.
Wie prüfe ich meinen Plan und meinen Verbrauch?
Section titled “Wie prüfe ich meinen Plan und meinen Verbrauch?”Rufe get_billing für deinen Tarif und dein aktuelles Kontingent auf. Rufe get_usage mit einem Zeitraum von today, week, month oder billing_cycle auf, um eine tageweise Aufschlüsselung deiner Calls, verbrauchten Records, erfolgreichen Lookups, leeren Ergebnisse und Fehler samt Zeitraum-Summen zu erhalten.