# Developer Hub: Merchandise-APIs, OpenAPI & MCP | MerchandAise

- slug: developers
- locale: de-AT
- localeResolved: de-AT
- canonical: https://www.merchandaise.com/de-at/developers

Integrieren Sie individuelle Merchandise-Produkte mit MerchandAise-APIs. Entdecken Sie OpenAPI-Dokumentation, Community-Einbettungen, Lieferantenprozesse, Enterprise-SSO und MCP-Tools.

## MerchandAise Developer Hub
Verbinden Sie Ihre Website, Geschäftssysteme oder Ihren KI-Assistenten mit MerchandAise. Entdecken Sie APIs für Produktdesign, Community-Storefronts, Lieferantenprozesse und Unternehmensidentität. OpenAPI-Spezifikationen und MCP-Dokumentation unterstützen die Integration.

## Für Teams, die Merchandise-Prozesse verbinden
- **Community-Betreiber:** Binden Sie Storefronts, Konfigurator-Übergaben und Community-Abläufe in Websites von Vereinen, Ligen und Unternehmen ein – mit versionierten öffentlichen Schnittstellen.
- **Unternehmen und Plattformpartner:** Verbinden Sie Beschaffungsportale, Identitätssysteme und interne Abläufe mit Merchandise-Prozessen, ohne Freigaben und Lieferantenlogik neu aufzubauen.
- **Entwickler von KI-Agenten und Automationen:** Geben Sie Assistenten über MCP-kompatible Endpunkte strukturierten Zugriff für Produktsuche, Angebote und freigegebene Abläufe.

## Finden Sie Ihre Integration
- **API-Dokumentation & OpenAPI:** Finden Sie die API-Referenz für Assistenten-Tools und Design-Sessions. Wählen Sie anschließend den Community-, Lieferanten- oder Enterprise-Vertrag für Ihren Anwendungsfall. Implementierungsleitfaden: API-Dokumentation ansehen (/de-at/developers/api-integrations). Maschinenlesbarer Vertrag: OpenAPI-JSON für Assistenten-Tools (/api/docs/openapi.json). Zugriff: Öffentlich. Öffentliche Referenz für Assistenten- und Tooling-APIs. Produktivzugriff und Bestellvorgänge erfordern weiterhin die passende Autorisierung. Kanonischer Abschnitt: /de-at/developers#api-docs.
- **Community API:** Verbinden Sie eine Vereins- oder Community-Website mit öffentlichen Community-Daten, Designeinreichungen, Abstimmungen und Übergaben zur Bestellfreigabe. Implementierungsleitfaden: Community API ansehen (/de-at/developers/api-integrations#community-integrations). Maschinenlesbarer Vertrag: Community OpenAPI JSON (/api/v1/community/public/openapi/v1). Zugriff: Öffentlich. Öffentlicher, versionierter Vertrag für Storefront-Einbettungen, Community-Suche und sprachspezifische Übergaben. Kanonischer Abschnitt: /de-at/developers#community-integrations.
- **Lieferanten-API:** Verbinden Sie Systeme zugelassener Lieferanten mit freigegebenen Produktionspaketen, dem Onboarding-Status und ERP- oder PLM-Webhook-Prozessen. Implementierungsleitfaden: Lieferanten-API ansehen (/de-at/developers/api-integrations#supplier-integrations). Maschinenlesbarer Vertrag: Lieferanten-OpenAPI-JSON (/api/v1/supplier/openapi/v1). Zugriff: Öffentlich. Öffentlicher Vertrag für Planung und Client-Generierung. Operativer Lieferantenzugriff bleibt berechtigungsgebunden. Kanonischer Abschnitt: /de-at/developers#supplier-integrations.
- **Enterprise Identity API:** Verbinden Sie zugelassene Unternehmens-Workspaces mit Single Sign-on, Benutzer- und Gruppenbereitstellung sowie Identity-Audit-Daten. Implementierungsleitfaden: Enterprise Identity ansehen (/de-at/developers/api-integrations#enterprise-integrations). Maschinenlesbarer Vertrag: Enterprise-Identity-OpenAPI-JSON (/api/v1/enterprise/identity/openapi/v1). Zugriff: Geschützt. Geschützter Vertrag für zugelassene Enterprise-Workspaces. Fordern Sie vor der Nutzung dieses Endpunkts Zugriff an. Kanonischer Abschnitt: /de-at/developers#enterprise-integrations.
- **KI-Agenten & MCP:** Verbinden Sie einen KI-Assistenten über das Model Context Protocol. Entdecken Sie unterstützte Tools und bewahren Sie Designentscheidungen, Berechtigungen und erforderliche Bestätigungen der Nutzer. Implementierungsleitfaden: KI-Agenten & MCP ansehen (/de-at/developers/ai-agents-mcp). Maschinenlesbarer Vertrag: Öffentliche MCP-Serverkarten-JSON (/.well-known/mcp/server-card). Zugriff: Öffentlich. Öffentliches Dokument zur maschinellen Erkennung. Die externe Tool-Liste unter /api/v1/mcp/tools zeigt aktuelle Tool-Metadaten. Für jeden Aufruf gelten weiterhin die ausgewiesenen Sicherheits-, Workspace- und Bestätigungsregeln. Kanonischer Abschnitt: /de-at/developers#mcp-tools.

## So starten Sie die Integration
- **Schritt 1: Wählen Sie den passenden Vertrag:** Beginnen Sie mit der Schnittstelle, die zu Ihren Nutzern und Ihrem Berechtigungsmodell passt: Community-Einbettung, Enterprise Identity, Lieferantenprozesse oder MCP-Tools für Assistenten.
- **Schritt 2: Prüfen Sie Authentifizierung, Versionen und Umgebungen:** Bestätigen Sie erforderliche Header, Berechtigungsumfänge, Callback-Anforderungen und Vertragsversionen in einer Testumgebung, bevor Sie produktiven Datenverkehr weiterleiten.
- **Schritt 3: Testen Sie den gesamten Ablauf vor dem Start:** Prüfen Sie Anfragen, Webhooks, Benutzerbereitstellung, Überwachung und Rückfallwege, damit die Integration vom ersten produktiven Einsatz an zuverlässig ist.

## Was produktionsreif bedeutet
Ein öffentlicher Endpunkt allein genügt nicht. Prüfen Sie diese Voraussetzungen, bevor Kunden-, Lieferanten-, Unternehmens- oder KI-Agenten-Prozesse produktiv genutzt werden.
- **Testumgebung und Zugriffsprüfung:** Klären Sie, welche Verträge öffentlich sind, welche Enterprise-Schnittstellen eine Freigabe benötigen und welche Zugangsdaten oder Workspace-Rollen für den Start erforderlich sind.
- **Nachweis der versionierten Implementierung:** Dokumentieren Sie generierte Clients, Callback-URLs, Berechtigungsumfänge, Vertragsversionen und die Verantwortung für Rückfallwege, bevor produktiver Datenverkehr aktiviert wird.
- **Betriebliche Überwachung:** Planen Sie Logs, Wiederholungen, Support-Zuständigkeiten, Fehlerzustände und Zustandsprüfungen für jeden Ablauf, der Bestellungen, Lieferanten oder Unternehmensnutzer betreffen kann.

## Vor der Implementierung
- **Welche MerchandAise-API soll ich verwenden?:** Die Community API unterstützt Vereins- und Community-Websites, die Lieferanten-API berechtigte Lieferantenprozesse und die Enterprise Identity API Unternehmensanmeldung und Benutzerbereitstellung. Die API-Referenz behandelt Assistenten-Tools; der MCP-Leitfaden erklärt, wie KI-Assistenten unterstützte Tools finden und nutzen.
- **Kann ich die API-Spezifikationen ohne Konto lesen?:** Die OpenAPI-Spezifikationen für Assistenten-Tools, Community und Lieferanten sind öffentlich. Die Enterprise-Identity-Spezifikation ist geschützt. Eine öffentliche Spezifikation zu lesen, erlaubt weder geschützte Anfragen noch Bestellungen.
- **Brauche ich eine Entwickler-Integration, um ein Produkt zu bestellen?:** Nein. Privatpersonen, Vereine und Unternehmen können auf der MerchandAise-Website unterstützte Produkte entdecken und ein Angebot anfragen. APIs sind eine optionale Möglichkeit, eigene Systeme oder Erlebnisse anzubinden.
- **Was gehört in eine Integrationsanfrage?:** Beschreiben Sie die Nutzer, die beteiligten Systeme, die benötigten Lese- und Schreibzugriffe sowie Ihren Zeitplan. Nennen Sie bekannte Anforderungen an Anmeldung, Umgebung und Callbacks. Das Team prüft mit Ihnen den passenden Vertrag und das Zugriffsmodell.

## Benötigen Sie eine Integrationsprüfung?
Beschreiben Sie Ihre Architektur, Ihren Zeitplan und die geplanten Kanäle. Gemeinsam prüfen wir die passende Schnittstelle, das Berechtigungsmodell und die Reihenfolge für den Start.
- **Integrationsteam kontaktieren:** /de-at/contact/integrations
- **Enterprise-Plattform ansehen:** /de-at/enterprise