Anbinden · Weg C

n8n

Zwei Wege: Der HTTP-Request-Knoten geht über den Proxy und kann eingreifen. Der Tokenwacht-Baustein zählt, was die eingebauten LLM-Knoten geliefert haben, und holt Verbräuche für Ihre Rechnungs-Workflows.

Weg 1 · HTTP-Request über den Proxy (empfohlen)

Zugangsdaten anlegen: Header Auth mit Name X-TW-Key und Ihrem Schlüssel. Den Anbieterschlüssel als zweite Kopfzeile (x-api-key bei Anthropic, Authorization: Bearer bei OpenAI) über „Send Headers“.
HTTP-Request-Knoten: Methode POST, URL https://tokenwacht.de/anthropic/v1/messages (oder …/openai/v1/chat/completions), Body JSON wie beim Anbieter.
Kopfzeilen X-TW-Agent (Name des Workflows) und X-TW-Run (z. B. {{ $execution.id }}) setzen. Damit ist jede Ausführung ein Lauf.
Optional X-TW-Kunde aus einem Feld des Eingabeobjekts, wenn Sie je Kunde abrechnen.

// Kopfzeilen im HTTP-Request-Knoten (Ausdrücke)
X-TW-Key:    {{ $credentials.tokenwacht }}      // oder Header-Auth-Zugangsdaten
X-TW-Agent:  {{ $workflow.name }}
X-TW-Run:    {{ $execution.id }}
X-TW-Kunde:  {{ $json.kunde }}

Ein 402 des Proxys erscheint im Knoten als Fehler mit dem JSON-Körper; mit „Continue on Fail“ verzweigen Sie in einen sauberen Abschluss.

Weg 2 · Tokenwacht-Baustein

Das Paket n8n-nodes-tokenwacht liegt im Repository unter sdk/n8n (Veröffentlichung im n8n-Verzeichnis ist vorbereitet). Installation im Selbstbetrieb von n8n: Einstellungen → Community Nodes → Paket aus dem Ordner. Zugangsdaten „Tokenwacht API“: Basis-URL und Schlüssel.

Operation	Was sie tut
Lauf beginnen	Erzeugt `tokenwacht_lauf_id` und `tokenwacht_kopfzeilen` plus die Proxy-Basis-URLs im Ausgabeobjekt. Nachfolgende HTTP-Request-Knoten übernehmen die Kopfzeilen per Ausdruck.
Nutzung melden	Liest das Nutzungsobjekt eines LLM-Knotens (OpenAI `usage`, Anthropic `usage`, Gemini `usageMetadata`, LangChain `tokenUsage`) und schickt die Zählwerte an Tokenwacht. Für Knoten, die nicht über den Proxy laufen.
Verbrauch abrufen	Holt `/v1/api/verbrauch` je Agent, Endkunde, Modell oder Tag, z. B. für eine monatliche Rechnung an Endkunden.

Eingebaute LLM-Knoten von n8n

Die Zugangsdaten der eingebauten OpenAI- und Anthropic-Knoten erlauben eine eigene Basis-URL, aber keine zusätzlichen Kopfzeilen. Ohne X-TW-Key weist der Proxy ab. Nutzen Sie für diese Knoten „Nutzung melden“ hinter dem Knoten oder wechseln Sie auf den HTTP-Request-Knoten, wenn Sie eingreifen wollen.

Prüfen: Workflow einmal ausführen, dann Anbindung prüfen. Das letzte Ereignis trägt den Workflow-Namen als Agent.

← Node-SDK Claude Code →