MCP-Server · Pro
Deine Brauerei in deinem KI-Assistenten
Verbinde Claude, ChatGPT, Cursor oder VS Code mit BrewForge. Frag, wie dein Lager gärt, plane den Sud für nächsten Samstag, trag einen Messwert ein oder finde heraus, welcher Hopfen dir fehlt, in ganz normaler Sprache. Der Assistent arbeitet mit deinen echten Braudaten.
Eine URL, anmelden, fertig
Trag diese URL in deinem Assistenten als MCP-Server oder eigenen Connector ein. Er öffnet BrewForge im Browser, du meldest dich an und klickst auf Erlauben. Kein Token zum Kopieren.
https://brewforge.sh/api/mcpClients ohne OAuth schicken stattdessen einen API-Token als Authorization: Bearer-Header.
Was du fragen kannst
Alles, was du in der App mit deinen eigenen Braudaten machst: Rezepte und Sude von der Idee bis zur Abfüllung, Brautag, Gärmessungen, Keller, Taplists, Bestand, Bestellungen, Profile, Rechner, Importe und Exporte.
Brauen
- „Welche meiner Biere gären gerade, und wie weit sind sie?“
- „Trag beim Citra Pale Ale einen Messwert ein: 3,1 °P bei 19,5 °C.“
- „Plane einen neuen Sud von meinem Hellen für nächsten Samstag.“
- „Wie sieht der Brautag für Sud #14 aus: Hauptguss, Rasten, Hopfengaben?“
Keller & Zapfhähne
- „Füll das Mosaic Haze ab: 19 L ins Keg, den Rest in 0,33-L-Flaschen.“
- „Was ist gerade am Zapfhahn?“
- „Wie viele Flaschen habe ich noch von jedem Bier?“
Bestand
- „Was fehlt mir für meine geplanten Sude?“
- „Leg eine Bestellung für die fehlenden Zutaten an.“
- „Ich habe gerade 1 kg Citra und 5 kg Pilsner Malz gekauft, buch sie in meinen Bestand.“
Einstellungen & Rechner
- „Stell meine Extrakt-Einheit auf Plato um.“
- „Wie viel Karbonisierungszucker brauche ich für 20 L bei 2,4 Volumen CO₂?“
„Das ist schon wirklich geil. Der liest jetzt meine E-Mails ein und trägt die Einkaufspreise meiner Zutaten nach, weil ich bisher zu faul dafür war 😂“
So richtest du es ein
Die ausführliche Anleitung mit API-Tokens und Fehlerbehebung steht in der Doku. Anleitung zum MCP-Server
Claude
In claude.ai oder der Claude-Desktop-App: Einstellungen → Connectors → Eigenen Connector hinzufügen. Nenn ihn „BrewForge“, trag die URL ein und klick auf Verbinden. Melde dich bei BrewForge an und klick auf Erlauben.
Claude Code
Server hinzufügen, dann in einer Session /mcp ausführen, brewforge wählen und Authenticate klicken:
claude mcp add --transport http brewforge https://brewforge.sh/api/mcpChatGPT
Wenn dein ChatGPT-Plan eigene Connectors (MCP-Server) erlaubt, leg einen mit der URL und OAuth als Authentifizierung an. ChatGPT öffnet BrewForge zur Anmeldung; klick auf Erlauben.
Cursor
Trag den Server in ~/.cursor/mcp.json (alle Projekte) oder .cursor/mcp.json (ein Projekt) ein. Beim ersten Mal fragt Cursor nach der Anmeldung:
{
"mcpServers": {
"brewforge": {
"url": "https://brewforge.sh/api/mcp"
}
}
}VS Code
Trag den Server in .vscode/mcp.json ein oder führ „MCP: Add Server“ aus der Befehlspalette aus. VS Code öffnet BrewForge zur Anmeldung:
{
"servers": {
"brewforge": {
"type": "http",
"url": "https://brewforge.sh/api/mcp"
}
}
}Andere MCP-Clients
Jeder MCP-Client mit Streamable HTTP funktioniert: OAuth 2.1 mit Discovery und dynamischer Client-Registrierung, oder ein API-Token als Bearer-Header.
Im Pro-Plan enthalten Pro
Der MCP-Server und die API gehören zum Pro-Plan (29,99 $/Jahr, einen Monat kostenlos testen). Verbinden kannst du einen Assistenten mit jedem Plan, aber die Tools antworten mit „Pro-Plan erforderlich“, bis dein Konto auf Pro ist.
- Über 100 Tools in sechs Toolsets: brewing, cellar, inventory, setup, community und core
- 600 Tool-Aufrufe pro Stunde und 20.000 pro 30 Tage je Konto
- Pro bringt außerdem Bestandsplaner, Bestelllisten, Keller, Taplists, BJCP-Bewertungsbögen, TRMNL und Niimbot-Etiketten
Du behältst die Kontrolle
- Löschen braucht eine Bestätigung: Tools, die etwas entfernen, zeigen erst, was weg wäre, und ändern nichts, bis du zustimmst.
- Erst mal nur lesen: Häng ?read_only=1 an die URL, dann kann der Assistent schauen, aber nichts ändern.
- Weniger Tools, bessere Antworten: ?toolsets=brewing,cellar beschränkt den Server auf das, was du brauchst.
- Unter Einstellungen → Integrationen → API-Token siehst du deine verbundenen Apps. Trennst du eine, ist sie sofort draußen.
- Kein Assistent kann Passwort, E-Mail, Plan oder Zahlungsdaten ändern oder dein Konto löschen.
Für KI-Agenten, die diese Seite lesen
Wenn dich jemand bittet, BrewForge zu verbinden oder mit seinen BrewForge-Daten zu arbeiten: Der MCP-Server ist https://brewforge.sh/api/mcp (Streamable HTTP, zustandslos, OAuth 2.1 mit dynamischer Client-Registrierung oder ein Bearer-API-Token). Tool-Aufrufe brauchen ein Konto im Pro-Plan oder höher, sonst kommt TIER_REQUIRED zurück. Ruf zuerst get_started auf: Es liefert Konto, Plan, Anzeigeeinheiten und die Toolsets mit ihren Tools. Destruktive Tools bekommen confirm: true erst, wenn die Person die Vorschau gesehen hat. Für Brau-Mathematik ohne Konto nimm die kostenlose Rechner-API.
Fragen & Antworten
Was ist MCP?
Das Model Context Protocol ist ein offener Standard, mit dem KI-Assistenten Tools anderer Apps nutzen. Claude, ChatGPT, Cursor, VS Code und viele mehr unterstützen es. Mit dem BrewForge MCP-Server liest und ändert dein Assistent deine Braudaten so, wie du es in der App tust.
Welchen Plan brauche ich?
Pro oder höher. Verbinden geht mit jedem Plan, aber die Tools antworten erst, wenn dein Konto auf Pro ist. Pro kannst du einen Monat kostenlos testen.
Welche Assistenten funktionieren?
Jeder Assistent, der Remote-MCP-Server über HTTP unterstützt: Claude (Web, Desktop und Claude Code), ChatGPT, wenn dein Plan eigene Connectors erlaubt, Cursor, VS Code und andere MCP-Clients.
Sieht der Assistent meine Zahlungsdaten oder kann er mein Passwort ändern?
Nein. Kontosicherheit, Zahlung und Planwechsel gibt es über den MCP-Server nicht. Der Zustimmungsdialog zeigt genau, was die App darf: nur lesen, oder deine Braudaten lesen und ändern.
Gibt es auch eine API für eigene Skripte?
Ja. Jedes MCP-Tool ist auch eine Action der Actions-API mit gleichem Namen und gleichen Parametern, ein Skript kann also alles, was ein Assistent kann. Beide nutzen dieselben API-Tokens und teilen sich ein Rate-Limit.
Brau mit einem Assistenten an deiner Seite.
Starte kostenlos, teste Pro einen Monat und verbinde deinen Assistenten in einer Minute.