MCP-Server

prod.link verfügt über einen eingebauten MCP-Server. MCP („Model Context Protocol") ist der offene Standard, mit dem KI-Assistenten wie Claude oder ChatGPT andere Anwendungen sicher bedienen können. Einmal verbunden, kann Ihr Assistent Ihre Digital Links, Landing Pages, QR-Codes und Scan-Statistiken für Sie verwalten — in natürlicher Sprache.

Beispiel: „Lege Digital Links für diese 20 Produkte an, weise den ersten fünf unsere Frühjahrs-Landing-Page zu und sag mir, wie die Scans letzte Woche gelaufen sind."

So funktioniert es

  • Ihr Assistent verbindet sich mit prod.link in Ihrem Namen. Er meldet sich mit Ihrem bestehenden prod.link-Konto an und kann genau das tun, was Sie tun können — nicht mehr.
  • Er sieht nur die Brands, auf die Sie Zugriff haben. Jede Aktion benennt die Brand, auf die sie sich bezieht.
  • Ihr KI-Assistent zeigt Ihnen jede Aktion vor der Ausführung an und fragt nach — insbesondere bei destruktiven Aktionen wie dem Löschen eines Digital Links.

Assistenten verbinden

Die Adresse des MCP-Servers ist Ihre prod.link-URL plus /mcp:

https://app.prodlink.de/mcp

Claude (claude.ai / Claude Desktop)

  1. Öffnen Sie Einstellungen → Connectors → Eigenen Connector hinzufügen.
  2. Geben Sie einen Namen (z. B. „prod.link") und die MCP-Server-Adresse ein.
  3. Ein Browserfenster öffnet sich: Melden Sie sich mit Ihrem prod.link-Konto an und klicken Sie auf dem Zustimmungsbildschirm auf Erlauben.

Claude Code (Terminal)

claude mcp add --transport http prodlink https://app.prodlink.de/mcp

Führen Sie danach in Claude Code /mcp aus und schließen Sie die Anmeldung im Browser ab.

Andere MCP-Clients

Jeder MCP-Client, der den Streamable-HTTP-Transport mit OAuth unterstützt, kann sich über dieselbe Adresse verbinden. Die Anmeldung läuft immer über Ihr prod.link-Konto — es gibt keine API-Schlüssel zu verwalten.

Was Ihr Assistent kann

Brands

Fragen Sie nach…Werkzeug
„Welche Brands kann ich verwalten?"list_brands
Fragen Sie nach…Werkzeug
„Zeig alle Digital Links von <Brand>."list_digital_links
„Zeig Details zu GTIN 04012345123456."get_digital_link
„Lege einen Digital Link für Produkt X mit Ziel-URL Y an."create_digital_link
„Lege Digital Links für diese Produktliste an."create_digital_links (bis zu 100 auf einmal)
„Ändere Ziel-URL / Titel / SKU / Resolver-Links."update_digital_link
„Lösche den Digital Link für GTIN …"delete_digital_link
„Gib mir den QR-Code für GTIN … als PNG."get_digital_link_qr_code

Hinweise:

  • Digital Links können auf GTIN-, Chargen- oder Serien-Ebene angelegt werden — nennen Sie Charge bzw. Seriennummer, der Assistent gibt sie weiter.
  • Der GS1-Resolver-Eintrag und die Resolver-URL werden automatisch erzeugt. Sie müssen niemals selbst GS1-Dokumente erstellen.
  • Das Digital-Link-Limit Ihres Abonnements gilt wie gewohnt. Würde eine Anlage es überschreiten, nennt der Assistent den aktuellen Stand, das Limit und die verbleibende Kapazität.
  • Löschen ist endgültig. Das Löschen eines Links auf GTIN-Ebene entfernt auch dessen Chargen- und Serien-Varianten, und gedruckte QR-Codes dafür funktionieren nicht mehr. Ihr Assistent warnt Sie vorher.

Landing Pages

Fragen Sie nach…Werkzeug
„Liste die Landing Pages von <Brand> auf."list_landing_pages
„Zeig mir Landing Page X (mit HTML)."get_landing_page
„Baue eine Landing Page für Produkt X."create_landing_page
„Ändere die Überschrift / überarbeite die Seite."update_landing_page_html
„Weise die Seite GTIN … zu."assign_landing_page
„Entferne die Seite von GTIN …"unassign_landing_page

Hinweise:

  • Eine neue Landing Page ist für Konsumenten nicht sichtbar, bis sie einem Digital Link zugewiesen wurde. Jedes Ergebnis enthält eine Vorschau-URL, mit der Sie die Seite selbst prüfen können.
  • Beim Zuweisen fragt der Assistent, ob die Seite der Standard-Link werden soll — wenn ja, leiten QR-Code-Scans direkt auf die Seite. Wenn nein, wird die Seite der Link-Liste des Produkts hinzugefügt, ohne das Scan-Ziel zu ändern.
  • Es gibt keinen Entwurfsmodus. Änderungen an einer zugewiesenen Seite sind sofort für Konsumenten sichtbar. Prüfen Sie nach Änderungen die Vorschau-URL.

Custom Attributes

Custom Attributes sind zusätzliche Felder, die Ihre Brand definiert (z. B. „Material", „CO2-Fußabdruck") und pro Produkt befüllt.

Fragen Sie nach…Werkzeug
„Welche Custom Attributes hat <Brand>?"list_custom_attributes
„Füge ein Textattribut 'Material' hinzu."create_custom_attribute
„Benenne / ändere ein Attribut."update_custom_attribute
„Lösche das Attribut 'Material'."delete_custom_attribute
„Zeig die Custom-Attribute-Werte für GTIN …"get_digital_link_custom_attributes
„Setze Material=Aluminium für diese 5 Produkte."set_digital_link_custom_attributes

Hinweise:

  • Definieren/Ändern/Löschen von Attributen erfordert Brand-Admin-Rechte — der Assistent weist Sie darauf hin, falls Sie kein Admin sind. Das Befüllen von Werten benötigt nur normalen Brand-Zugriff.
  • Beim Befüllen können Sie jedes Attribut über seinen Key (z. B. material) oder seine ID benennen; der Assistent löst das für Sie auf.
  • set_digital_link_custom_attributes verarbeitet ein oder viele Produkte in einem Aufruf und meldet den Erfolg pro Produkt, sodass Sie genau sehen, welche aktualisiert wurden. Ein leerer Wert löscht das Attribut.
  • Das Löschen eines Attributs ist endgültig und entfernt seine gespeicherten Werte von allen Produkten. Der Assistent warnt Sie.

Statistiken

Fragen Sie nach…Werkzeug
„Wie liefen meine QR-Codes letzte Woche?"get_brand_scan_stats
„Zeig den Scan-Verlauf für GTIN … pro Woche."get_digital_link_scan_stats

Brand-Statistiken enthalten Gesamt-Scans, eindeutige Scanner, Erfolgs-/Fehlerquoten und eine Aufschlüsselung pro Produkt. Link-Statistiken enthalten einen Zeitverlauf pro Tag, Woche oder Monat. Alles lässt sich nach Zeitraum filtern.

Sicherheit

  • Anmeldung und Zustimmung: Ihr Assistent sieht niemals Ihr Passwort. Er erhält Zugriff über die prod.link-Anmeldeseite, und Sie bestätigen den Zugriff ausdrücklich auf einem Zustimmungsbildschirm.
  • Ihre Berechtigungen, nicht mehr: Der Assistent kann nur mit Brands arbeiten, auf die Ihr Konto Zugriff hat.
  • Bestätigung von Aktionen: KI-Clients zeigen Werkzeugaufrufe vor der Ausführung an. Lesen Sie sie — besonders bei Löschungen und Landing-Page-Änderungen, die sofort live sind.
  • Trennen: Entfernen Sie den Connector in den Einstellungen Ihres KI-Clients, um weiteren Zugriff zu beenden.

Problembehebung

SymptomErklärung
„You do not have access to this Brand"Die Brand-ID ist falsch oder Ihrem Konto fehlen Berechtigungen. Lassen Sie den Assistenten zuerst list_brands ausführen.
„Digital link limit exceeded"Das Link-Limit Ihres Abonnements ist erreicht. Die Meldung enthält den aktuellen Stand und die verbleibende Kapazität.
„This Digital Link has a Digital Product Pass"Ein Produkt kann entweder eine Landing Page oder einen Product Pass haben, nicht beides.
Eine neue Landing Page ist „nicht live"Seiten gehen erst live, wenn sie einem Digital Link zugewiesen sind. Bitten Sie den Assistenten um die Zuweisung.
Scans erreichen die Landing Page nichtDie Seite wurde zugewiesen, ohne sie zum Standard-Link zu machen. Bitten Sie den Assistenten, sie als Standard-Resolver-Link zu setzen.
Anmeldefenster erscheint nichtStarten Sie die Verbindung im KI-Client neu; in Claude Code: /mcp → authentifizieren.