Mintlify entwickelt setup.md zur Konfiguration seiner Plattform durch KI-Agenten

Eine Seite ersetzt den verstreuten Einrichtungsprozess

Mintlify erklärte, setup.md nach der Beobachtung entwickelt zu haben, dass Agenten mehrere Dokumentationsseiten aufriefen, ungeeignete Befehle auswählten und lange Anweisungen zurückgaben, anstatt die Einrichtung abzuschließen. In einem Beispiel wurde Claude.ai gebeten, Mintlify für ein Team einzurichten, konnte jedoch nichts installieren. Der Agent rief die Schnellstartanleitung, die CLI-Referenz und die MCP-Seite auf und beschrieb anschließend drei Installationswege, von denen zwei ein geöffnetes Terminal voraussetzten, das der Nutzer nicht zur Verfügung hatte.

Claude Code konnte Befehle ausführen, doch laut Mintlify rief der Agent mitunter mint --help auf, rief Dokumentation mehr als einmal ab und setzte die Installation über wiederholte Anfragen zusammen. In beiden Fällen mussten Nutzer die übliche Einrichtung letztlich über das Dashboard abschließen, wodurch der Vorteil eines Agenten entfiel.

Mintlify zufolge umfasst die Einrichtung die CLI, den Admin-MCP-Server und den Editor, für die es zuvor jeweils eine eigene Dokumentationsseite gab. Ein Benchmark der Dokumentations-URLs des Unternehmens ergab, dass ein einzelner Link zu llms.txt die meisten 404-Fehler von Agenten beseitigte. Mintlify überträgt dieses Prinzip mit setup.md auf die Installation: Eine fokussierte Seite kann für einen Agenten nützlicher sein als eine vollständige Sammlung separater Dokumente.

Die Seite identifiziert zuerst den Agenten und das Produkt

setup.md beginnt mit der Frage, ob der Agent Dateien auf dem Gerät bearbeiten kann. Gehostete Assistenten wie Claude.ai oder ChatGPT sollen Nutzer durch das Hinzufügen des Mintlify-Connectors in Claude beziehungsweise der Mintlify-App in ChatGPT führen. Programmierende Agenten wie Claude Code, Codex, Cursor, Antigravity und Grok Build sollen die Einrichtung durchführen, überprüfen und erklären, was geändert wurde.

Für die drei häufigsten Clients stellt Mintlify einen einzelnen Befehl bereit:

npx -y mint@latest agent setup --global --agent claude-code

Laut Mintlify installiert der Befehl den Mintlify-Skill und fügt den mintlify-admin-MCP-Server zur Konfiguration des Agenten hinzu. Die Seite enthält außerdem separate Anweisungen für Fälle, in denen die Abkürzung nicht funktioniert.

Vor der Installation fragt der Agent, woran der Nutzer arbeitet. Eine private Wissensdatenbank wird als Mintlify Base behandelt und kann mit mint deploy --base erstellt werden, während eine öffentliche Dokumentationsseite mint deploy verwendet. Mintlify zufolge wird erst benötigt, wenn eine Base beansprucht wird.

Kürzere Übergaben und Hilfe bei fehlgeschlagenen Einrichtungen

Mintlify erklärte, Agenten würden Nutzer häufig mit Repository-URLs, Organisations-IDs, Subdomains, Dateipfaden und Zeitstempeln zum Ablauf von Token überfordern. setup.md weist sie stattdessen an, die wesentlichen Informationen zu teilen und dem Nutzer in zwei oder drei Sätzen die nächste Aktion zu erklären, etwa einen Claim-Link zu öffnen, sich mit einem beliebigen Konto anzumelden und „Bestätigen“ auszuwählen.

Die Seite behandelt auch Fälle, die die Einrichtung unterbrechen können. Für den Auto-Modus von Claude Code enthält sie Anweisungen, wie sich eine blockierte Installation freigeben lässt. Sie weist darauf hin, dass eine neue MCP-Konfiguration eine neue Sitzung erfordert, damit Agenten nicht neu starten, bevor die Einrichtung abgeschlossen ist.

Nutzer können einen fehlgeschlagenen Einrichtungsschritt mit einem Feedback-Befehl der Mintlify-CLI melden. Mintlify zufolge gehen diese Meldungen an das Team und fließen in den Entwicklungsprozess ein. Die Seite ist unter mintlify.com/docs/setup verfügbar; die Markdown-Version ist für den Abruf durch Agenten gedacht. Teams können außerdem eine Zeile in ihre AGENTS.md im Stammverzeichnis aufnehmen, die Agenten anweist, die Seite zuerst zu lesen.