Zum Hauptinhalt springen

​
Was ist das?

Polygon One stellt seine REST-API als MCP-Server (Model Context Protocol) bereit. Ihr KI-Assistent nutzt damit Ihre Polygon One-Daten — Artikel, Lieferanten, Bestellungen, Parzellen und deren Analyse, DDS-Erklärungen, Nachweise, PPWR-Verpackungseinheiten, Komponenten, Konformitätserklärungen und Mengenmeldungen — und arbeitet im Chat damit.
Genau zehn Schreibwerkzeuge. Der Assistent kann Artikel, Lieferanten und Bestellungen anlegen, Bestellungen aktualisieren, DDS-Entwürfe anlegen und externe DDS-Metadaten aktualisieren sowie PPWR-Komponenten und -Verpackungseinheiten anlegen oder aktualisieren und verknüpfen. Er kann nie löschen, Lieferanten einladen, eine DDS-Erklärung bei TRACES einreichen oder zurückziehen oder eine Compliance-Entscheidung treffen. Jeder Aufruf läuft unter Ihrem eigenen Benutzer und Ihren Berechtigungen; Schreibvorgänge werden am jeweiligen API-Endpunkt protokolliert.

​
Server-URL

​
Anmeldung: zwei Wege

  • OAuth (empfohlen) — Der Assistent leitet Sie zu Polygon One weiter. Sie melden sich an und stimmen einmal zu; der Zustimmungsdialog zeigt den verifizierten Rückleitungs-Host groß, daneben den Anwendungsnamen, den angefragten Zugriff und Ihr Konto. Unbekannte Hosts können nicht bestätigt werden. Der Zugriff kann widerrufen werden — wenden Sie sich dafür an den Support.
  • API-Schlüssel — für Anwendungen, die nur einen festen Schlüssel unterstützen (z.B. Microsoft Copilot Studio). Header Authorization, Wert Bearer eudr_…. Legen Sie den Schlüssel unter Einstellungen > API-Schlüssel an und vergeben Sie nur die tatsächlich benötigten Rechte. Für die Schreibwerkzeuge sind zusätzlich zu den Leserechten articles:write, suppliers:write, orders:write, dds:write und (PPWR) packaging:write erforderlich. (siehe Berechtigungen).

​
Einrichtung

1

Connector hinzufügen

Öffnen Sie Settings → Connectors und klicken Sie auf Add custom connector.
2

URL eintragen

Fügen Sie https://app.polygon-one.com/api/mcp ein und klicken Sie auf Connect.
3

Anmelden und zustimmen

Melden Sie sich bei Polygon One an und klicken Sie auf Allow.

​
Verfügbare Werkzeuge

Jedes Werkzeug entspricht einem Endpunkt der API-Referenz. Die Liste ist fest auf 22 Lese- und zehn Schreibwerkzeuge begrenzt; neue API-Schreiboperationen werden nicht automatisch freigeschaltet.

​
Beispiel-Prompts

  • „Welche meiner Bestellungen haben noch keine DDS-Erklärung, und welcher Lieferant blockiert?”
  • „Zeig mir das Analyseergebnis von Parzelle X und erkläre, was ‚nicht gemessen’ bedeutet.”
  • „Liste die Verpackungseinheiten ohne unterschriebene Konformitätserklärung.”
  • „Bei welchen Lieferantenartikeln laufen Nachweise in diesem Quartal ab?”
  • „Prüfe diese Bestell-CSV auf widersprüchliche HS-Codes. Importiere sie erst nach meiner Korrektur, warte auf den Import-Job und bereite für die fertigen Bestellungen einen DDS-Entwurf vor.”
„Nicht gemessen” heißt nicht „in Ordnung”. Polygon One liefert genau deshalb strukturierte Statusangaben statt Freitext, damit der Assistent eine fehlende Messung nicht als unauffälliges Ergebnis darstellt.

​
Grenzen

  • 120 Aufrufe pro Minute je Benutzer und Assistent.
  • Schreibaufrufe akzeptieren höchstens 1.000.000 Zeichen im JSON-Body; die API-eigenen Zeilenlimits gelten zusätzlich.
  • Ergebnisse sind wie in der API seitenweise aufgeteilt.
  • Datei-Downloads (Parzellenbericht, PDF der Konformitätserklärung) stehen Assistenten noch nicht zur Verfügung; nutzen Sie dafür die App oder die REST-API.
  • Wie viel der Assistent auf einmal lesen kann, begrenzt sein eigenes Kontextfenster.

​
Fehlerbehebung

Ihre Daten bleiben in Polygon One. Der Anbieter des Assistenten erhält nur Daten und Eingaben, auf die Sie ihn zugreifen lassen. Fragen zur Auftragsverarbeitung beantwortet Ihnen der Support.