Prototyp · Vorschau: alle Server aus der offiziellen Registry, alle 30 Minuten synchronisiert. Mit Google anmelden, um Bewertungen zu schreiben.
PopNx MCPMCP-Server für alle, die KI nutzen · in einfachen Worten erklärt
☰ MenüDeutsch Einstellungen
Einsteigermodus Aus
FarbenSystemHellDunkel
SpracheไทยEnglish中文日本語한국어EspañolDeutsch

Crystallize MCP

von HayoDevVersion 0.2.0i★ 0iLäuft auf deinem Computer
Name in der Registryio.github.HayoDev/crystallize-mcp

So installierst du es

Überblick

Beschreibung vom Entwickler (englisches Original)

Crystallize headless commerce tools for AI agents via Model Context Protocol

Was du damit machen kannst

Für diesen Server haben wir noch keine Zusammenfassung in einfacher Sprache geschrieben. Unten stehen die Fakten, die wir aus der Registry gelesen haben.

  • Verbindung: Läuft auf deinem Computer
  • Transport: stdio
  • Kategorie: Onlineshops & Zahlungen

Installation

Wähle die KI-App, die du nutzt, und kopiere die Einstellungen.

2/3 Prüfungen bestanden · Läuft auf deinem Computer

Zuerst: Welche KI nutzt du?

Wähle deine App, dann erscheinen die Schritte unten.

Klappt mit Claude, aber erst etwas vorbereiten

Du brauchst einen Schlüssel von Crystallize MCP (auf der Seite des Anbieters registrieren, kann kosten) · Installiere zuerst Node.js auf deinem Computer (nur einmal) · Nur in der Claude-App für den Computer (Windows oder Mac), nicht im Web oder auf dem Handy

  1. Node.js installieren

    Nur einmal; gilt für alle Server, die Node.js brauchen

    Download-Seite von Node.js öffnen ↗

  2. Bei Crystallize MCP registrieren und Schlüssel erstellen

    Öffne die Seite des Anbieters, registriere dich und erstelle einen API-Schlüssel für den nächsten Schritt. Kann Geld kosten.

    Wie du einen Schlüssel bekommst, steht unten im README des Anbieters

  3. Einstellungsdatei der Claude-Desktop-App öffnen

    SettingsDeveloperEdit Config

  4. Diese Einstellungen einfügen und speichern

    {
  "mcpServers": {
    "crystallize": {
      "command": "npx",
      "args": [
        "-y",
        "@hayodev/crystallize-mcp"
      ],
      "env": {
        "CRYSTALLIZE_TENANT_IDENTIFIER": "your-value",
        "CRYSTALLIZE_ACCESS_TOKEN_ID": "your-value",
        "CRYSTALLIZE_ACCESS_TOKEN_SECRET": "your-value",
        "CRYSTALLIZE_STATIC_AUTH_TOKEN": "your-value",
        "CRYSTALLIZE_ACCESS_MODE": "your-value"
      }
    }
  }
}

    Füge den Schlüssel nur in das Feld der App ein, nie in einen Chat und schick ihn niemandem

  5. Claude beenden und neu öffnen

  6. Ausprobieren

    Nutze Crystallize MCP und sag mir, was du für mich tun kannst; zeig mir dann eine Sache

    ✓ Wenn Claude sagt, dass es Crystallize MCP nutzt, oder ein Werkzeug von Crystallize MCP in der Antwort zeigt, bist du verbunden

Menünamen am 11. Nov. 2026 mit der Hilfe von Anthropic abgeglichen · dein Bildschirm kann je nach App-Version leicht abweichen

ChatGPT kann Crystallize MCP noch nicht verbinden

Crystallize MCP läuft auf deinem Computer, aber ChatGPT verbindet nur Server, die im Web laufen

Das kannst du stattdessen tun

A · Eine App nutzen, die Crystallize MCP verbinden kann

  • Du brauchst einen Schlüssel von Crystallize MCP (auf der Seite des Anbieters registrieren, kann kosten) · Installiere zuerst Node.js auf deinem Computer (nur einmal) · Nur in der Claude-App für den Computer (Windows oder Mac), nicht im Web oder auf dem Handy
  • Du brauchst einen Schlüssel von Crystallize MCP (auf der Seite des Anbieters registrieren, kann kosten) · Installiere zuerst Node.js auf deinem Computer (nur einmal)
  • Du brauchst einen Schlüssel von Crystallize MCP (auf der Seite des Anbieters registrieren, kann kosten) · Installiere zuerst Node.js auf deinem Computer (nur einmal)
  • Du brauchst einen Schlüssel von Crystallize MCP (auf der Seite des Anbieters registrieren, kann kosten) · Installiere zuerst Node.js auf deinem Computer (nur einmal)

B · Andere in Onlineshops & Zahlungen, die mit ChatGPT funktionieren

Aus den meistgenutzten derselben Kategorie, nur solche, die per Adresse ohne Schlüssel verbinden

Klappt mit Claude Code, aber erst etwas vorbereiten

Du brauchst einen Schlüssel von Crystallize MCP (auf der Seite des Anbieters registrieren, kann kosten) · Installiere zuerst Node.js auf deinem Computer (nur einmal)

  1. Node.js installieren

    Nur einmal; gilt für alle Server, die Node.js brauchen

    Download-Seite von Node.js öffnen ↗

  2. Bei Crystallize MCP registrieren und Schlüssel erstellen

    Öffne die Seite des Anbieters, registriere dich und erstelle einen API-Schlüssel für den nächsten Schritt. Kann Geld kosten.

    Wie du einen Schlüssel bekommst, steht unten im README des Anbieters

  3. Terminal öffnen

    Mac: Command+Leertaste drücken und Terminal tippen · Windows: PowerShell öffnen

  4. Diesen Befehl einfügen und Enter drücken

    claude mcp add crystallize --env CRYSTALLIZE_TENANT_IDENTIFIER=your-value --env CRYSTALLIZE_ACCESS_TOKEN_ID=your-value --env CRYSTALLIZE_ACCESS_TOKEN_SECRET=your-value --env CRYSTALLIZE_STATIC_AUTH_TOKEN=your-value --env CRYSTALLIZE_ACCESS_MODE=your-value -- npx -y @hayodev/crystallize-mcp

    Ersetze „your-value“ vor dem Enter durch deinen Schlüssel

    Füge den Schlüssel nur in das Feld der App ein, nie in einen Chat und schick ihn niemandem

  5. /mcp in Claude Code eingeben

    Crystallize MCP sollte in der Liste als verbunden erscheinen

  6. Ausprobieren

    Nutze Crystallize MCP und sag mir, was du für mich tun kannst; zeig mir dann eine Sache

    ✓ Wenn Claude Code sagt, dass es Crystallize MCP nutzt, oder ein Werkzeug von Crystallize MCP in der Antwort zeigt, bist du verbunden

Menünamen am 11. Nov. 2026 mit der Hilfe von Anthropic abgeglichen · dein Bildschirm kann je nach App-Version leicht abweichen

Klappt mit Cursor, aber erst etwas vorbereiten

Du brauchst einen Schlüssel von Crystallize MCP (auf der Seite des Anbieters registrieren, kann kosten) · Installiere zuerst Node.js auf deinem Computer (nur einmal)

  1. Node.js installieren

    Nur einmal; gilt für alle Server, die Node.js brauchen

    Download-Seite von Node.js öffnen ↗

  2. Bei Crystallize MCP registrieren und Schlüssel erstellen

    Öffne die Seite des Anbieters, registriere dich und erstelle einen API-Schlüssel für den nächsten Schritt. Kann Geld kosten.

    Wie du einen Schlüssel bekommst, steht unten im README des Anbieters

  3. Mit diesem Button Cursor öffnen

    In Cursor öffnen

    Cursor fragt nach einer Bestätigung; klicke Install

  4. Schlüssel eintragen

    In den Einstellungen von Crystallize MCP ist CRYSTALLIZE_TENANT_IDENTIFIER, CRYSTALLIZE_ACCESS_TOKEN_ID, CRYSTALLIZE_ACCESS_TOKEN_SECRET, CRYSTALLIZE_STATIC_AUTH_TOKEN, CRYSTALLIZE_ACCESS_MODE leer; trag deinen Schlüssel ein und speichere

    Füge den Schlüssel nur in das Feld der App ein, nie in einen Chat und schick ihn niemandem

  5. KI-Chat in Cursor im Agent-Modus öffnen

  6. Ausprobieren

    Nutze Crystallize MCP und sag mir, was du für mich tun kannst; zeig mir dann eine Sache

    ✓ Wenn Cursor sagt, dass es Crystallize MCP nutzt, oder ein Werkzeug von Crystallize MCP in der Antwort zeigt, bist du verbunden

Menünamen am 11. Nov. 2026 mit der Hilfe von Cursor abgeglichen · dein Bildschirm kann je nach App-Version leicht abweichen

Klappt mit VS Code, aber erst etwas vorbereiten

Du brauchst einen Schlüssel von Crystallize MCP (auf der Seite des Anbieters registrieren, kann kosten) · Installiere zuerst Node.js auf deinem Computer (nur einmal)

  1. Node.js installieren

    Nur einmal; gilt für alle Server, die Node.js brauchen

    Download-Seite von Node.js öffnen ↗

  2. Bei Crystallize MCP registrieren und Schlüssel erstellen

    Öffne die Seite des Anbieters, registriere dich und erstelle einen API-Schlüssel für den nächsten Schritt. Kann Geld kosten.

    Wie du einen Schlüssel bekommst, steht unten im README des Anbieters

  3. Mit diesem Button VS Code öffnen

    In VS Code öffnen

    VS Code fragt nach einer Bestätigung; klicke Install

  4. Schlüssel eintragen

    In den Einstellungen von Crystallize MCP ist CRYSTALLIZE_TENANT_IDENTIFIER, CRYSTALLIZE_ACCESS_TOKEN_ID, CRYSTALLIZE_ACCESS_TOKEN_SECRET, CRYSTALLIZE_STATIC_AUTH_TOKEN, CRYSTALLIZE_ACCESS_MODE leer; trag deinen Schlüssel ein und speichere

    Füge den Schlüssel nur in das Feld der App ein, nie in einen Chat und schick ihn niemandem

  5. KI-Chat in VS Code im Agent-Modus öffnen

  6. Ausprobieren

    Nutze Crystallize MCP und sag mir, was du für mich tun kannst; zeig mir dann eine Sache

    ✓ Wenn VS Code sagt, dass es Crystallize MCP nutzt, oder ein Werkzeug von Crystallize MCP in der Antwort zeigt, bist du verbunden

Menünamen am 11. Nov. 2026 mit der Hilfe von VS Code abgeglichen · dein Bildschirm kann je nach App-Version leicht abweichen

Andere Apps mit MCP, etwa Windsurf, Zed oder Gemini CLI, fügen Server unterschiedlich hinzu. Sieh in der App-Liste nach

Alle Apps mit MCP ansehen →

JSON-Einstellungen stehen unten unter „Für Entwickler“

Hängst du fest? Frag Leute, die Crystallize MCP nutzen💬 Diskussion →
Für Entwickler: Terminal-Befehle und JSON-Einstellungen

Auf deinem Computer installiert

Claude Code

claude mcp add crystallize --env CRYSTALLIZE_TENANT_IDENTIFIER=your-value --env CRYSTALLIZE_ACCESS_TOKEN_ID=your-value --env CRYSTALLIZE_ACCESS_TOKEN_SECRET=your-value --env CRYSTALLIZE_STATIC_AUTH_TOKEN=your-value --env CRYSTALLIZE_ACCESS_MODE=your-value -- npx -y @hayodev/crystallize-mcp

Claude Desktop (claude_desktop_config.json)

{
  "mcpServers": {
    "crystallize": {
      "command": "npx",
      "args": [
        "-y",
        "@hayodev/crystallize-mcp"
      ],
      "env": {
        "CRYSTALLIZE_TENANT_IDENTIFIER": "your-value",
        "CRYSTALLIZE_ACCESS_TOKEN_ID": "your-value",
        "CRYSTALLIZE_ACCESS_TOKEN_SECRET": "your-value",
        "CRYSTALLIZE_STATIC_AUTH_TOKEN": "your-value",
        "CRYSTALLIZE_ACCESS_MODE": "your-value"
      }
    }
  }
}

Cursor (~/.cursor/mcp.json)

{
  "mcpServers": {
    "crystallize": {
      "command": "npx",
      "args": [
        "-y",
        "@hayodev/crystallize-mcp"
      ],
      "env": {
        "CRYSTALLIZE_TENANT_IDENTIFIER": "your-value",
        "CRYSTALLIZE_ACCESS_TOKEN_ID": "your-value",
        "CRYSTALLIZE_ACCESS_TOKEN_SECRET": "your-value",
        "CRYSTALLIZE_STATIC_AUTH_TOKEN": "your-value",
        "CRYSTALLIZE_ACCESS_MODE": "your-value"
      }
    }
  }
}

VS Code (mcp.json)

{
  "servers": {
    "crystallize": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@hayodev/crystallize-mcp"
      ],
      "env": {
        "CRYSTALLIZE_TENANT_IDENTIFIER": "your-value",
        "CRYSTALLIZE_ACCESS_TOKEN_ID": "your-value",
        "CRYSTALLIZE_ACCESS_TOKEN_SECRET": "your-value",
        "CRYSTALLIZE_STATIC_AUTH_TOKEN": "your-value",
        "CRYSTALLIZE_ACCESS_MODE": "your-value"
      }
    }
  }
}

Werte, die du selbst einträgst

  • CRYSTALLIZE_TENANT_IDENTIFIER env
    Your Crystallize tenant identifier (e.g. 'my-store'). Find it in your Crystallize dashboard URL: app.crystallize.com/{tenant}
  • CRYSTALLIZE_ACCESS_TOKEN_ID env
    Access Token ID for authenticated API access. Create one at Settings > Access Tokens in your Crystallize dashboard. Optional — public catalogue and Discovery API work without auth.
  • CRYSTALLIZE_ACCESS_TOKEN_SECRET env
    Access Token Secret (paired with Access Token ID).
  • CRYSTALLIZE_STATIC_AUTH_TOKEN env
    Static auth token (alternative to token ID/secret pair). Read-only.
  • CRYSTALLIZE_ACCESS_MODE env
    Controls which tools are available: 'read' (default, safe), 'write' (can create/update items), 'admin' (full access including webhooks).

Diese Einstellungen werden aus dem Registry-Eintrag des Entwicklers erzeugt. Wenn in der README etwas anderes steht, folge der README.

Auf einen Blick

Downloads pro Wochei
63/Wo.
Verbindung
Läuft auf deinem Computer
Neueste Versioni
0.2.0
In der Registry veröffentlichti
10. Apr. 2026
Code zuletzt geänderti
13. Apr. 2026
Entwickler
HayoDev
Pakete
npm: @hayodev/crystallize-mcp
Registry-Status
Aktiv

Welche Apps ihn nutzen können

Basierend darauf, wie sich dieser Server verbindet, und auf der eigenen Doku jeder App, geprüft am 10. Nov. 2026.

Laufen auf deinem Computer in

ClaudeGooseLM StudioMsty StudioCherry StudioCursorVS Code + GitHub CopilotVisual StudioWindsurf (Devin Desktop)ZedKiroClineContinueJetBrains AI AssistantClaude CodeCodex CLIGemini CLIOpenCodenodecodeWarpLibreChatRaycast

Alle Apps, mit Vor- und Nachteilen →

Was er kann

Läuft auf deinem Computer; die Tool-Liste erscheint nach der Installation in deiner KI-App.

Basischecksi

Wir prüfen Informationen, die jeder sehen kann; den Code haben wir nicht gelesen. Checks, die nicht zutreffen, werden nicht mitgezählt. · Geprüft am 11. Nov. 2026

  • ✓ Bestanden

    Entwickler passt zum Repo

    Der Registry-Name wurde mit dem GitHub-Konto HayoDev bestätigt, dem das Repo gehört

  • ! Vorsicht

    Wird noch gepflegt

    Code zuletzt geändert: vor 7 Monaten, vor mehr als 6 Monaten

  • ✓ Bestanden

    Hat eine Lizenz

    Nutzt MIT

  • – Nicht zutreffend

    Endpunkt antwortet

    Dieser Server läuft auf deinem Computer; es gibt keinen Endpunkt im Internet

  • – Nicht zutreffend

    Anmeldung mit OAuth

    Läuft auf deinem Computer und nutzt stattdessen lokale Einstellungen

  • … Noch nicht geprüft

    Keine versteckten Anweisungen in Tool-Beschreibungen

    Läuft auf deinem Computer; Tool-Listen können wir nur von Endpunkten im Internet lesen

Diskussion

Fragen, Tipps teilen oder melden, dass etwas nicht geht. Sortiert nach „hilfreich“.

Noch keine Beiträge. Stell die erste Frage oder teile einen Tipp.

Beiträge hier stammen von Nutzern, nicht vom PopNx-Team.

Mit Google anmelden, um zu posten

Nutzerbewertungen

Noch keine Bewertungen

Mit Google anmelden, um zu bewerten

Im Vergleich mit anderen in Onlineshops & Zahlungeni

  • Mehr Sterne als 0 % der anderen 2717 Server in dieser Kategorie
  • Neuer in der Registry veröffentlicht als 4 % der anderen 2717 Server in dieser Kategorie
  • Basischecks gleich gut wie oder besser als bei 57 % der anderen 2717 Server in dieser Kategorie

Verglichen mit allen aktiven Servern dieser Kategorie in der Registry. Sterne zählen nur, wenn dem Herausgeber das Repo gehört.

Häufige Fragen

Ist Crystallize MCP sicher?

Er hat 2 von 3 zutreffenden Basischecks bestanden. Den Code haben wir nicht gelesen. Bevor du einen Schlüssel oder Token hinzufügst, sieh nach, welche Zugriffe der Server verlangt, und nutze einen Schlüssel, der nur die Berechtigungen hat, die du brauchst.

Welche Schlüssel oder Codes braucht er?

Die Registry nennt keinen erforderlichen Schlüssel, manche Server bitten dich aber bei der ersten Nutzung, dich anzumelden.

Läuft er auf meinem Computer oder in der Cloud?

Er läuft auf deinem Computer. Deine KI-App startet ihn bei Bedarf, und die Daten laufen nicht über die Server des Entwicklers (außer der Server ruft selbst einen Onlinedienst auf).

Wird er noch gepflegt?

Das GitHub-Repo wurde zuletzt vor 7 Monaten geändert, und die neueste Version (0.2.0) kam vor 7 Monaten in die Registry.

Welche Apps können ihn nutzen?

Apps, die MCP unterstützen, etwa Claude Desktop, Claude Code, Cursor und VS Code. Außerdem brauchst du Node.js auf deinem Computer.

Was kann ich stattdessen nutzen?

In derselben Kategorie: Spree Commerce developer docs for AI agents, Stripe MCP, Sessy — Amazon SES observability

Alternativen

Server derselben Kategorie von anderen Entwicklern, sortiert nach Sternen.

So liest du eine Karte:↓ Downloads pro Wochei★ GitHub-SterneiDrei Säulen: Bewertungen · Checks · NutzungiAktualisiert = neueste Version in der Registry veröffentlichti

Stripe MCP

MCP server integrating with Stripe - tools for customers, products, payments, and more.

von stripeWeit verbreitet★ 2054Aktualisiert vor 13 Monaten

Läuft in der Cloud✓ stripe.com
Installieren

README vom Entwickler

README öffnen

Unverändert aus dem Repo des Entwicklers übernommen. PopNx MCP hat den Inhalt weder geprüft noch empfiehlt es ihn. HTML, Bilder und Skripte wurden entfernt. Links führen von dieser Website weg.

Crystallize MCP

MCP server for Crystallize headless commerce. Gives AI agents read and write access to your catalogue, products, shapes, orders, customers, and tenant config — with deep links back to the Crystallize UI, dry-run safety for mutations, and PII masking for customer data.

Works with Claude Code, Claude Desktop, Cursor, Windsurf, Copilot, and any MCP-compatible client.

Getting started

Setup wizard

The interactive wizard handles config, auth tokens, keychain storage, and PII mode in one step:

# Project-level — writes .mcp.json in the current directory (shared with your team)

npx @hayodev/crystallize-mcp --setup

Global — registers via claude mcp add (Claude Code) or writes Claude Desktop config

npx @hayodev/crystallize-mcp --setup --global

Manual config

Standard MCP config (works in any client):

{

"mcpServers": { "crystallize": { "command": "npx", "args": ["-y", "@hayodev/crystallize-mcp@latest"], "env": { "CRYSTALLIZE_TENANT_IDENTIFIER": "your-tenant" } } } }

Add CRYSTALLIZE_ACCESS_TOKEN_ID and CRYSTALLIZE_ACCESS_TOKEN_SECRET to the env block for PIM tools (shapes, orders, customers). See Authentication.

Claude Code (CLI)

claude mcp add crystallize \

-e CRYSTALLIZE_TENANT_IDENTIFIER=your-tenant \ -e CRYSTALLIZE_ACCESS_TOKEN_ID=your-token-id \ -e CRYSTALLIZE_ACCESS_TOKEN_SECRET=your-token-secret \ -- npx -y @hayodev/crystallize-mcp@latest

Use --scope project to write to .mcp.json (shared with your team) or --scope user for personal use across all projects.

Claude Desktop

Add the standard config to ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows).

Cursor

Add the standard config to your Cursor MCP settings (~/.cursor/mcp.json or the project-level .cursor/mcp.json).

VS Code / GitHub Copilot

Add the standard config to .vscode/mcp.json in your project root.

{

"servers": { "crystallize": { "command": "npx", "args": ["-y", "@hayodev/crystallize-mcp@latest"], "env": { "CRYSTALLIZE_TENANT_IDENTIFIER": "your-tenant", "CRYSTALLIZE_ACCESS_TOKEN_ID": "your-token-id", "CRYSTALLIZE_ACCESS_TOKEN_SECRET": "your-token-secret" } } } }

Windsurf

Add the standard config to ~/.codeium/windsurf/mcp_config.json.

Gemini CLI

Add the standard config to ~/.gemini/settings.json.

JetBrains AI Assistant

Add the standard config to .junie/mcp.json in your project root.

Warp

Add the standard config to ~/.warp/mcp.json.

Raycast

Open "Install MCP Server" in Raycast and fill in:

  • Command: npx
  • Arguments: -y @hayodev/crystallize-mcp@latest
  • Environment: add CRYSTALLIZE_TENANT_IDENTIFIER and your token vars

Or copy the standard config JSON above before opening the command — Raycast will auto-fill the form.

From source (maintainers)

The --local flag is for developing crystallize-mcp itself. It writes .mcp.json pointing to the local build output — run this from the repo root only:

git clone https://github.com/HayoDev/crystallize-mcp.git

cd crystallize-mcp npm install && npm run build npx . --setup --local # writes .mcp.json pointing to ./build/

Or point your MCP client directly at the built entry point:

{

"mcpServers": { "crystallize": { "command": "node", "args": ["/path/to/crystallize-mcp/build/src/bin/crystallize-mcp.js"], "env": { "CRYSTALLIZE_TENANT_IDENTIFIER": "your-tenant" } } } }

Tools (16)

Catalogue (4 tools)
ToolDescription
browse_catalogueTraverse the item tree by path
get_itemFetch an item by path or ID with full component data
search_catalogueKeyword search across all items
get_product_variantsList variants with pricing and stock
Discovery (3 tools)
ToolDescription
list_discovery_shapesList all shapes with their queryable fields
browse_shapeBrowse items of a shape with filters, pagination, and field selection
get_shape_fieldsDetailed field info for a specific shape
Shapes & Tenant (3 tools, requires auth)
ToolDescription
list_shapesAll shapes with component summaries
get_shapeFull component definition for a shape
get_tenant_infoTenant configuration and available languages
Orders (2 tools, requires auth)
ToolDescription
list_ordersList orders for a customer with pagination
get_orderFull order details — cart, payments, customer, totals
Customers (2 tools, requires auth)
ToolDescription
list_customersSearch and list customers with pagination
get_customerFull customer profile — addresses, meta, external references
Content (2 tools, requires auth + write mode)
ToolDescription
create_itemCreate a new item (product, document, or folder) with components
update_componentUpdate a single component value — supports nested content chunks via dot notation (e.g. hero.title)

Write tools

Write tools require CRYSTALLIZE_ACCESS_MODE=write (or admin) and a token with write permissions.

Dry-run mode

Set CRYSTALLIZE_DRY_RUN=true to preview mutations without executing them. The response shows exactly what would change — the mutation payload, before/after values, and a deep link to the item:

"env": {

"CRYSTALLIZE_ACCESS_MODE": "write", "CRYSTALLIZE_DRY_RUN": "true" }

Example prompts

Create an item:

"Create a new blog post under /blog using the article shape with title 'Getting Started'"

Update a top-level component:

"Find the item at /products/summer-collection and update its description to 'New summer arrivals'"

Update a component inside a content chunk:

"Get the item at /articles/my-post, then update hero.title to 'Updated Headline' and give me the deep link to review the draft"

Update with change summary:

"Get the item at /articles/guides/my-guide, update its title component to 'New Guide Title', give me the deep link, and show a table of which fields in the chunk changed vs remained unchanged with before/after values"

The agent will update the target component in draft only, preserve all sibling components in the chunk, and return a summary like:

ComponentStatusBeforeAfter
title✏️ UpdatedOld Guide TitleNew Guide Title
imageUnchanged_(existing image)__(existing image)_
descriptionUnchanged_(existing text)__(existing text)_

No publishing happens — you review the change in the Crystallize UI via the deep link and publish when ready.

Authentication

Catalogue and Discovery tools work without auth — just set CRYSTALLIZE_TENANT_IDENTIFIER.

For PIM tools (shapes, tenant info, orders, customers), create an access token at: https://app.crystallize.com/{tenant}/en/settings/access-tokens

Note: Crystallize tokens inherit permissions from the user who created them. To restrict an agent to read-only access, generate the token under a user with a read-only role. See Crystallize Roles.

Environment variables
VariableRequiredDescription
CRYSTALLIZE_TENANT_IDENTIFIERYesYour tenant identifier from app.crystallize.com/{tenant}
CRYSTALLIZE_ACCESS_TOKEN_IDNoAccess token ID for PIM API
CRYSTALLIZE_ACCESS_TOKEN_SECRETNoAccess token secret (paired with token ID)
CRYSTALLIZE_STATIC_AUTH_TOKENNoStatic auth token (alternative to ID/secret pair)
CRYSTALLIZE_ACCESS_MODENoread (default), write, or admin — controls which tools are registered
CRYSTALLIZE_DRY_RUNNotrue to preview write operations without executing — see Write tools
CRYSTALLIZE_PII_MODENofull (default), masked, or none — controls PII in customer/order responses
CRYSTALLIZE_AUDIT_LOGNoPath to write an audit log — ~ is expanded (e.g. ~/.crystallize-mcp/audit.log)
PII mode (opt-in)

By default all customer and order data is returned as-is (full). Set CRYSTALLIZE_PII_MODE to opt in to data minimisation:

ModeBehaviour
fullDefault — all fields returned unchanged
maskedEmails → h***@example.com, phones → ***-1234, addresses → city + country only

| none | Contact/PII fields stripped — names, emails, phones, addresses, meta

Nur der Anfang wird gezeigt; den Rest findest du im Repo