Serverkarte öffentlich, Tools autorisiert
Die MCP-Serverkarte ist für Planung und Discovery öffentlich. Tools-Liste und Ausführung benötigen Assistant-Autorisierung und Workspace-Kontrollen.
Entwicklerplattform
KI-Agenten und MCP-Tools für Merchandise-Automatisierung
Verbinde KI-Assistenten über die öffentliche MCP-Serverkarte sowie assistant-autorisierte Tools-Listen und Ausführungsendpunkte mit freigegebenen MerchandAise-Funktionen.
Was diese Seite abdeckt
Diese Seite ist der technische Einstieg für Teams, die MerchandAise MCP-kompatibel an KI-Agenten anbinden möchten. Sie erklärt die öffentliche Serverkarte, die assistant-autorisierte Tools-Liste und den Produktionsreview.
Nutze sie, wenn ein Assistent strukturierte Zugriffe auf Merchandise Discovery, Angebote oder freigegebene Operationen braucht, ohne Governance und menschliche Freigaben zu umgehen.
AI-Agent- und MCP-Flächen
| Oberfläche | Implementierungsleitfaden | Maschinenlesbarer Vertrag | Zugriff |
|---|---|---|---|
| MCP-Serverkarte und autorisierte ToolsPlane KI-Agenten-Integrationen auf der browser-sicheren MCP-Anleitungsseite, nutze die öffentliche Serverkarten-JSON für Machine Discovery und verwende assistant-autorisierte Endpunkte für Tool-Listen und Ausführung. | ImplementierungsleitfadenMCP-Implementierungsleitfaden öffnen | Maschinenlesbarer VertragÖffentliche MCP-Serverkarte (JSON)/de/.well-known/mcp/server-card | Zugriffpublic Öffentliches Discovery-Dokument für Machine Clients. Tools-Liste und Tool-Ausführung erfordern weiterhin Assistant-Autorisierung unter /api/v1/mcp/tools. |
| Assistant-Tooling-API-DokumentationLies die OpenAPI-Dokumentation für Design Sessions, Tool-Nutzung und Integrationsreviews. Community-, Supplier- und Enterprise-Verträge sind separat ausgewiesen. | ImplementierungsleitfadenAssistant-Tooling-Dokumentation öffnen | Maschinenlesbarer VertragAssistant-Tooling-OpenAPI-JSON/api/docs/openapi.json | Zugriffpublic Öffentliche maschinenlesbare OpenAPI für Assistant- und Tooling-APIs; für Community-, Supplier- und Enterprise-Implementierungen gelten die jeweiligen Domain-Verträge. |
Checkliste für die Produktionseinbindung
- 01
Mit Serverkarte und autorisierter Tools-Liste starten
Nutze die öffentliche MCP-Serverkarte, um den Server zu identifizieren, und fordere Assistant-Autorisierung an, bevor du aktuelle Tool-Definitionen, Eingaben und Ausführungsgrenzen liest.
- 02
Assistant-Autorisierung bewusst entwerfen
Lege fest, welche Aktionen read-only sind, welche eine User-Bestätigung benötigen und welche Workspace- oder Enterprise-Freigaben erfordern.
- 03
Agentenverhalten vor Launch testen
Validiere Prompts, Tool Calls, Fehlerzustände, Observability und Freigabe-Handoffs in Staging, bevor Live-Workflows aktiviert werden.
Produktionsschutz
Menschliche Freigabe für sensible Aktionen
Angebote, Bestellungen, Supplier- und Enterprise-Aktionen brauchen klare Freigabepunkte statt rein autonomer Tool Calls.
LLM-freundliche Quelle der Wahrheit
Die Seite bietet kanonische Metadaten, strukturierte Daten, einen eigenen LLM-Feed und stabile Links für Agenten-Zitationen.
Bevor ein AI-Agent-Workflow live geht
Trenne MCP-Server-Discovery von Tools-Listen- und Ausführungsbereitschaft. Produktive Agenten-Workflows brauchen Autorisierung, Review-Grenzen und explizite menschliche Kontrollpunkte.
Tool-Zugriff nach Risiko kartieren
Unterscheide read-only Discovery, Angebotsempfehlungen, supplier-sensitive Operationen und bestellrelevante Aktionen vor der Ausführung.
Bestätigungspfade festlegen
Definiere, welche User-, Supplier- oder Enterprise-Freigaben erforderlich sind, bevor ein Assistent Merchandise, Preise oder Fulfillment-Zustände verändert.
Prompt- und Tool-Call-QA durchführen
Teste Refusals, ungültige Eingaben, veraltete Tool-Definitionen, Telemetrie und Recovery-Pfade vor Live-Traffic.
FAQ
Wofür ist der MerchandAise MCP-Tools-Endpunkt gedacht?
Autorisierte Assistenten können darüber MCP-kompatible Tool-Definitionen für freigegebene MerchandAise-Funktionen abrufen. Die Serverkarte ist öffentlich, Tools-Liste und Ausführung benötigen Autorisierung.
Kann ein AI-Agent automatisch Bestellungen auslösen?
Produktive Agenten-Workflows müssen vor jeder sensiblen Operation die erforderlichen Freigaben, Authentifizierung und Workspace-Kontrollen beibehalten.
Planst du einen Agenten-Workflow?
Teile Assistant-Use-Case, Zielnutzer, Freigabemodell und benötigte Tools. Wir empfehlen das passende MCP-, API- und Governance-Muster.