> ## Documentation Index > Fetch the complete documentation index at: https://help.polygon-one.com/llms.txt > Use this file to discover all available pages before exploring further. # Claude, ChatGPT und Copilot verbinden (MCP) > Verbinden Sie Ihren KI-Assistenten über das Model Context Protocol mit Polygon One — mit kontrollierten Lese- und Schreibrechten ## 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. > [!NOTE] > > **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 | | URL | | :- | :- | | MCP-Server | `https://app.polygon-one.com/api/mcp` | | Metadaten | `https://app.polygon-one.com/.well-known/oauth-protected-resource` | ## 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](https://help.polygon-one.com/api-reference/introduction.md#berechtigungen)). ## Einrichtung **Claude.ai** **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**. **ChatGPT** Setzt einen kostenpflichtigen Tarif mit Entwicklermodus voraus. **1. Entwicklermodus aktivieren** Öffnen Sie **Settings → Connectors** und schalten Sie **Developer mode** ein. **2. Connector anlegen** Klicken Sie auf **Create**, vergeben Sie einen Namen, tragen Sie `https://app.polygon-one.com/api/mcp` ein, wählen Sie **OAuth** und klicken Sie auf **Create**. **3. Verbinden und zustimmen** Klicken Sie auf **Connect**, melden Sie sich bei Polygon One an und klicken Sie auf **Allow**. **Microsoft Copilot Studio** **1. Werkzeug hinzufügen** Öffnen Sie Ihren Agenten, dann **Tools → Add a tool → New tool → Model Context Protocol**. **2. URL eintragen** Tragen Sie `https://app.polygon-one.com/api/mcp` ein. **3. Authentifizierung** Wählen Sie **API key**, Header `Authorization`, Wert `Bearer eudr_…` (ein Schlüssel nur mit den benötigten Lese- und Schreibberechtigungen, siehe oben). ## Verfügbare Werkzeuge Jedes Werkzeug entspricht einem Endpunkt der [API-Referenz](https://help.polygon-one.com/api-reference/introduction.md). Die Liste ist fest auf 22 Lese- und zehn Schreibwerkzeuge begrenzt; neue API-Schreiboperationen werden nicht automatisch freigeschaltet. | Werkzeug | Liefert | | :- | :- | | **EUDR** | | | `listArticles` | Artikel auflisten | | `getArticle` | Einen Artikel | | `listSuppliers` | Lieferanten auflisten | | `getSupplier` | Einen Lieferanten | | `listOrders` | Bestellungen auflisten | | `getOrder` | Eine Bestellung | | `listDdsStatements` | DDS-Erklärungen auflisten | | `getDdsStatement` | Eine DDS-Erklärung | | `listPlots` | Parzellen auflisten | | `getPlot` | Eine Parzelle mit Analyseergebnis | | `listEvidence` | Nachweise auflisten | | `getImportJob` | Status eines Import-Jobs | | `getReadiness` | Ob eine bestimmte Aktion (DDS-Entwurf, DDS-Einreichung, PPWR-Antwort, Konformitätserklärung) für eine Ressource jetzt möglich ist, mit Befunden und nächsten Schritten | | `createArticle` | Einen Artikel oder einen Artikel-Batch anlegen | | `createSupplier` | Einen Lieferanten oder einen Lieferanten-Batch anlegen | | `createOrder` | Eine Bestellung anlegen oder einen Batch-Import starten (`202` + Job-ID) | | `updateOrder` | Eine Bestellung aktualisieren | | `createDdsStatement` | Einen DDS-Entwurf anlegen — keine TRACES-Einreichung | | `updateDdsStatement` | Metadaten einer externen DDS-Erklärung aktualisieren | | **PPWR** | | | `listPpwrArticleUnits` | Verpackungseinheiten, die mit einem Artikel oder einer Bestellung verknüpft sind | | `listPpwrComponents` | Verpackungskomponenten auflisten | | `getPpwrComponent` | Eine Verpackungskomponente | | `listPpwrUnits` | Verpackungseinheiten auflisten | | `getPpwrUnit` | Eine Verpackungseinheit | | `listPpwrDeclarations` | Konformitätserklärungen auflisten | | `getPpwrDeclaration` | Eine Konformitätserklärung | | `listMengenmeldungReports` | Mengenmeldungen auflisten | | `downloadMengenmeldungReport` | Die Datei einer Mengenmeldung | | `upsertPpwrComponents` | Verpackungskomponenten anlegen oder aktualisieren | | `upsertPpwrUnits` | Verpackungseinheiten anlegen oder aktualisieren | | `createPpwrLinks` | Komponenten mit Verpackungseinheiten verknüpfen (Stückliste) | | `createPpwrArticleLinks` | Verpackungseinheiten mit Artikeln verknüpfen | ## 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." > [!WARNING] > > „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 | Problem | Lösung | | :- | :- | | `401` | Erneut anmelden bzw. der API-Schlüssel ist abgelaufen — neuen Schlüssel anlegen. | | „Tool not found" | Diese Operation ist für Assistenten nicht verfügbar. | | `429` | Eine Minute warten. | | Die Werkzeugliste ist leer | Die Server-URL muss genau `https://app.polygon-one.com/api/mcp` lauten. | > [!NOTE] > > 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. This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.