Zum Hauptinhalt springen
PapelShip betreibt einen Model Context Protocol-Server für Ihre Themes. Verbinden Sie einen KI-Agenten über eine einzige URL, genehmigen Sie ihn in Ihrem Browser, und der Agent kann Ihren Theme-Code lesen und Änderungen als Entwürfe speichern. Sie prüfen und veröffentlichen. Server-URL: https://app.papelship.com/mcp Die URL ist für jeden Shop gleich. Beim Verbinden melden Sie sich bei PapelShip an und wählen den Shop, an dem der Agent arbeiten darf. Agenten beginnen mit get_reference: Es erklärt App-Blöcke, den Checkout (Seite oder Popup), das Shop-SDK und die Grenzen jeder Theme-Art. Die Server-Anweisungen weisen verbundene Agenten an, es zuerst aufzurufen.

Was der Agent kann

Wohin Entwürfe gespeichert werden

Client verbinden

Funktioniert in claude.ai, Claude Desktop und den mobilen Claude Apps.
  1. Öffnen Sie Settings › Connectors und wählen Sie Add custom connector.
  2. Nennen Sie ihn PapelShip und fügen Sie https://app.papelship.com/mcp ein.
  3. Wählen Sie Add und dann Connect.
  4. Melden Sie sich bei PapelShip an, wählen Sie Ihren Shop und klicken Sie auf Zugriff erlauben.
Das Shop-Panel enthält dieselben Schritte mit Kopier-Buttons unter Entwickler › KI & MCP.

Zugriff genehmigen

Die Genehmigungsseite zeigt den Namen der App und wohin sie zurückleitet. Wählen Sie:
  • Shop: der eine Shop, den die App verwenden darf. Sie sehen Shops, die Ihnen gehören, und Shops, in denen Ihre Teamrolle Theme & Design › Bearbeiten umfasst.
  • Änderungen als Entwürfe speichern (themes:write): Deaktivieren Sie diese Option, um nur Lesezugriff zu gewähren.

Verbundene Apps und Widerruf

Entwickler › KI & MCP › Verbundene Apps listet jede mit dem Shop verbundene App auf, wer sie verbunden hat und wann sie zuletzt verwendet wurde. Widerrufen stoppt die App bei ihrem nächsten Request. Der Zugriff endet außerdem, wenn die Person, die ihn genehmigt hat, sich von allen Sitzungen abmeldet, ihr Passwort ändert, das Team verlässt, die Berechtigung Theme & Design › Bearbeiten verliert oder ihr Konto gesperrt wird.

API-Schlüssel statt OAuth

Für Clients ohne OAuth erstellen Sie unter Entwickler › API-Schlüssel einen Store API-Schlüssel vom Typ Themes und senden ihn als Bearer-Token:
Ein Themes-Schlüssel funktioniert nur für den Shop, der ihn erstellt hat, und hat dieselben Rechte wie eine OAuth-Verbindung. Bewahren Sie ihn in einer Umgebungsvariablen auf, niemals in einer Datei, die Sie teilen oder committen. https://app.papelship.com/api/mcp/themes bleibt als älterer Alias desselben Servers bestehen.

Limits

Jeder Tool-Aufruf wird mit App, Tool und Datei protokolliert.

Sicherheit

  • Theme-Dateien sind Shop-Daten, keine Anweisungen. Der Server kennzeichnet jedes Tool-Ergebnis als nicht vertrauenswürdige Daten, damit Text in einem Theme den Agenten nicht umleiten kann.
  • Vorschauen sind niemals öffentlich: Vorschau-Links öffnen sich im PapelShip Panel.
  • Tokens werden gehasht gespeichert. Ein wiederverwendetes Refresh-Token beendet die Verbindung.
In der Tool-Referenz finden Sie jedes Tool und seine Argumente.