Zum Inhalt springen

MCP verbinden

Der Glasswise MCP-Server ist ein Remote-MCP-Server unter:

https://mcp.glasswise.eu/mcp

Er nutzt Streamable HTTP als Transport und OAuth. Beim Verbinden öffnet dein Browser den Glasswise-Login. Der Server fragt den Scope openid graphql:role:api_user an.

Der Connector akzeptiert nur OAuth-Client-IDs auf seiner Allow-List. Heute deckt diese Liste Claude Code ab. Andere Clients, darunter ChatGPT und die Claude-Web-App, können sich noch nicht authentifizieren.

  1. Füge den Server hinzu:

    Terminal-Fenster
    claude mcp add --transport http glasswise https://mcp.glasswise.eu/mcp

    Der Standard-Scope local lädt ihn nur im aktuellen Projekt. Mit --scope user lädst du ihn in allen deinen Projekten, mit --scope project teilst du ihn mit dem Team über eine committete .mcp.json.

  2. Führe in einer Claude-Code-Session /mcp aus, wähle den glasswise-Server und dann Authenticate.

  3. Melde dich bei Glasswise an, sobald der Browser aufgeht, und bestätige den Consent-Screen.

  4. Die Glasswise-Tools erscheinen unter dem Server in /mcp.

Entfernen mit claude mcp remove glasswise. Beim Entfernen eines Remote-Servers löscht Claude Code auch die OAuth-Tokens und die Client-Registrierung, die es dafür gespeichert hat.

Noch nicht verfügbar. ChatGPTs OAuth-Client-ID steht nicht auf der Allow-List des Connectors, eine Verbindung scheitert an der Authentifizierung.

Der Server stellt 45 Tools bereit: 28 lesend, 17 schreibend. Jedes Tool bildet eine API-Operation ab; die API-Referenz hat die Parameter im Detail. Lese- und Schreib-Tools sind getrennt und tragen MCP-Annotationen (readOnlyHint, idempotentHint, destructiveHint).

Tool Liefert
get_file Metadaten einer zugänglichen Datei
get_file_download Download-Link, höchstens 60 Sekunden gültig
server_info Name und Version des Connectors; ruft nichts upstream auf
list_wineries Die Weingüter (Workspaces), denen du angehörst, mit Plan und Feature-Flags
get_account Ein Weingut: Plan, Billing-Status, Publish-Berechtigung, Feature-Flags, Marketing-QR-Kontingent
list_brands Brands deiner Weingüter, filterbar über workspace_id
get_brand Eine Brand: Kontakt, Adresse, Rechts- und Social-Felder
list_labels Labels, filterbar nach Workspace, Brand oder Status
get_label Ein Label mit eingebetteten Formaten und Übersetzungen
list_label_ingredients Die Zutaten eines Labels, geordnet
list_label_grape_varieties Die Rebsorten eines Labels mit Cuvée-Anteilen
list_label_certifications Die Zertifizierungen eines Labels
list_label_packagings Die Verpackungen eines Labels
get_label_translation Die übersetzten Texte eines Labels für eine Locale
list_label_formats Die Flaschenformate eines Labels
get_label_format Ein Flaschenformat
list_marketing_qr_codes Marketing-QR-Codes deiner Weingüter
get_marketing_qr_code Ein Marketing-QR-Code, inklusive UTM und Geo-Anzahl
list_catalog_ingredients Zutatenkatalog mit Allergen-Flags
list_catalog_grape_varieties Rebsortenkatalog mit Synonymen
list_catalog_closure_types Verschlussarten mit Material
list_catalog_capsule_types Kapselarten mit Material
list_catalog_packaging_types Verpackungs-Vokabular
list_catalog_countries Länder mit ISO-Codes und EU-Mitgliedschaft
list_catalog_sweetness Süße-Vokabular
list_catalog_production_methods Produktionsmethoden wie bio oder biodynamisch
list_catalog_certification_types Zertifizierungs-Vokabular
list_catalog_locales Unterstützte Übersetzungs-Locales für Labels
Tool Wirkung
upload_file Bis zu 4 MiB Dateidaten mit Workspace und Zweck hochladen
delete_file Deinen nicht mehr verknüpften Upload entfernen
update_brand Felder einer Brand bearbeiten
create_label Label-Entwurf unter einer Brand anlegen
update_label Felder eines Labels bearbeiten
publish_label Label veröffentlichen, sodass sein QR auflöst; idempotent
duplicate_label Label in einen neuen Entwurf duplizieren
set_label_ingredients Die ganze Zutatenliste eines Labels ersetzen
set_label_grape_varieties Die ganze Rebsortenliste eines Labels ersetzen
set_label_certifications Die ganze Zertifizierungsliste eines Labels ersetzen
set_label_packagings Die ganze Verpackungsliste eines Labels ersetzen
set_label_translation Die Übersetzung eines Labels für eine Locale ersetzen
create_label_format Flaschenformat zu einem Label hinzufügen
update_label_format Flaschenformat bearbeiten
create_marketing_qr Marketing-QR-Code-Entwurf anlegen
update_marketing_qr Ziel, Redirects, Ablauf oder UTM-Tags eines Marketing-QR-Codes bearbeiten
publish_marketing_qr Marketing-QR-Code veröffentlichen; vergibt den Shortlink, abhängig von Plan und Kontingent

Verhalten bei Schreibzugriffen:

  • Die vier Listen-Tools set_label_ingredients, set_label_grape_varieties, set_label_certifications und set_label_packagings ersetzen die ganze Liste. Zeilen, die du weglässt, werden gelöscht; [] leert die Liste. Sie gilt danach nur für dieses Label. Spätere Änderungen an der Weinliste überschreiben sie nicht.
  • set_label_translation ersetzt die öffentlichen Textfelder einer Locale. Weggelassene Felder werden null; bestehende Einstellungen für abweichende Labeltexte bleiben erhalten. Texte ohne solche Abweichungen können den Wein aktualisieren, wenn er nur dieses eine Label hat. Bei mehreren Labels werden diese Änderungen nicht an den Wein weitergegeben. Spätere Weinänderungen können Texte ohne eigene Abweichung überschreiben.
  • Bei update_* bleibt ein weggelassenes Feld unverändert; ein explizites null leert ein Feld, das null erlaubt.
  • duplicate_label übernimmt weggelassene Werte aus der Vorlage. Füllmenge, GTIN und Produktvariante stammen aus dem Standard-Flaschenformat, oder aus dem Label, falls es kein Standardformat hat. Explizite Werte haben Vorrang.

shop_url ist nicht beschreibbar. Antworten können es als null enthalten oder weglassen. outside_eu_forward_href ist ein veralteter historischer Wert. Verwende die geografischen Regeln in der Glasswise App, um geografische Weiterleitungen zu verwalten. Diese API bietet dafür keine Operationen.

Details und Wiederholungen: Dateien.