MCP-Server (Claude und KI-Assistenten)

Eine sichere Verbindung zwischen Ihren Kellerdaten und MCP-kompatibler Software. Nach der ersten Einrichtung kann der Assistent Ihren Bestand lesen oder aktualisieren — im Rahmen von Abo und Kontoregeln.

Die genaue Adresse steht in der VinoCellar-App auf dem Bildschirm für MCP und Zugriffstoken unter «MCP-Server-Adresse». Kopieren Sie sie unverändert — nicht von einem alten Screenshot abtippen.

In der öffentlichen Produktions-App lautet sie in der Regel https://mcp.vinocellar.app . Zeigt die App etwas anderes, vertrauen Sie dem angezeigten Wert.

1. App öffnen → Bereich MCP (oder Einstellungen → VinoCellar MCP → Token verwalten).
2. Serveradresse aus dem vorgesehenen Block kopieren.
3. In Ihrem Assistenten (z. B. Claude Desktop) einen MCP-Server hinzufügen und die Adresse gemäß Hilfe des Programms einfügen.
4. Beim ersten Verbinden führt Sie eine Webseite durch; fügen Sie das persönliche Token aus der App ein, wenn das Formular danach fragt.

Die Verbindung ist per HTTPS zwischen Ihrem Rechner und VinoCellar gesichert; der Assistent sieht nur, was Ihr Token erlaubt.

Beim ersten Mal öffnet das Programm oft den Browser, damit Sie das in der App erstellte Token einfügen können; VinoCellar prüft es, danach kann der Assistent die Einrichtung abschließen.

In der App erstellte Tokens erlauben die im Service vorgesehenen Kelleraktionen (Listen, Suche, Fächerlayout, Verschieben, Weine hinzufügen).

Das Token identifiziert Ihr Konto gegenüber dem MCP-Server:

1. In der App MCP-Bildschirm öffnen und Token erstellen.
2. Klare Bezeichnung vergeben (z. B. «MacBook», «Claude am PC»).
3. Wert sofort kopieren — er wird nur einmal angezeigt.
4. Token auf demselben Bildschirm widerrufen, wenn ein Gerät verloren geht oder ein Programm getrennt werden soll.

Tokens wie Passwörter behandeln: Wer Token und Serveradresse hat, kann bis zur Widerrufung über MCP auf Ihren Keller zugreifen.

Nachdem Sie den Server im Assistenten hinzugefügt haben, stehen Aktionen für Ihren Keller zur Verfügung. Praktisch können Sie etwa:

• Verknüpftes Konto prüfen und eine hilfreiche Orientierung sehen (Willkommen, Link zu dieser FAQ).
• Durchsuchen oder suchen in Ihren Flaschen (volle Liste oder Stichwortsuche).
• Keller ansehen und das Fächerlayout, um zu wissen, wo Flaschen stehen.
• Flasche verschieben in ein anderes Fach oder einen anderen Keller.
• Wein hinzufügen wenn der Assistent die nötigen Informationen hat (auch aus Etiketten oder bereits strukturierten Daten) — erfordert ein aktives MCP-Abo.

MCP beschränkt sich auf die oben beschriebenen Bestands- und Kellervorgänge.

Der Vino-Chat in der App, der Speisen-Wein-Assistent, das Verkostungstagebuch und ähnliche Funktionen lassen sich nicht als getrennte MCP-Aktionen fernsteuern — nutzen Sie dafür die mobile oder Web-App.

Vorgesehen ist ein MCP-kompatibler Assistent (z. B. Claude Desktop): Serveradresse aus der App kopieren und persönliches Token erstellen.

Wir veröffentlichen keinen separaten Katalog von «Webadressen zum manuellen Aufruf» für dieselben Funktionen — Sie richten Ihren Assistenten ein, der dann die in VinoCellar verfügbaren Aktionen findet.

Credits werden vor allem für Etikettenscans in der App genutzt. Das MCP-Abo ist getrennt: Solange es aktiv ist, sind unterstützte Aktionen über den MCP-Server nicht in gleicher Weise durch Ihr Scan-Credit-Guthaben begrenzt.

Heute werden Claude Desktop und andere MCP-fähige Programme unterstützt, die wie in diesem Abschnitt beschrieben eingerichtet sind. ChatGPT- und Gemini-Kompatibilität ist geplant; siehe Release Notes und diese FAQ.