mintlify · mintlify · Apr 4, 2025
diff --git a/de/advanced/dashboard/permissions.mdx b/de/advanced/dashboard/permissions.mdx
@@ -0,0 +1,16 @@
+---
+title: Editor-Berechtigungen
+description: Erlauben Sie mehr Teammitgliedern, Ihre Dokumentation zu aktualisieren
+---
+
+Das Teammitglied, das Ihre erste Dokumentation erstellt hat, wird Aktualisierungszugriff auf Ihre Dokumentation haben, solange sie mit demselben GitHub-Konto in Ihr Dokumentations-Repository pushen, das bei der Anmeldung für Mintlify verwendet wurde.
+
+Wenn ein anderer Editor versucht, die Dokumentation im kostenlosen Plan zu aktualisieren, werden Sie eine Warnung in Ihrer Git-Commit-Prüfung sehen.
+
+<Frame>
+  <img className="rounded-md" src="/images/editor-gate.png" />
+</Frame>
+
+In den Details der Git-Prüfungswarnung finden Sie den Link zum Upgrade Ihres Plans. Sie können Ihren Plan auch im [Dashboard](https://dashboard.mintlify.com) upgraden, um unbegrenzten Editoren das Aktualisieren Ihrer Dokumentation zu ermöglichen. Sobald Sie Ihren Plan upgraden, lösen Sie ein manuelles Update aus oder pushen Sie eine weitere Änderung, um Ihre Updates zu deployen.
+
+Erfahren Sie mehr über unsere Preise [hier](https://mintlify.com/pricing).
diff --git a/de/advanced/dashboard/sso.mdx b/de/advanced/dashboard/sso.mdx
@@ -0,0 +1,105 @@
+---
+title: Single Sign-On (SSO)
+description: Passen Sie an, wie sich Ihr Team in Ihrem Admin-Dashboard anmelden kann
+---
+
+Nutzen Sie Single Sign-on für Ihr Dashboard über SAML und OIDC. Wenn Sie Okta oder Google Workspace verwenden, haben wir anbieterspezifische Dokumentation für die Einrichtung von SSO. Bei anderen Anbietern kontaktieren Sie uns bitte!
+
+<Note>
+  SSO-Funktionalität ist in unserem Enterprise-Plan verfügbar.[Kontaktieren
+  Sie uns](https://mintlify.com/enterprise) um mehr zu erfahren!
+</Note>
+
+## Okta
+
+<Tabs>
+  <Tab title="SAML">
+    <Steps>
+      <Step title="Create an application">
+        Unter `Applications`, klicken Sie, um eine neue App-Integration mit SAML 2.0 zu erstellen.
+      </Step>
+
+      <Step title="Configure integration">
+        Geben Sie Folgendes ein:
+
+        * Single Sign-on URL (von Mintlify bereitgestellt)
+        * Audience URI (von Mintlify bereitgestellt)
+        * Name ID Format: `EmailAddress`
+        * Attributanweisungen:
+          | Name        | Namensformat | Wert             |
+          | ----------- | ------------ | ---------------- |
+          | `firstName` | Basic        | `user.firstName` |
+          | `lastName`  | Basic        | `user.lastName`  |
+      </Step>
+
+      <Step title="Send us your IdP information">
+        Sobald die Anwendung eingerichtet ist, navigieren Sie zum Sign-on-Tab und senden Sie uns die Metadata-URL.
+        Wir werden die Verbindung von unserer Seite mit diesen Informationen aktivieren.
+      </Step>
+    </Steps>
+  </Tab>
+
+  <Tab title="OIDC">
+    <Steps>
+      <Step title="Create an application">
+        Unter `Applications`, klicken Sie, um eine neue App-Integration mit OIDC zu erstellen.
+        Sie sollten den `Web Application` Anwendungstyp wählen.
+      </Step>
+
+      <Step title="Configure integration">
+        Wählen Sie den Autorisierungscode-Grant-Typ und geben Sie die von Mintlify bereitgestellte Redirect-URI ein.
+      </Step>
+
+      <Step title="Send us your IdP information">
+        Sobald die Anwendung eingerichtet ist, navigieren Sie zum Allgemeinen Tab und finden Sie die Client-ID & das Client-Secret.
+        Bitte stellen Sie uns diese zusammen mit Ihrer Okta-Instanz-URL sicher zur Verfügung (z.B. `<your-tenant-name>.okta.com`). Sie können diese über einen Dienst wie 1Password oder SendSafely senden.
+      </Step>
+    </Steps>
+  </Tab>
+</Tabs>
+
+## Google Workspace
+
+<Tabs>
+  <Tab title="SAML">
+    <Steps>
+      <Step title="Create an application">
+        Unter `Web and mobile apps`, wählen Sie `Add custom SAML app` aus dem `Add app` Dropdown-Menü.
+
+        <Frame>
+          ![](/images/gsuite-add-custom-saml-app.png)
+        </Frame>
+      </Step>
+
+      <Step title="Send us your IdP information">
+        Kopieren Sie die bereitgestellte SSO-URL, Entity ID und das x509-Zertifikat und senden Sie diese an das Mintlify-Team.
+
+        <Frame>
+          ![](/images/gsuite-saml-metadata.png)
+        </Frame>
+      </Step>
+
+      <Step title="Configure integration">
+        Geben Sie auf der Seite für Service-Provider-Details Folgendes ein:
+
+        * ACS URL (von Mintlify bereitgestellt)
+        * Entity ID (von Mintlify bereitgestellt)
+        * Name ID Format: `EMAIL`
+        * Name ID: `Basic Information > Primary email`
+
+        <Frame>
+          ![](/images/gsuite-sp-details.png)
+        </Frame>
+
+        Geben Sie auf der nächsten Seite die folgenden Attributanweisungen ein:
+
+        | Google Verzeichnisattribut | App-Attribut |
+        | -------------------------- | ------------ |
+        | `First name`               | `firstName`  |
+        | `Last name`                | `lastName`   |
+
+        Sobald dieser Schritt abgeschlossen ist und die Benutzer der Anwendung zugewiesen sind, informieren Sie unser Team und wir aktivieren SSO für Ihr Konto!
+      </Step>
+    </Steps>
+  </Tab>
+</Tabs>
diff --git a/de/advanced/mcp/generate.mdx b/de/advanced/mcp/generate.mdx
@@ -0,0 +1,42 @@
+---
+title: MCP Generator
+description: Lernen Sie, wie Sie Ihren eigenen MCP Server einrichten
+icon: 'text-size'
+---
+
+<Tip>
+  Diese Seite widmet sich der Einrichtung Ihres eigenen MCP Servers. Wenn Sie Informationen zur Verwendung des Mintlify MCP Servers suchen, lesen Sie bitte die
+  [Installation und Verwendung des Mintlify MCP Servers](/advanced/mcp/quickstart) Seite.
+</Tip>
+
+## Erste Schritte
+
+Führen Sie `npm i @mintlify/mcp` aus, um die `@mintlify/mcp` CLI zu installieren.
+
+Im [Dashboard](https://dashboard.mintlify.com/products/mcp) gehen Sie zu `MCP Server`, auf dieser Seite schalten Sie um, um Ihren einzigartigen Installationsbefehl zu sehen. Dies ist der Befehl zur Installation Ihres MCP Servers mit der `@mintlify/mcp` CLI.
+
+<Note>
+  Stellen Sie sicher, dass Sie den OpenAPI-Zugriff aktivieren, damit der MCP-Server auf **alle**
+  Endpunkte in Ihrer OpenAPI-Spezifikation zugreifen kann.
+</Note>
+
+## Starten Sie den MCP-Server lokal
+
+<Steps>
+  <Step title="Install the server through the CLI">
+    Führen Sie den folgenden Befehl aus, um den Server zu installieren:
+
+    ```bash
+    npx @mintlify/mcp add [your subdomain]
+    ```
+  </Step>
+
+  <Step title="Add the authentication token if applicable">
+    Wenn Ihre API einen Authentifizierungs-Token erfordert, weisen Sie Ihren Endkunden an, diesen zu besorgen und anzuwenden, wenn diese Antwort erscheint: `> What is the Authorization
+        (basic token)?` Andernfalls können Sie diesen Schritt überspringen.
+  </Step>
+
+  <Step title="Start your MCP server">
+    Sie können jetzt ausführen: `bash npm --prefix ~/.mcp/[your subdomain] start `
+  </Step>
+</Steps>
diff --git a/de/advanced/mcp/quickstart.mdx b/de/advanced/mcp/quickstart.mdx
@@ -0,0 +1,97 @@
+---
+title: Schnellstart
+description: Generieren Sie einen MCP-Server, um Ihr Produkt mit LLMs zu verbinden
+---
+
+## Einführung
+
+Der MCP Generator ist ein CLI-Tool, das einen MCP-Server basierend auf der Dokumentation Ihres Unternehmens und der OpenAPI-Spezifikation, falls verfügbar, generiert. Es nimmt Ihre Dokumentation und eine OpenAPI-Spezifikation auf und gibt einen MCP-Server aus, der mit jedem MCP-Client verwendet werden kann. Der MCP Generator wird über[npm-Paket](https://www.npmjs.com/package/mcp)bereitgestellt und generiert einen MCP-Server, der mit jedem MCP-Client verwendet werden kann.
+
+Mintlify ermöglicht es Ihnen, einen MCP-Server zu erstellen, der es KI-Tools erlaubt, in diesen wichtigen Szenarien mit Ihren Dokumenten zu interagieren:
+
+1. **Docs Q\&A**, ähnlich wie unser KI-Chat. Dies ist automatisch für Ihre Dokumente aktiviert, keine Einrichtung erforderlich.
+2. **Echtzeit-API-Abfragen**, wenn Sie eine OpenAPI-Spezifikation haben, gehen Sie zu den`Mintlify Dashboard > Products > MCP Server`und aktivieren Sie den Schalter für Ihre OpenAPI-Spezifikation.
+
+   <Note>
+     Durch Aktivierung des OpenAPI-Schalters erlauben Sie dem MCP-Server den Zugriff auf
+     **alle**Endpunkte in Ihrer OpenAPI-Spezifikation.
+   </Note>
+
+## Installieren Sie den MCP-Server
+
+<Tip>
+  Diese Seite ist dem Mintlify MCP-Server gewidmet. Wenn Sie Informationen zur Generierung Ihres MCP suchen, lesen Sie bitte die[MCP Generator](/advanced/mcp/generate)Seite.
+</Tip>
+
+## Beispielinstallation mit dem Mintlify MCP-Server
+
+Um den Mintlify MCP-Server zu verwenden, benötigen Sie einen[API-Schlüssel](https://mintlify.com/docs/advanced/rest-api/overview#authentication)von Ihrem Mintlify-Konto. Wenn Sie noch keinen haben, navigieren Sie zu`Settings > API Keys > Chat API Key`und erstellen Sie einen neuen Schlüssel.
+
+## Starten Sie den MCP-Server lokal
+
+<Steps>
+  <Step title="Install the server through the CLI">
+    Führen Sie den folgenden Befehl aus, um den Server zu installieren:
+
+    ```bash
+    npx @mintlify/mcp add mintlify
+    ```
+  </Step>
+
+  <Step title="Add the authentication token">
+    Die folgende Antwort wird nach Ausführung des vorherigen Befehls angezeigt:
+
+    ```
+    > What is the Authorization (basic token)?
+    ```
+
+    Kopieren Sie mit Ihrem API-Chat-Schlüssel das Authentifizierungstoken und fügen Sie es in die CLI ein.
+  </Step>
+
+  <Step title="Start your MCP server">
+    Sie können jetzt ausführen:
+
+    ```bash
+    npm --prefix ~/.mcp/mintlify start
+    ```
+  </Step>
+</Steps>
+
+## Verwenden Sie Ihren Server mit Claude
+
+<Note>
+  Laden Sie die[Claude Desktop App](https://claude.ai/download)
+</Note>
+
+Sobald Sie die Claude Desktop App installiert haben, folgen Sie diesen Schritten:
+
+<Steps>
+  <Step title="Navigate to the Settings > Developer" />
+
+  <Step title="Click on Edit Config">
+    Fügen Sie Folgendes zu der`claude_desktop_config.json`hinzu:
+
+    ```json
+    {
+     "mcpServers": {
+         "mintlify": {
+             "command": "npm",
+             "args": [
+                 "--prefix",
+                 "~/.mcp/mintlify",
+                 "start"
+             ]
+         }
+     }
+    }
+    ```
+  </Step>
+
+  <Step title="If you see the hammer icon, you're all set!">
+    Wenn Sie darauf klicken, sollten Sie die verfügbaren MCP-Tools in Ihrem Server sehen.
+
+    <Frame>
+      ![Claude MCP](/images/mcp-with-claude.png)
+    </Frame>
+  </Step>
+</Steps>
diff --git a/de/advanced/rest-api/chat/create-topic.mdx b/de/advanced/rest-api/chat/create-topic.mdx
@@ -0,0 +1,3 @@
+---
+openapi: POST /chat/topic
+---
diff --git a/de/advanced/rest-api/chat/generate-message.mdx b/de/advanced/rest-api/chat/generate-message.mdx
@@ -0,0 +1,3 @@
+---
+openapi: POST /chat/message
+---
diff --git a/de/advanced/rest-api/overview.mdx b/de/advanced/rest-api/overview.mdx
@@ -0,0 +1,38 @@
+---
+title: Überblick
+---
+
+## Updates auslösen
+
+Sie können die REST-API nutzen, um programmatisch ein Update auszulösen, wenn gewünscht.
+
+<Info>
+  Während der Hauptanwendungsfall das Auslösen von Updates sein wird, werden wir mit der Zeit mehr und mehr
+  Funktionalität zur API hinzufügen. Lassen Sie uns wissen, was Sie sonst noch sehen möchten in
+  [unserer Community](https://mintlify.com/community)!
+</Info>
+
+## Authentifizierung
+
+Sie können einen API-Schlüssel generieren über
+[das Dashboard](https://dashboard.mintlify.com/settings/organization/api-keys). Der API-Schlüssel ist mit der gesamten Organisation verbunden und kann über mehrere Deployments hinweg verwendet werden.
+
+<Frame>
+  <img src="/images/external-api-key.png" />
+</Frame>
+
+## Admin-API-Schlüssel
+
+Der Admin-API-Schlüssel wird für die Mehrheit der API verwendet. Er wird verwendet, um Aktualisierungen über den [Update-Endpunkt](/advanced/rest-api/update/trigger).
+
+## Chat-API-Schlüssel
+
+Die Chat-API ermöglicht es Ihnen, die KI-Chat-Erfahrung, die auf Ihren Dokumenten basiert und kontinuierlich aktualisiert wird, in jede beliebige Anwendung Ihrer Wahl einzubetten.
+
+Die Antworten enthalten Zitate, sodass Sie Ihre Benutzer zu den richtigen Stellen führen können, an denen sie Hilfe benötigen.
+
+<Note>
+  Der Chat-API-Token ist ein öffentlicher Token, der in Ihrem Frontend-Code referenziert werden kann, während der API-Schlüssel ein serverseitiger Token ist, der geheim gehalten werden sollte.
+</Note>
+
+Nachdem Sie nun einen API-Schlüssel haben, schauen Sie sich unser [Beispiel](https://github.com/mintlify/discovery-api-example) an, wie Sie die API für KI-Chat verwenden können. Sie können auch eine bereitgestellte Version dieses Beispiels unter [chat.mintlify.com](https://chat.mintlify.com) sehen.
diff --git a/de/advanced/rest-api/update/status.mdx b/de/advanced/rest-api/update/status.mdx
@@ -0,0 +1,3 @@
+---
+openapi: GET /project/update-status/{statusId}
+---
diff --git a/de/advanced/rest-api/update/trigger.mdx b/de/advanced/rest-api/update/trigger.mdx
@@ -0,0 +1,3 @@
+---
+openapi: POST /project/update/{projectId}
+---
diff --git a/de/advanced/subpath/cloudflare.mdx b/de/advanced/subpath/cloudflare.mdx
@@ -0,0 +1,75 @@
+---
+title: Cloudflare
+description: Hosten Sie Dokumentation unter einem /docs Unterpfad mit Cloudflare Workers
+---
+
+## Cloudflare Worker erstellen
+
+Navigieren Sie zu `Workers & Pages > Create application > Create worker`. Sie sollten den folgenden Bildschirm sehen, wo Sie einen neuen Cloudflare Worker erstellen können.
+
+<Frame>
+  <img alt="Create a Cloudflare worker" src="/images/cloudflare/worker.png" />
+</Frame>
+
+<Warning>
+  Beachten Sie: Wenn Cloudflare Ihr DNS-Provider ist, sollten Sie kein Proxying für den CNAME-Eintrag verwenden
+</Warning>
+
+### Benutzerdefinierte Domain hinzufügen
+
+Sobald der Worker erstellt ist, klicken Sie auf `Configure worker`. Navigieren Sie zum Worker
+`Settings > Triggers`. Klicken Sie auf `Add Custom Domain`, um Ihre gewünschte Domain zur Liste hinzuzufügen - wir empfehlen, sowohl die Version mit als auch ohne `www.`
+vor der Domain hinzuzufügen.
+
+<Frame>
+  <img alt="Cloudflare worker custom domain" src="/images/cloudflare/custom-domain.png" />
+</Frame>
+
+Wenn Sie Probleme beim Einrichten eines benutzerdefinierten Unterverzeichnisses haben,
+[kontaktieren Sie unser Support-Team](mailto:[email protected]) und wir führen Sie durch den Prozess, Ihr Hosting bei uns zu aktualisieren.
+
+### Worker-Skript bearbeiten
+
+Klicken Sie auf `Edit Code` und fügen Sie das folgende Skript in den Code des Workers ein.
+
+<Frame>
+  <img alt="Cloudflare edit code" src="/images/cloudflare/edit-code.png" />
+</Frame>
+
+<Tip>
+  Bearbeiten Sie `DOCS_URL` indem Sie `[SUBDOMAIN]` durch Ihre eindeutige Subdomain ersetzen und`CUSTOM_URL` durch die Basis-URL Ihrer Website.
+</Tip>
+
+```javascript
+addEventListener("fetch", (event) => {
+  event.respondWith(handleRequest(event.request));
+});
+
+async function handleRequest(request) {
+  try {
+    const urlObject = new URL(request.url);
+    // If the request is to the docs subdirectory
+    if (/^\/docs/.test(urlObject.pathname)) {
+      // Then Proxy to Mintlify
+      const DOCS_URL = "[SUBDOMAIN].mintlify.dev";
+      const CUSTOM_URL = "[YOUR_DOMAIN]";
+
+      let url = new URL(request.url);
+      url.hostname = DOCS_URL;
+
+      let proxyRequest = new Request(url, request);
+
+      proxyRequest.headers.set("Host", DOCS_URL);
+      proxyRequest.headers.set("X-Forwarded-Host", CUSTOM_URL);
+      proxyRequest.headers.set("X-Forwarded-Proto", "https");
+
+      return await fetch(proxyRequest);
+    }
+  } catch (error) {
+    // if no action found, play the regular request
+    return await fetch(request);
+  }
+}
+```
+
+Klicken Sie auf `Deploy` und warten Sie, bis die Änderungen übernommen wurden (dies kann bis zu einige Stunden dauern).