Mintlify: Mit mint deploy veröffentlichen KI-Agenten Dokumentationsseiten ohne Konto

Schluss mit der Übergabe an den Menschen

Agenten wie Claude Code, Cursor und Codex können Dokumentationsseiten für ein Repository in wenigen Minuten schreiben, sagt Mintlify. Beim Veröffentlichen sah es anders aus. In den hauseigenen Evals bauten die Agenten die Seite lokal, erreichten den Anmeldeschritt und forderten den Nutzer dann auf, den Vorgang im Browser abzuschließen. E-Mail-Verifizierung und GitHub-Einrichtung konnten nur Menschen erledigen.

Laut Mintlify beseitigt mint deploy diese Übergabe. Der Agent kann die Seite veröffentlichen und dem Nutzer anschließend einen Link zum Beanspruchen schicken.

So funktioniert das Deployment

Aus dem Ordner, der die Datei docs.json enthält, führt der Agent zwei Befehle aus: npm i -g mint und mint deploy --subdomain acme. Die CLI legt ein von Mintlify gehostetes Git-Repository an und liefert ein kurzlebiges Schreib-Token zurück. Der Agent pusht die Dokumentation, und die Seite geht unter acme.mintlify.site live.

Teams, die ihre Doku in einem bestehenden GitHub-Repository halten möchten, können stattdessen mint deploy --github --subdomain acme verwenden. Das erzeugt einen GitHub-Actions-Workflow, der die Seite aktualisiert, sobald jemand auf den Standard-Branch pusht. Liegt die Doku in einem Unterverzeichnis, deckt die Option --directory das ab.

Agenten können den Ablauf auch selbstständig finden. Mintlify verweist auf mintlify.com/auth.md, das einem offenen Protokoll von WorkOS folgt. Dieses beschreibt, wie sich ein Agent bei einem Dienst registrieren und das entstandene Konto an einen Menschen übergeben kann. Mintlifys Datei beschreibt den Ablauf als rohe HTTP-Anfragen, sodass auch Agenten, die die CLI nicht installieren können, sich registrieren, eine Seite bereitstellen und sie über die Claim-Seite übergeben können.

Die Seite beanspruchen

Die Seite ist bereits live, wenn der Claim-Prozess beginnt. Durch das Beanspruchen wandert sie in das Mintlify-Dashboard des Nutzers und lässt sich dort dauerhaft verwalten. Die Schritte:

• Der Agent benötigt die E-Mail-Adresse des Nutzers, um mint claim --email [email protected] auszuführen.
• Der Nutzer öffnet den Claim-Link und meldet sich an oder erstellt ein Konto.
• Der Nutzer kopiert den auf der Seite angezeigten Code und gibt ihn dem Agenten zurück.
• Der Agent schließt den Vorgang mit mint claim --code 4F7K-9QX2 ab.

Durch das Beanspruchen wird der Nutzer Admin der Organisation der Seite. Nutzer, die bereits ein Mintlify-Konto haben, melden sich an und sehen die Seite in ihrem Dashboard. Wer mehreren Organisationen angehört, wird gegebenenfalls aufgefordert, eine auszuwählen.

Nicht beanspruchte Seiten laufen 24 Stunden nach der Erstellung ab und werden samt gehostetem Repository gelöscht. Um neu zu beginnen, führt der Nutzer mint deploy --new --subdomain <name> aus.

Kosten, Kompatibilität und Bedeutung

Das Deployment ist laut Mintlify kostenlos. Handelt es sich um die erste Mintlify-Seite des Nutzers, startet das Beanspruchen eine Pro-Testphase. Der Ablauf funktioniert mit jedem Agenten, der Shell-Befehle, npm und Git ausführen kann, darunter Claude Code, Cursor und Codex.

Nach dem Beanspruchen lässt sich eine Seite über die Git-Einstellungen im Dashboard in ein persönliches GitHub-Repository verschieben. Die Option mint deploy --github funktioniert nur bei Seiten, die noch nicht beansprucht wurden.

Für Entwickler, die das Schreiben der Dokumentation bereits an einen Agenten delegieren, bedeutet die Neuerung, dass der gesamte Weg vom Prompt bis zur Live-URL in einer einzigen Sitzung ablaufen kann. Der Mensch greift erst am Ende ein, um das Ergebnis zu beanspruchen. Mintlify liefert zudem einen Beispiel-Prompt, der den Agenten anweist, die CLI zu installieren, die Doku zu veröffentlichen, zu prüfen, ob die Seite lädt, die Live-URL zu senden und den Nutzer daran zu erinnern, die Seite innerhalb von 24 Stunden zu beanspruchen.