Mintlify

Kurzfazit

Mintlify ist die Default-Wahl für moderne API-Dokumentation, sobald ein Entwicklerportal öffentlich sein soll. Die Kombination aus OpenAPI-Auto-Rendering, gepflegter Optik, KI-Schreibassistenz und expliziter AI-Readiness (llms.txt, MCP-Server) trifft genau den Bedarf, den klassische Lösungen wie Confluence oder eigene Docs-Sites nicht abdecken. Wer eine API anbietet, kommt mit Mintlify in Tagen zu einem Portal, das aussieht wie das von Anthropic, die zahlen es selbst. Seit der Preisumstellung 2026 gibt es nur noch einen kostenlosen Starter-Plan und Enterprise auf Anfrage, die KI-Funktionen laufen über ein verbrauchsbasiertes Credit-System. Das macht den Einstieg billig, die Folgekosten bei intensiver Nutzung aber schwer planbar. Die übrigen Schwächen sind klassisch SaaS: US-Hosting und Englisch-only. Für interne Wissensbasen oder DSGVO-strenge Branchen gibt es bessere Wege.

Für wen ist Mintlify?

API-First-Startups und SaaS-Anbieter: Wer eine REST- oder GraphQL-API verkauft, braucht ein Developer-Portal. Mintlify macht aus einer gepflegten OpenAPI-Spec in Stunden ein professionelles Portal mit Try-it-now, Code-Beispielen in mehreren Sprachen und automatischer Versionierung. Das ist der Hauptanwendungsfall, und der, in dem Mintlify konkurrenzlos schnell ist.

Developer-Experience- und DevRel-Teams: Wer hauptberuflich Developer Experience betreut, bekommt mit Mintlify das richtige Werkzeug: Git-basierter Workflow für technische Schreiber, AI Writing Agent für Lückentexte, Assistant Agent als 24/7-First-Level-Support für Doku-Leser. Die Plattform reduziert die Zeit, die DevRel mit reaktivem Support verbringt, spürbar.

Plattform-Anbieter mit KI-Konsumenten: Wer seine API explizit auch für KI-Agenten anbietet (oder es vorhat), profitiert von der eingebauten AI-Readiness: llms.txt wird automatisch generiert, ein MCP-Server lässt sich aus den Docs ableiten, Markdown-Endpoints sind maschinenlesbar. Das ist 2026 keine Spielerei mehr, es ist der Standard, an dem sich neue Docs-Plattformen messen lassen.

Open-Source-Maintainer: Der Starter-Plan ist kostenlos und reicht für die meisten OSS-Projekte aus. Mintlify betreibt zusätzlich ein eigenes OSS-Programm. Wer ein populäres Framework oder eine Library pflegt, kommt schnell zu einer Docs-Site, die mit den großen Anbietern visuell mithält, Laravel etwa dokumentiert mehr als zehn Produkte über Mintlify.

Weniger geeignet für: Rein interne Wissensbasen ohne Entwicklerbezug (dafür sind oder passender), DSGVO-strenge Branchen wie Healthcare oder öffentlicher Sektor (US-Hosting ohne dokumentierte EU-Region), Teams, die ein deutschsprachiges UI brauchen, und Organisationen, die einen festen, planbaren Monatspreis statt eines verbrauchsbasierten Credit-Modells oder eines Enterprise-Vertrags auf Anfrage erwarten.

Preise im Detail

Plan	Preis	Was du bekommst
Starter	0 USD	Voller Plattformzugriff, Custom Domain, Web-Editor, Mintlify-Auth, Assistant, Writing Agent, Workflows, MCP-Server; 5.000 AI-Credits zum Ausprobieren (14-Tage-Trial), danach kostenpflichtige Credit-Pakete (Overage 0,01 USD/Credit)
Enterprise	Auf Anfrage	Alles aus Starter + Role-based Permissions, Performance-SLA, SSO (Password, OAuth, JWT), Agent Analytics, Advanced Insights, Enterprise Security & Legal (Security- und Legal-Review), Migration & Support, dedizierter Customer Success, 24/7-Incident-Monitoring

Einordnung: Mintlify hat sein Preismodell 2026 deutlich umgebaut. Der frühere mittlere Bezahlplan (“Pro”, zuletzt rund 250 USD/Monat) wird auf der Preisseite nicht mehr ausgewiesen. Stand Juni 2026 gibt es nur noch zwei öffentliche Stufen: einen kostenlosen Starter-Plan mit vollem Plattformzugriff (inklusive Custom Domain, MCP-Server, Assistant und Writing Agent) und Enterprise auf Anfrage. Die KI-Funktionen sind über ein verbrauchsbasiertes Credit-System geregelt: 5.000 Credits stehen zum Ausprobieren bereit, danach kaufst du Credit-Pakete, Overage liegt bei 0,01 USD pro Credit. Das senkt die Einstiegshürde erheblich, ein komplettes Developer-Portal lässt sich kostenlos aufsetzen. Im Gegenzug sind die laufenden KI-Kosten schwerer zu kalkulieren als bei einem festen Monatsabo, und wer feste Funktionen wie SSO, Role-based Permissions oder einen AVV braucht, landet ohne Zwischenstufe direkt im Enterprise-Vertrieb, dessen Konditionen Mintlify nur auf Anfrage nennt.

Stärken im Detail

OpenAPI als First-Class-Citizen. Die meisten Docs-Plattformen behandeln OpenAPI-Specs als Anhang oder Importformat. Mintlify rendert sie nativ und vollständig: Jeder Endpoint bekommt automatisch Beschreibung, Parameter-Erklärung, Request-Beispiele in mehreren Sprachen und einen interaktiven Try-it-now-Tester. Änderungen an der Spec spiegeln sich nach dem nächsten Build automatisch in den Docs, das eliminiert den klassischen “API geändert, Docs vergessen”-Drift, der Entwicklerportale notorisch unzuverlässig macht.

Writing Agent als echte Produktivitätshilfe. Der KI-Schreibassistent (Cursor- bzw. Claude-basiert) füllt fehlende Beschreibungen, schlägt Beispiele vor, verbessert Tonalität und Konsistenz und kann ganze Sektionen umstrukturieren. Anders als bei generischen LLM-Tools versteht der Writing Agent die Mintlify-MDX-Komponenten und schlägt sie kontextrichtig vor. Trotzdem gilt: Jede KI-Generierung braucht einen fachlichen Gegenlese-Schritt, gerade bei API-Docs sind faktische Fehler doppelt teuer.

AI-Readiness als strategischer Differenzierer. Mintlify war einer der ersten Anbieter, der llms.txt (eine Standardisierungsinitiative für KI-lesbare Doku-Indizes) und MCP-Server (Model Context Protocol von Anthropic) nativ integriert hat. Das heißt: Deine Docs sind nicht nur für Menschen aufbereitet, sondern auch für KI-Agenten konsumierbar, Claude Code, Cursor, ChatGPT oder eigene Agenten können direkt auf strukturierte Doc-Daten zugreifen. In einer Welt, in der Entwickler ihre Probleme zunehmend mit KI-Assistenten lösen, ist das ein konkreter Wettbewerbsvorteil für die API-Anbieter selbst.

Git-basierter Workflow. Doku liegt im GitHub-Repository als MDX-Dateien. Technische Schreiber können in ihrem gewohnten IDE arbeiten, Pull Requests erstellen, Preview-Deployments testen, alles, was Software-Engineering-Teams selbstverständlich erwarten, gilt auch für die Doku. Das senkt den Reibungsverlust zwischen Engineering und Tech Writing erheblich; in vielen Teams kann jede Entwicklerin nebenbei Doku-Anpassungen einreichen, ohne erst ein separates CMS lernen zu müssen.

Assistant Agent als 24/7-Support. Der eingebettete In-Doc-Chat beantwortet Nutzerfragen direkt aus den Docs heraus, mit Quellverweis auf die jeweilige Doku-Seite. Das ersetzt nicht den menschlichen Support für komplexe Cases, fängt aber die typischen Erstfragen (“Wie authentifiziere ich mich?”, “Wo finde ich das Webhook-Schema?”) zuverlässig ab. Für DevRel-Teams ein realer Hebel zur Reduktion von Support-Volumen.

Etablierte Referenzkunden. Anthropic, Coinbase, Microsoft, HubSpot, Notion, PayPal, Perplexity, X, Replit, Together AI, Cognition, Laravel, Lovable, Anaconda und Fidelity nutzen Mintlify produktiv. Diese Liste ist nicht nur Marketing, sie zeigt, dass die Plattform auch unter Last (Anthropic skaliert Docs für mehrere Produkte parallel) und bei strengen Sicherheitsanforderungen (Fidelity im Finanzsektor) hält. Das reduziert das Plattformrisiko für neue Kunden erheblich.

Schwächen ehrlich betrachtet

Keine dokumentierte EU-Hosting-Region. Mintlify ist ein US-Anbieter (Mintlify, Inc., San Francisco), eine dedizierte EU-Hosting-Region für gehostete Docs ist nicht dokumentiert. Für rein öffentliche API-Docs (die ohnehin im Internet stehen) ist das kein Showstopper. Für intern-vertrauliche Docs oder DSGVO-strenge Branchen ist es eines. Die Datenschutzerklärung enthält GDPR-Abschnitte samt EU/UK-Vertretern, aber das ersetzt keine europäische Hosting-Option. Wer mit personenbezogenen Daten in Docs hantiert, sollte selbst hosten oder eine europäische Alternative wählen.

Intransparentes, verbrauchsbasiertes KI-Pricing. Mit der Preisumstellung 2026 sind die KI-Funktionen an ein Credit-System gekoppelt: 5.000 Credits zum Ausprobieren, danach kaufst du Credit-Pakete (Overage 0,01 USD pro Credit). Das klingt klein, lässt sich aber kaum vorab budgetieren, bei intensiver Writing-Agent- oder Assistant-Nutzung ist schwer abzuschätzen, was am Monatsende auf der Rechnung steht. Teams sollten die Verbrauchsmetriken aktiv überwachen und prüfen, ob sich ein Credit-Limit setzen lässt. Ein klassisches Flatrate-Abo wäre für planungsbewusste Organisationen ehrlicher.

Lücke zwischen Gratis und Enterprise. Oberhalb des kostenlosen Starter-Plans gibt es derzeit keinen ausgewiesenen mittleren Bezahlplan mehr. Wer feste Funktionen wie SSO, Role-based Permissions oder einen vertraglich zugesicherten AVV braucht, muss direkt in den Enterprise-Vertrieb, dessen Preise nur auf Anfrage genannt werden. Für kleine, professionell arbeitende Teams, die mehr als Starter, aber keinen Enterprise-Vertrag wollen, ist das eine unbequeme Lücke. Im Vergleich zu reinen Docs-as-Code-Lösungen wie Docusaurus (selbst gehostet, kostenlos) musst du diese Trade-offs gegen die gepflegte Optik und die KI-Funktionen abwägen.

Englisch-only. UI, Doku und Support sind ausschließlich auf Englisch. Für deutsche Entwicklungsteams, die international arbeiten, ist das kein Hindernis. Wer aber ein deutschsprachiges Developer-Portal anbietet (z. B. für lokale Behörden- oder Versicherungs-APIs), muss die UX-Erwartung an Mintlify klar managen, das System ist auf englischsprachige Entwickler-Communities zugeschnitten.

Lock-in über MDX-Komponenten. Die Mintlify-Plattform nutzt eigene MDX-Komponenten (Callouts, Cards, Tabs, Code-Groups), die in MDX-Dateien direkt eingebettet werden. Ein Wechsel zu einer anderen Plattform bedeutet substanzielle Anpassung der Inhalte. Reines Markdown bleibt portabel, aber sobald du die Mintlify-Komponenten nutzt (was du tun wirst, weil sie gut sind), wird der Wechsel teuer.

Internes Wissen ist nicht der Sweet Spot. Mintlify ist auf öffentliche Developer-Portale optimiert. Für intern-private Knowledge Bases mit nicht-technischem Inhalt, HR, Onboarding, Prozessdokumentation, sind oder spezialisierter, günstiger und für nicht-technische Mitarbeitende besser zugänglich.

Alternativen im Vergleich

Wenn du…	…nimm stattdessen
Eine API-Design-First-Plattform mit visuellem Editor brauchst
Internes Team-Wiki mit KI-Assistenz suchst
Allgemeine Wissensbasis mit eingebauter KI willst

Erwähnenswert ohne eigene Tool-Seite: ReadMe (etablierter Mintlify-Wettbewerber mit ähnlichem API-Doc-Fokus, eigener AI-Suite und vielen Enterprise-Kunden), Fern (Code-Generation-Fokus für SDKs aus OpenAPI, oft komplementär zu Docs-Plattformen), Docusaurus (Open-Source-Framework von Meta, selbst gehostet, kostenlos, aber ohne KI-Features und mit eigenem Wartungsaufwand), GitBook (breitere Knowledge-Base-Ausrichtung), Scalar (jüngerer Open-Source-OpenAPI-Renderer mit aktiver Community) und Bump.sh (französischer Anbieter mit europäischem Hosting, interessant für DSGVO-sensible Use Cases). Mintlify ist im KI-getriebenen Doc-Segment 2026 die Referenz, wer in diesem Segment unterwegs ist, sollte Mintlify und ReadMe als ernsthafte Optionen evaluieren und sich an Code-First (Mintlify) versus UI-First (ReadMe) orientieren.

So steigst du ein

Schritt 1: Account und Repo-Anbindung. Registriere dich auf mintlify.com (Starter-Plan kostenlos, 14-Tage-Trial der KI-Funktionen mit 5.000 AI-Credits inklusive). Erstelle ein neues Projekt und verbinde dein GitHub-Repository. Mintlify legt eine Starter-Struktur mit MDX-Dateien an, die du als Vorlage nutzen kannst. Wenn du bereits eine OpenAPI-Spec hast (YAML oder JSON), lade sie direkt hoch, Mintlify generiert daraus eine vollständige interaktive Referenz-Dokumentation. Kein manuelles Ausschreiben der Endpoints.

Schritt 2: Strukturieren und Schreiben. Plane deine Navigation explizit: Getting Started, API Reference, Guides, Changelog. Nutze den Writing Agent unter “Edit” → “AI Suggestions”, um fehlende Endpoint-Beschreibungen, Parameter-Erklärungen und Beispiele ergänzen zu lassen. Überprüfe jeden Vorschlag, KI-generierte Beschreibungen brauchen immer einen fachkundigen Gegenlese-Schritt, insbesondere bei Edge Cases, Error Codes und Authentifizierung. Aktiviere den Assistant Agent erst, wenn die Basis-Doku stimmt; sonst beantwortet er Nutzerfragen mit fehlerhaftem Kontext.

Schritt 3: AI-Readiness aktivieren. Schalte llms.txt und den MCP-Server in den Projekt-Einstellungen ein. Das macht deine Docs für KI-Agenten konsumierbar, ein konkretes Verkaufsargument gegenüber deinen API-Kunden, die zunehmend in KI-getriebenen Workflows arbeiten. Teste den MCP-Server mit Claude Code oder Cursor; wenn ein Coding-Agent deine API-Calls direkt aus den Docs ableiten kann, hast du den größten DevRel-Hebel des Jahrzehnts.

Ein konkretes Beispiel

Ein Berliner SaaS-Startup (Vertical-SaaS für Personal-Tech, 14 Entwickler:innen) pflegte seine API-Dokumentation jahrelang in einem internen Confluence-Wiki, veraltet, inkonsistent, für neue Integrationspartner kaum navigierbar. Nach dem Mintlify-Import der bestehenden OpenAPI-Spec war innerhalb von drei Tagen ein öffentliches Developer-Portal live: interaktive Try-it-now-Funktion für alle 84 Endpoints, automatisch generiertes Changelog aus Git-Tags und ein Assistant Agent, der Partnerfragen direkt aus der Doku beantwortet. Drei Wochen nach Launch sank das Support-Ticket-Volumen rund um API-Integrationen um etwa 40 %, weil Standardfragen vom Assistant abgefangen wurden. Investition: kostenloser Starter-Plan plus zugekaufte AI-Credit-Pakete für die intensive Assistant-Nutzung, dazu rund 30 Stunden initiale Migrationsarbeit. Bedenken im internen Review betrafen den Datenschutz (Mintlify gibt an, Inhalte nur zur Inferenz an LLM-Anbieter weiterzugeben, nicht zum Training) und die Planbarkeit der KI-Kosten (das Team überwacht den Credit-Verbrauch seither monatlich). Gerechtfertigt wurde der Aufwand durch die entfallenen zwei bis drei Engineering-Stunden pro Sprint für Doku-Maintenance. Nach sechs Monaten überlegt das Team, den MCP-Server breiter auszurollen, damit Integrationspartner ihre Implementierung mit Claude Code direkt aus den Docs generieren können.

DSGVO & Datenschutz

• Anbieter und Hosting: Mintlify, Inc., San Francisco (1 Post St, STE 1800, CA 94104). Eine dedizierte EU-Hosting-Region für gehostete Docs ist nicht dokumentiert, du solltest von US-Datenverarbeitung ausgehen.
• Compliance: Mintlify weist auf seiner Preisseite einen Security- und Legal-Review für Enterprise aus und nennt SOC 2 in der Sicherheits-FAQ; ein öffentliches Trust Center (Drata) ist verlinkt. Die Datenschutzerklärung enthält ausführliche GDPR-Abschnitte mit Rechtsgrundlagen, Betroffenenrechten und EU/UK-Vertretern.
• Datennutzung: Laut Datenschutzerklärung werden Nachrichten an den Assistant zur Inferenz an LLM-Anbieter (Anthropic, OpenAI) weitergegeben, unter Verträgen, die ein Training auf diesen Daten untersagen. Eine Weitergabe oder ein Verkauf der Daten zu Werbe- oder Marketingzwecken wird ausgeschlossen.
• AVV (Auftragsverarbeitung): Ein dokumentierter, vertraglich zugesicherter Auftragsverarbeitungsvertrag ist Teil des Enterprise-Pakets (Legal-Review). Für den kostenlosen Starter-Plan ist eine AVV nicht standardmäßig vorgesehen.
• Zugriffskontrolle: SSO (Password, OAuth, JWT) sowie Role-based Permissions sind dem Enterprise-Plan vorbehalten; der Starter-Plan nutzt ausschließlich Mintlify-Auth.
• Empfehlung für deutsche Unternehmen: Mintlify ist für rein öffentliche Developer-Portale unkritisch, die Inhalte sind ohnehin für die Öffentlichkeit gedacht. Sobald interne oder personenbezogene Daten in den Docs landen sollen, ist die fehlende EU-Hosting-Option ein KO-Kriterium, und ein AVV ist dann nur über Enterprise erreichbar. Für DSGVO-strenge Branchen lieber selbst gehostete Alternativen (Docusaurus, Hugo + OpenAPI-Renderer) oder europäische Anbieter wie Bump.sh evaluieren.

Gut kombiniert mit

• , Stoplight als API-Design- und Mock-Plattform vor dem Mintlify-Rendering einsetzen: Stoplight für Spec-Pflege im UI, Mintlify für die kundenfacing Publishing-Schicht. Häufiges Muster in API-First-Teams.
• , Copilot oder Cursor in der IDE schreiben den Code, Mintlify dokumentiert die API. Wenn beide Seiten dieselbe OpenAPI-Spec konsumieren, bleibt der Drift zwischen Code und Doku minimal.
• , Claude als zweite KI-Instanz neben dem eingebauten Writing Agent: Für komplexe Schreibaufgaben (Migration Guides, Tutorial-Serien, Konzeptdokumente) liefert Claude oft tiefere Texte als der spezialisierte Writing Agent. Die fertigen Texte fließen dann als MDX in Mintlify ein.

Unser Testurteil

Mintlify verdient 4 von 5 Sternen. Für die Aufgabe “modernes Developer-Portal mit KI-Tooling” ist es 2026 die Referenz, schnell, gut gestaltet, mit den richtigen Standards (OpenAPI, llms.txt, MCP) und einer ernstzunehmenden Kundenbasis. Die Preisumstellung 2026 hat den Einstieg billiger gemacht, ein vollständiges Portal lässt sich kostenlos aufsetzen, gleichzeitig aber die Kostenplanung erschwert: Die KI-Funktionen laufen über ein verbrauchsbasiertes Credit-System, und oberhalb von Starter führt der Weg ohne Zwischenstufe direkt in den Enterprise-Vertrieb. Den fünften Stern verliert Mintlify durch die fehlende EU-Hosting-Region, das intransparente KI-Pricing, die Lücke zwischen Gratis und Enterprise sowie den Lock-in über proprietäre MDX-Komponenten. Wer ein API-Produkt vermarktet und Englisch als Doc-Sprache akzeptiert, sollte Mintlify als Default-Option setzen. Für interne Knowledge Bases, deutschsprachige Portale oder strikt EU-konforme Use Cases sind andere Lösungen passender, das ist nicht Mintlifys Anspruch, und das ist in Ordnung.

Was wir bemerkt haben

• 2024, Mintlify hat als eine der ersten kommerziellen Docs-Plattformen llms.txt und MCP-Server-Generierung nativ integriert. Damit hat Mintlify das Thema “AI-readable Docs” als Kategorie etabliert, bevor es Standard wurde, ein klassischer Standardisierungs-Vorteil, den Wettbewerber jetzt nachholen müssen.
• 2025, Migration prominenter Kunden wie Anthropic, Perplexity und Cognition (Devin) auf Mintlify. Diese Plattform-Wahlen großer KI-Player haben Mintlifys Marktposition im “KI-Doku-Segment” zementiert.
• 2025, Einführung des Assistant Agent als In-Doc-Chat. Damit positioniert sich Mintlify nicht mehr nur als Publishing-Plattform, sondern als interaktive Doku-Erlebnis-Schicht, vergleichbar mit dem Schritt, den Intercom in der Customer-Support-Branche gegangen ist.
• 2026, Mintlify hat sein Preismodell umgebaut. Der frühere mittlere Bezahlplan (“Pro”, zuletzt rund 250 USD/Monat) wird auf der Preisseite nicht mehr ausgewiesen. Stand Juni 2026 gibt es öffentlich nur noch den kostenlosen Starter-Plan und Enterprise auf Anfrage. Frühere Versionen dieser Seite nannten Pro als Sweetspot-Stufe, das stimmt nicht mehr und wurde korrigiert.
• 2026, Die KI-Funktionen (Assistant, Writing Agent, Workflows) sind im Starter-Plan enthalten, laufen aber über ein verbrauchsbasiertes Credit-System: 5.000 Credits zum Ausprobieren, danach kostenpflichtige Credit-Pakete (Overage 0,01 USD/Credit). Das senkt die Einstiegshürde, macht die laufenden KI-Kosten aber schwerer planbar.
• 2025, Mintlify positioniert sich zunehmend als “AI-native” Plattform und hat Funktionen wie Agent Analytics, GEO-Optimierungen und einen “Agent Score” eingeführt, die Docs gezielt für KI-Agenten und KI-getriebene Suche aufbereiten.
• Juni 2026, Keine dokumentierte EU-Hosting-Region. Die Datenschutzerklärung enthält GDPR-Abschnitte und EU/UK-Vertreter, eine dedizierte europäische Hosting-Region für gehostete Docs fehlt aber weiterhin. Für DSGVO-strenge Use Cases bleibt das ein Grund, europäische Alternativen oder Self-Hosting zu prüfen.