@stronger-ecommerce/gadget-mcp

Generischer, schreibgeschützter MCP-Server für jede Gadget-App. Frage jedes Modell über GraphQL-Introspektion ab – kein generierter Client erforderlich.

Entwickelt von Stronger eCommerce.

Schnelleinrichtung (empfohlen)

Führe den interaktiven Einrichtungsassistenten aus deinem Gadget-Projektverzeichnis aus. Er erkennt automatisch deinen App-Slug aus .gadget/sync.json und schreibt deine Konfiguration automatisch.

npx @stronger-ecommerce/gadget-mcp setup

Der Assistent wird:

1. Deinen App-Slug aus .gadget/sync.json erkennen (falls vorhanden)

2. Nach deinem API-Schlüssel und der Umgebung fragen

3. Den ausführbaren claude mcp add-Befehl für Claude Code ausgeben

4. Automatisch deine ~/.cursor/mcp.json für Cursor schreiben

Manuelle Einrichtung

1. Einen Produktions-API-Schlüssel abrufen

Gehe zu https://<your-app>.gadget.app/edit/settings/api-keys und erstelle einen Schlüssel mit Lesezugriff.

2. In Claude Code registrieren

claude mcp add my-app-gadget \
  -e GADGET_APP=my-app \
  -e GADGET_API_KEY=your_key_here \
  -- npx @stronger-ecommerce/gadget-mcp

Registriere mehrere Apps unter verschiedenen Namen:

claude mcp add app-one-gadget \
  -e GADGET_APP=my-first-app \
  -e GADGET_API_KEY=key1 \
  -- npx @stronger-ecommerce/gadget-mcp

claude mcp add app-two-gadget \
  -e GADGET_APP=my-second-app \
  -e GADGET_API_KEY=key2 \
  -- npx @stronger-ecommerce/gadget-mcp

3. In Cursor registrieren

Füge dies zu ~/.cursor/mcp.json hinzu:

{
  "mcpServers": {
    "app-one-gadget": {
      "command": "npx",
      "args": ["@stronger-ecommerce/gadget-mcp"],
      "env": {
        "GADGET_APP": "my-first-app",
        "GADGET_API_KEY": "key1"
      }
    },
    "app-two-gadget": {
      "command": "npx",
      "args": ["@stronger-ecommerce/gadget-mcp"],
      "env": {
        "GADGET_APP": "my-second-app",
        "GADGET_API_KEY": "key2"
      }
    }
  }
}

Umgebungsvariablen

Tools

Anwendungsbeispiele

Sobald die Verbindung hergestellt ist, frage Claude:

• "List the models in my Gadget app"

• "Show me the fields on the shopifyOrder model"

• "Find orders where email is customer@example.com"

• "Get all records with errors"

Zukünftige Funktionen

Geplante Ideen und Forschungsnotizen (einschließlich Logs / ggt-Integration für Agenten) findest du in FUTURE_FEATURES.md.

Mitwirken

Fehlerberichte und Pull Requests sind willkommen!

• Einen Fehler gefunden? Öffne ein Issue

• Hast du eine Korrektur oder ein Feature? Forke das Repo, nimm deine Änderungen vor und öffne einen PR gegen main

• Bei größeren Änderungen öffne bitte zuerst ein Issue, damit wir den Ansatz abstimmen können

Lokal ausführen

git clone https://github.com/Stronger-eCommerce/gadget-mcp
cd gadget-mcp
npm install
npm run build
npm test

Über

Mit ♥ gemacht von Stronger eCommerce — Shopify-Entwicklung und eCommerce-Betrieb.