Verbinde deinen Shopify-Shop mit Claude und ChatGPT.

Ein Remote-MCP-Server, einer pro Shop. Jeder Shop, den du mit BoostEcom verbindest, erhält seinen eigenen Endpunkt, der Model Context Protocol über streamfähiges HTTP spricht. Jeder Client, der MCP spricht (Claude, ChatGPT, Claude Code, Cursor oder ein eigener), kann ihn finden, sich dort autorisieren und seine Tools aufrufen.

Deine Shopify-Zugangsdaten verlassen nie unsere Server. Der Client hält ein BoostEcom-Token; das kurzlebige Shopify-Token, das die BoostEcom-App delegiert, bleibt bei uns, verschlüsselt gespeichert. Widerrufst du das BoostEcom-Token, ist der Client draußen, ohne je ein Shopify-Secret gesehen zu haben.

• MCP, aus deinem KI-ClientClaude, ChatGPT, Claude Code und Cursor lesen den Shop live, per OAuth oder mit statischem Schlüssel. Nur lesend.
• Das Dashboard, mit @AtlasDer einzige Ort, an dem geschrieben wird, jedes Mal nach deiner Freigabe. Gleicher Shop, gleiche BoostEcom-App.
• Intelligence, aus deinem Client oder deinem CodeDer Shopify-Store-Graph hat einen eigenen MCP-Server und eine lesende REST API mit bei_-Schlüssel. Marktdaten, nie die deines Shops.
• Ein öffentliches UCP-ProfilWenn BoostEcom den öffentlichen Katalog eines anderen Shops liest, zeigt es dieses Profil: nur Katalogsuche und Abruf, kein Warenkorb, kein Checkout, kein Geheimnis.

https://www.boostecom.app/api/mcp/v1/<STORE_ID>

https://www.boostecom.app/api/mcp/intelligence

https://www.boostecom.app/.well-known/ucp-agent

Du installierst die BoostEcom-App aus deinem Shopify-Admin und wählst in der App, worauf sie zugreifen darf. Deine Freigabe ist die Obergrenze: Wir fügen keinen eigenen Zugriff hinzu.

• OAuth 2.1 mit PKCE, kein Client-Secret zum Aufbewahren
• Jedes Token öffnet genau einen Shop und wird nur als Hash gespeichert
• Ein statischer Schlüssel für CI und Läufe ohne Browser

https://www.boostecom.app/api/mcp/v1/<STORE_ID>

GET https://www.boostecom.app/.well-known/oauth-authorization-server
GET https://www.boostecom.app/.well-known/oauth-protected-resource/api/mcp/v1/<STORE_ID>
GET https://www.boostecom.app/api/mcp/<STORE_ID>/.well-known/oauth-protected-resource

1. 1

   Dein Client ruft den Endpoint ohne Token auf und bekommt eine 401, deren WWW-Authenticate-Header auf unsere Discovery-Dokumente zeigt (RFC 9728).

2. 2

   Er liest das Protected-Resource-Dokument, das diesen Origin als Autorisierungsserver nennt.

3. 3

   Er liest die Metadaten des Autorisierungsservers (RFC 8414) und findet dort die Endpoints für Registrierung, Autorisierung, Token und Widerruf.

4. 4

   Er weist sich mit einem Client ID Metadata Document aus, einer https-URL, die wir abrufen und prüfen, oder per dynamischer Registrierung (RFC 7591). Es wird kein Secret ausgegeben, PKCE S256 ist Pflicht.

5. 5

   Du bestätigst einen Consent-Screen, der die Berechtigungen in Klartext nennt und nur die zeigt, die die Zugriffe der BoostEcom-App erfüllen können.

6. 6

   Der Client tauscht seinen Einmalcode gegen einen Access Token, der nach 60 Minuten abläuft, und einen Refresh Token, der bei jeder Nutzung rotiert.

7. 7

   Ein Tool außerhalb der Freigabe antwortet mit 403 und dem genauen Scope, den der Client anfragen muss: Er autorisiert sich für genau diesen Scope neu und versucht es erneut.

8. 8

   Trennst du den Client, ruft er den Widerrufs-Endpoint auf (RFC 7009): Der Token stirbt auch bei uns, nicht nur im Speicher des Clients.

Jeder Token öffnet genau einen Shop: Ein Token für Shop A wird auf Shop B abgelehnt, und die Mitgliedschaft in der Organisation wird bei jedem Aufruf erneut geprüft. Tokens liegen als SHA-256-Hashes vor, nie in einer Form, die wir zurücklesen könnten.

HTTP/1.1 401 Unauthorized
WWW-Authenticate: Bearer realm="BoostEcom MCP",
  resource_metadata="https://www.boostecom.app/.well-known/oauth-protected-resource/api/mcp/v1/<STORE_ID>",
  scope="boostecom:store.read boostecom:catalog.read …"

{
  "access_token": "<ACCESS_TOKEN>",
  "token_type": "Bearer",
  "expires_in": 3600,
  "refresh_token": "<REFRESH_TOKEN>",
  "scope": "boostecom:store.read boostecom:catalog.read"
}

HTTP/1.1 403 Forbidden
WWW-Authenticate: Bearer error="insufficient_scope",
  scope="boostecom:orders.read",
  resource_metadata="https://www.boostecom.app/.well-known/oauth-protected-resource/api/mcp/v1/<STORE_ID>"

• Schreibzugriffe abgelehnt, bevor Shopify sie sieht
• Jeder Schreibversuch landet in deinem Audit-Log
• Änderungen laufen über die Freigabe im Dashboard

tools/call shopifyAdminGraphQL

mutation {
  productUpdate(product: { id: "gid://shopify/Product/1", title: "New title" }) {
    product { id }
  }
}

{
  "isError": true,
  "content": [
    {
      "type": "text",
      "text": "Refused: this mutation is classified destructive (product/price updates, discounts, inventory, …). This connector is read-only: every write requires human approval. Run it from the BoostEcom dashboard chat, where the approval flow lives."
    }
  ]
}

• Der Zustand des ShopsEin einziger runAudit-Aufruf liefert Shop, Themes und eine Produktstichprobe zusammen, damit das Modell über den ganzen Shop nachdenkt, statt vier Anfragen zusammenzunähen.
• Fragen zum KatalogWelche Produkte noch Entwürfe sind, was ausverkauft ist, welche Handles kollidieren: beantwortet mit Live-Daten, nicht mit einem veralteten Export im Chat.
• Alles, was die Admin API liestMetafelder, Märkte, Übersetzungen, Bestände: ein Passthrough-Tool, mit Shopifys eigenen Kostenwerten, damit das Modell sein Tempo selbst regelt.
• Reporting, wo du arbeitestFass die Bestellungen der Woche im Client zusammen, den du schon offen hast, ohne Kundendaten erst in eine Tabelle zu exportieren.

• Die Scopes, die du der BoostEcom-App gewährt hast, entscheiden, was durchgeht, und Shopify setzt sie bei jeder Abfrage durch
• Shopifys eigene Kosten- und Drosselwerte kommen mit den Daten zurück, damit das Modell sein Tempo regelt
• Eine Mutation über dieses Tool wird abgelehnt wie jeder andere Schreibzugriff

tools/call shopifyAdminGraphQL

query {
  markets(first: 5) { nodes { name handle } }
  shop { metafields(first: 5) { nodes { key value } } }
}

{
  "data": { "markets": { … }, "shop": { … } },
  "cost": { "requestedQueryCost": <n>, "actualQueryCost": <n> },
  "throttleStatus": {
    "maximumAvailable": <n>,
    "currentlyAvailable": <n>,
    "restoreRate": <n>
  }
}

1. 1

   Shop verbinden

   Erstell dein Konto und installiere die BoostEcom-App mit einem Klick aus deinem Shopify-Admin. Die Zugriffe, die du in der App wählst, sind die Obergrenze für alles, was folgt.

   Shopify-Rechte, die Tools freischalten

   • read_products
   • read_orders
   • read_content
   • read_themes
   • read_analytics
   • read_reports
2. 2

   URL in deinen Client einfügen

   Claude und ChatGPT nehmen sie als benutzerdefinierten Konnektor auf. Claude Code und Cursor lesen sie aus ihrer Konfiguration und öffnen dann denselben Zustimmungsbildschirm.

   Die URL zum Einfügenurl

   https://www.boostecom.app/api/mcp/v1/<STORE_ID>

   Kopieren
3. 3

   Scopes freigeben

   Der Zustimmungsbildschirm nennt jede Berechtigung im Klartext und bietet nur an, was du der BoostEcom-App gewährt hast.

   Was dein Client anfragthttp

   GET https://www.boostecom.app/oauth/authorize
     ?response_type=code&client_id=<CLIENT_ID>
     &resource=https://www.boostecom.app/api/mcp/v1/<STORE_ID>
     &scope=boostecom:store.read boostecom:catalog.read
     &code_challenge=<S256>&code_challenge_method=S256

   Kopieren
4. 4

   Deinen Shop befragen

   Dein Client listet die Tools, die deine Freigabe geöffnet hat, und ruft sie auf, sobald eine Frage Live-Daten braucht.

   Was dein Client auflisten kann

   • getStoreContext
   • getShopInfo
   • runAudit
   • listProducts
   • getProduct
   • listOrders
   • listPages
   • getMetafields
   • listMetaobjectDefinitions
   • listMetaobjects
   • listThemes
   • getTheme
   • runShopifyQL
   • introspectSchema
   • shopifyAdminGraphQL
   • getStudioSection
   • getStudioProduction
   • listStudioGenerations
   • getStudioPricing
   • getStoreIntelligence
   • listThemeUpdates
   • getUpdateJob
   • listBackups
   • getUptime
   • getAppEmbedStatus
   • getDomainHealth
   • getActionRequest
   • searchDocs
   • getDoc
   • helmListModels
   • helmPlanSection

Tokens, die vor diesem Katalog ausgestellt wurden, tragen die alte mcp-Freigabe. Sie behält die Shopify-Lesetools, die sie schon hatte, und öffnet nie ein BoostEcom-System: Studio, Store Intelligence und die Doku-Tools brauchen einen auf dem Consent-Screen bestätigten Scope.

• Ohne Konto und Schlüssel: 60 Aufrufe pro Minute und IP
• Ein bei_-Schlüssel hebt das auf 6.000 pro Minute, pro Organisation
• Nur öffentliche Datensätze

{
  "mcpServers": {
    "boostecom-intelligence": {
      "url": "https://www.boostecom.app/api/mcp/intelligence"
    }
  }
}

curl -s https://www.boostecom.app/api/mcp/intelligence/manifest

Ansehen, was Intelligence liest

Gemessen an einem Shop, der über die Custom App eines Händlers verbunden war: Ein Shop, der weniger Scopes gewährt, bekommt weniger. Mit der BoostEcom-App ist die Obergrenze das, was du der App gewährst.

Custom-Tarife laufen ohne Limit. Ein abgelehnter Aufruf nennt den Tarif, das erreichte Limit und den nächsten Schritt.

• Es schreibt nicht. Jeder Schreibzugriff wird abgelehnt und protokolliert. Eine Änderung an deinem Shop läuft über das Dashboard, dort gibst du sie frei.
• Es bleibt in dem, was du der App gewährt hast. Ein Tool, das deine Shopify-Rechte nicht abdecken, wird gar nicht erst registriert. Dein Client bekommt es nie zu sehen.
• Ein statischer Schlüssel reicht nur für 15 Tools. Ein Schlüssel steht für einen Shop, nie für eine Person. Studio, Store Intelligence, die Daten der BoostEcom-App und die Doku-Tools brauchen eine OAuth-Anmeldung.
• Eine Anfrage, 30 Sekunden. Ein längerer Tool-Aufruf wird abgebrochen. Lange Arbeit gehört in einen Workflow im Dashboard, nicht in einen Tool-Aufruf.
• Keine eigene API und kein SDK. Unterstützt sind dieser Endpoint, der Intelligence-MCP-Server und die Intelligence REST API. Das GraphQL, das du erreichst, ist das von Shopify, über den Passthrough.