Quick-Start-Guide

Alles, was du brauchst, um deinen ersten Hi-Walter-API-Call zu machen: vom Erstellen eines API-Keys bis zur ersten echten Antwort.

Hi Walter lässt sich auf zwei Wegen mit deinem Workflow verbinden: über unsere API oder über unseren MCP-Server. Welchen Weg du nimmst, hängt davon ab, was du bauen willst und wie technisch du werden möchtest.

Weg 1: Über die API verbinden

Für wen das ist

Entwickler und technische Nutzer, die volle Kontrolle wollen, eigene Integrationen bauen oder Hi-Walter-Daten in ihre eigenen Systeme, Skripte oder Produkte einbetten möchten.

Anwendungsfall

Du schreibst Code, der Hi Walter direkt aufruft, egal ob das ein einmaliges Skript, eine Produktivintegration oder ein Feature in deiner eigenen App ist.

Einrichtung der Hi-Walter-API

Erste Schritte

Melde dich bei app.hiwalter.de an.
Geh zu API Keys, um deinen API-Key zu erzeugen.
Schau in unsere Entwickler-Docs unter https://developer.hiwalter.de, um die vollständige Endpoint-Dokumentation zu sehen.
Jede API hat einen Playground direkt in den Docs, sodass du Requests testen und live Antworten sehen kannst, bevor du auch nur eine Zeile Code schreibst.

Weg 2: Über MCP verbinden

Für wen das ist

Nutzer, die konversationell mit Hi Walter in Claude arbeiten wollen, ohne Code zu schreiben. Das ist der schnellere Weg, wenn du Claude für Prospecting, Enrichment oder Research nutzt und die Hi-Walter-Tools direkt im Chat verfügbar haben willst.

Anwendungsfall

Du willst, dass Claude die Hi-Walter-Tools (Lookups, Enrichment, Suche) im Rahmen einer normalen Konversation, eines agentischen Workflows oder einer Claude-Code-Session aufruft, statt selbst die API anzusprechen.

Bevor du startest

Bevor du startest, brauchst du deine Hi-Walter-Connector-Zugangsdaten (OAuth Client ID und Client Secret). Diese bekommst du, indem du dich bei app.hiwalter.de anmeldest und unter API Keys einen neuen Connector erstellst.

Die Einrichtungsschritte hängen davon ab, welchen Claude-Client du nutzt.

Einrichtung des Hi-Walter-MCP

Wenn du Claude.ai nutzt (Personal-Account: Free, Pro oder Max)

Geh zu Customize → Connectors.
Klick auf +, dann auf Add custom connector.
Füg das hier in Remote MCP server URL ein:
```
https://mcp.hiwalter.de/mcp
```
Klick auf Advanced settings und gib deine OAuth Client ID und dein Client Secret ein.
Klick auf Add.

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

Wenn du Claude.ai nutzt (Team- oder Enterprise-Account)

Nur ein Owner oder Primary Owner deines Claude-Team-/Enterprise-Accounts kann einen Custom-Connector für die Organisation hinzufügen. Sobald er hinzugefügt ist, verbindet sich jedes Mitglied einzeln, und Claude greift immer nur auf Daten zu, für die dieses Mitglied autorisiert ist.

Bevor du beginnst

Du musst zuerst deinen Owner oder Primary Owner des Claude-Team-/Enterprise-Accounts zu Hi Walter einladen, da er einen Hi-Walter-Nutzer braucht, um den Verbindungsprozess abzuschließen.

Owner oder Primary Owner: Connector hinzufügen

Geh zu Organization settings → Connectors.
Klick auf Add.
Fahr mit der Maus über Custom und wähl dann Web.
Füg das hier in Remote MCP server URL ein:
```
https://mcp.hiwalter.de/mcp
```
Klick auf Advanced settings und gib die OAuth Client ID und das Client Secret ein.
Klick auf Add.

Jedes Mitglied: sich verbinden

Geh zu Customize → Connectors.
Find den Hi-Walter-Connector (markiert als Custom).
Klick auf Connect und schließ die Authentifizierung ab.

Wenn du Claude Desktop nutzt

Claude Desktop teilt sich dieselben Connectors wie dein Claude.ai-Account. Wenn du Hi Walter dort also schon hinzugefügt hast, ist hier keine weitere Einrichtung nötig.

Personal-Account (Free, Pro oder Max)

Geh zu Customize → Connectors.
Klick auf +, dann auf Add custom connector.
Füg das hier in Remote MCP server URL ein:
```
https://mcp.hiwalter.de/mcp
```
Klick auf Advanced settings und gib deine OAuth Client ID und dein Client Secret ein.
Klick auf Add und starte dann Claude Desktop neu, damit der Connector erkannt wird.

Team- oder Enterprise-Account

Dieselbe Einrichtung auf Organisationsebene wie bei Claude.ai oben (ein Owner fügt den Connector einmalig hinzu), danach geht jedes Mitglied in Claude Desktop zu Customize → Connectors, findet Hi Walter, klickt auf Connect und startet die App neu.

Tool-Berechtigungen

Standardmäßig sind alle Hi-Walter-Tools auf Needs Approval gesetzt, sodass Claude beim ersten Mal fragt, bevor es ein Tool nutzt. Um das gesammelt zu ändern, geh zu Customize → Connectors, klick neben Hi Walter auf Configure und nutz das Bulk-Change-Tool, um Tools auf Always Allow zu setzen. Einzelne Tools kannst du auch auf Blocked setzen, wenn du den Zugriff einschränken willst.

Wenn du Claude Code nutzt

Führ das hier in deinem Terminal aus und ersetz die Platzhalter 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 erwartet keinen Wert. Claude Code fragt dich danach, oder du setzt es über die Umgebungsvariable MCP_CLIENT_SECRET.

Standardmäßig fügt das Hi Walter im lokalen Scope hinzu (nur aktuelles Projekt). Füg --scope user hinzu, um es projektübergreifend 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 Browserfenster, in dem du den Zugriff auf dem Hi-Walter-Consent-Screen bestätigst. Sobald du bestätigt hast, wird dein Token gespeichert und automatisch verwaltet.

Personal-Account

Der Befehl oben funktioniert so, wie er ist.

Team- oder Enterprise-Account

Nur Admins können auf Business-Plänen MCP-Server zu Claude Code hinzufügen. Wenn du dich in Claude Code mit deinem Claude.ai-Account anmeldest, ist jeder dort bereits hinzugefügte Hi-Walter-Connector automatisch verfügbar, ohne dass du claude mcp add ausführen musst.