> ## Documentation Index
> Fetch the complete documentation index at: https://docs.wisepim.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Medusa-Integration

> Verbinde deinen Medusa-Shop mit WISEPIM. Erstelle einen Admin-API-Token, füge ihn in WISEPIM hinzu und beginne, deinen Katalog zu synchronisieren.

Verbinde deinen Medusa-Shop mit WISEPIM, um deinen gesamten Katalog an einem Ort zu verwalten. Medusa ist eine Open-Source-Headless-Commerce-Plattform. Sobald die Verbindung steht, kannst du Produkte importieren, sie mit AI anreichern und die verbesserten Inhalte zurück an Medusa senden.

Die Einrichtung erfolgt in zwei Schritten: Erstelle einen Admin-API-Token in Medusa und füge ihn anschließend in WISEPIM hinzu.

<Info>
  Du brauchst Admin-Zugriff auf dein Medusa-Backend und ein WISEPIM-Konto mit einem aktiven Projekt. WISEPIM verbindet sich über die Medusa Admin API.
</Info>

## Erstelle einen API-Token in Medusa

<img className="block dark:hidden" src="https://mintcdn.com/swiftsyncai/JPDjQoRySb31h-7U/images/marketing-screenshots/integrations/integration-configure-medusa-light-transparent.webp?fit=max&auto=format&n=JPDjQoRySb31h-7U&q=85&s=d33d3215866b79d33921ff7073381622" alt="Connecting Medusa to WISEPIM, store URL, API token, locale mapping and a live connection test" width="1478" height="1782" data-path="images/marketing-screenshots/integrations/integration-configure-medusa-light-transparent.webp" />

<img className="hidden dark:block" src="https://mintcdn.com/swiftsyncai/JPDjQoRySb31h-7U/images/marketing-screenshots/integrations/integration-configure-medusa-dark-transparent.webp?fit=max&auto=format&n=JPDjQoRySb31h-7U&q=85&s=4aae9e281b64e5bdc57a9eb4bf8456c9" alt="Connecting Medusa to WISEPIM, store URL, API token, locale mapping and a live connection test" width="1478" height="1782" data-path="images/marketing-screenshots/integrations/integration-configure-medusa-dark-transparent.webp" />

Medusa stellt einen API-Token für einen Admin-Benutzer mit Zugriff auf deinen Katalog aus.

<Steps>
  <Step title="Öffne dein Medusa-Admin">
    Melde dich an deinem Medusa-Admin-Dashboard mit einem Konto an, das Produkte verwalten kann.
  </Step>

  <Step title="Erstelle einen API-Key-Token">
    Öffne **Settings** > **API Key Management** und erstelle einen neuen **Secret**-API-Key (Admin) mit dem Namen WISEPIM.
  </Step>

  <Step title="Kopiere den Token">
    Kopiere den generierten Token jetzt. Er wird nur einmal angezeigt.
  </Step>

  <Step title="Notiere deine Shop-URL">
    Deine Shop-URL ist die Adresse deines Medusa-Backends, zum Beispiel `https://your-store.medusajs.com`.
  </Step>
</Steps>

## Füge deine Zugangsdaten in WISEPIM hinzu

Gib die Werte aus Medusa ein, um die Verbindung abzuschließen.

<Steps>
  <Step title="Öffne Integrationen">
    Melde dich bei WISEPIM an und gehe zu **Einstellungen** > **Integrationen**.
  </Step>

  <Step title="Wähle Medusa">
    Suche und klicke auf die **Medusa**-Integrationskachel.
  </Step>

  <Step title="Gib deine Zugangsdaten ein">
    Fülle die folgenden Felder aus:

    * **Medusa URL**: die URL deines Medusa-Backends, inklusive `https://` (zum Beispiel `https://your-store.medusajs.com`)
    * **API Token**: der Admin-Token, den du in Medusa erstellt hast
  </Step>

  <Step title="Teste die Verbindung">
    Klicke auf **Verbindung testen**, um zu prüfen, ob deine Zugangsdaten funktionieren.
  </Step>

  <Step title="Speichern">
    Wenn der Test erfolgreich ist, klicke auf **Speichern**.
  </Step>
</Steps>

<Check>
  Dein Medusa-Shop ist jetzt verbunden. Du kannst mit dem Importieren von Produkten beginnen.
</Check>

<Warning>
  Dein API-Token gibt vollen Zugriff auf deinen Katalog über die Admin API. Teile ihn niemals öffentlich und übertrage ihn nicht in eine Versionskontrolle. Wenn du glaubst, dass er offengelegt wurde, widerrufe ihn in Medusa und erstelle einen neuen.
</Warning>

## Fehlerbehebung

<AccordionGroup>
  <Accordion title="Der Verbindungstest schlägt fehl">
    Prüfe zuerst deine Medusa URL. Sie muss korrekt sein, mit `https://` beginnen und auf dein Backend zeigen (nicht auf das Storefront). Bestätige danach, dass du den API-Token exakt kopiert hast, ohne zusätzliche Leerzeichen.
  </Accordion>

  <Accordion title="Die Authentifizierung wird abgelehnt">
    Stelle sicher, dass du einen **Secret**-API-Key (Admin) erstellt hast, keinen Publishable Key. Publishable Keys können den vollständigen Katalog nicht lesen oder schreiben.
  </Accordion>
</AccordionGroup>

## Verwandte Themen

<CardGroup cols={2}>
  <Card title="Produkte importieren" icon="download" href="/de/essentials/importing-products">
    Hole deinen Katalog aus Medusa nach WISEPIM.
  </Card>

  <Card title="Produkte anreichern" icon="sparkles" href="/de/essentials/enriching-products">
    Verbessere Titel, Beschreibungen und SEO mit AI.
  </Card>

  <Card title="Produkte exportieren" icon="upload" href="/de/essentials/exporting-products">
    Sende die verbesserten Inhalte zurück an Medusa.
  </Card>

  <Card title="Alle Plattformen" icon="layout-grid" href="/de/integrations/supported-platforms">
    Sieh dir jede Plattform an, mit der WISEPIM sich verbindet.
  </Card>
</CardGroup>