API-Token
API-Token für REST-API, Actions-API und MCP-Server von BrewForge erstellen, umbenennen, ändern, neu erzeugen und löschen, mit Berechtigungen pro Token, und verbundene Apps trennen.
Mit API-Token können andere Programme deine BrewForge-Daten über die REST-API, die Actions-API und den MCP-Server lesen und ändern: eine Hausautomation, ein Tabellen-Skript, dein eigenes Dashboard, ein KI-Assistent. Du verwaltest sie unter Einstellungen → Integrationen → API-Token.
Pro-Tarif
Für den API-Zugriff brauchst du mindestens den Pro-Tarif. Token kannst du in jedem Tarif anlegen, API-Anfragen werden aber nur angenommen, solange dein Konto mindestens Pro hat.

Die Seite listet deine Token mit Name, den ersten Zeichen des Tokens, der Zahl der Berechtigungen, wann sie erstellt und zuletzt benutzt wurden und wann sie ablaufen. API nutzen darunter klappt Basis-URL, Header, Rate-Limits und den nötigen Tarif auf. In einem Tarif ohne API steht darüber eine Zeile dazu.
Verbundene Apps zwischen den Token und API nutzen listet die KI-Assistenten und anderen Apps, die du per OAuth-Anmeldung statt mit einem Token verbunden hast, mit der MCP-Server-URL zum Kopieren. Klick eine App an, um sie zu trennen. Wie du eine verbindest: MCP-Server.
Ein Token erstellen
Öffne Einstellungen, wechsle zu Integrationen, klicke auf API-Token und dann auf Token erstellen.

Gib unter Name an, wo es verwendet wird, zum Beispiel „Home Assistant“.
Hake unter Darf zugreifen auf die Berechtigungen an, die das Programm braucht, und nicht mehr. Lese-Berechtigungen (read) listen nur Daten auf, Schreib-Berechtigungen (write) können sie anlegen, ändern und löschen.
Klicke auf Token erstellen und kopiere das Token aus Kopiere dein Token. Es wird nur einmal angezeigt. Wenn du es verlierst, erzeugst du es neu.
Berechtigungen
| Berechtigung | Erlaubt |
|---|---|
read | Alles lesen (alle Bereiche) |
write | Alles anlegen, ändern und löschen (alle Bereiche) |
brews:read | Sude auflisten und ansehen |
brews:write | Sude und Notizen anlegen, ändern, löschen |
inventory:read | Bestandsartikel auflisten |
inventory:write | Bestandsartikel anlegen, ändern, löschen |
cellar:read | Keller, abgefüllten Bestand, Taplists und Etiketten ansehen |
cellar:write | Keller, Abfüllung, Bestand, Taplists und Etiketten verwalten |
profiles:read | Maisch-, Gär- und Wasserprofile auflisten |
profiles:write | Maisch-, Gär- und Wasserprofile anlegen, ändern, löschen |
equipment:read | Anlagenprofile auflisten |
equipment:write | Anlagenprofile anlegen, ändern, löschen |
styles:read | Bierstilprofile auflisten |
styles:write | Bierstilprofile anlegen, ändern, löschen |
custom-fields:read | Definitionen eigener Felder auflisten |
custom-fields:write | Definitionen eigener Felder anlegen, ändern, löschen |
settings:read | Einstellungen, Importe, Rechner und Datenexport ansehen |
settings:write | Einstellungen ändern und Importe rückgängig machen |
community:read | Community, Feedback, Tickets, Posteingang und Kontoübersicht ansehen |
community:write | In Community, Feedback und Tickets schreiben, abstimmen und antworten |
read und write gelten für alle Bereiche, auch für künftige. Eine Schreib-Berechtigung enthält das Lesen nicht: Hake beide an, wenn ein Programm liest und schreibt. Unter Authentifizierung steht, welche Daten jeder Bereich umfasst, und die Tool-Referenz nennt die Berechtigung jeder Action.
Ein Token ändern, neu erzeugen oder löschen
Klicke ein Token an, um es zu öffnen:
- Ändere den Namen oder worauf es zugreifen darf und klicke auf Speichern. Der Token-Wert bleibt gleich, Programme arbeiten also mit den neuen Berechtigungen weiter.
- Neu erzeugen… erstellt nach einer Warnung, die du bestätigst, einen neuen Token-Wert und widerruft den alten sofort. Programme mit dem alten Wert funktionieren erst wieder, wenn du ihnen den neuen gibst.
- Token löschen widerruft das Token nach einer Bestätigung sofort.
Das Token verwenden
Schicke das Token bei jeder Anfrage im Header Authorization mit:
curl https://brewforge.sh/api/v1/brews \
-H "Authorization: Bearer YOUR_TOKEN"Details stehen unter Authentifizierung, Rate-Limits und in der API-Referenz (auf Englisch).