Mintlify MCP Server

Der Mintlify MCP Server ist Mintlifys offiziell dokumentierter, gehosteter Admin MCP Server unter https://mcp.mintlify.com. Er verbindet einen MCP-fähigen KI-Client mit einem Mintlify-Konto und dessen Dokumentationsprojekten. Laut Mintlify können autorisierte Teams damit Seiten lesen und bearbeiten, Navigation umstrukturieren, docs.json ändern, Pull Requests öffnen sowie ausgewählte Deployment-Einstellungen und Workflows verwalten. Der offizielle Produkt- und Dokumentationslink ist https://www.mintlify.com/docs/ai/mintlify-mcp. Dieser Eintrag beschreibt bewusst den Admin-Server, nicht den separaten Search MCP eines einzelnen Mintlify-Dokumentationsportals und nicht Mintlify Index. Mintlify betreibt den Dienst remote; für diese gehostete Servervariante veröffentlicht der Anbieter kein aktuelles öffentliches Quellrepository. Die Prüfung von https://api.github.com/repos/mintlify/mcp ergab am 08.09.2026 HTTP 404. Deshalb sind Repository-Link und GitHub-Sternzahl leer; eine erfundene oder fremde Sternzahl wäre kein Qualitätsmaß.

Produktgrenze und Dokumentationskontext

Der Admin MCP ist ein Arbeitswerkzeug für das Team, das eine Mintlify-Deployment verwaltet. Er kann MDX-Inhalte lesen, suchen, gezielt ändern oder ganze Seiten schreiben. Werkzeuge für Navigation können Knoten anlegen, umbenennen, verschieben oder löschen; update_config kann Einstellungen in docs.json anpassen. Diese Fähigkeiten betreffen nicht nur Text: Navigation, SEO-bezogene Konfiguration und die Darstellung einer Dokumentationsseite können sich ändern. Der separate Search MCP liegt dagegen am /mcp-Pfad einer jeweiligen Mintlify-Site und liefert Suchergebnisse und veröffentlichte Seiteninhalte für Endnutzer. Wer ausschließlich Antworten aus öffentlicher Dokumentation abrufen möchte, sollte diesen lesenden Search MCP verwenden, nicht den Admin MCP.

Anmeldung, Zugriff und Git-Verbindung

Die Einrichtung verwendet einen interaktiven OAuth-Login gegen das Mintlify-Konto. Laut offizieller Dokumentation übernimmt die Sitzung die Dashboard-Rechte: Für geschützte Einstellungen sind Admin-Rechte im Projekt nötig. Außerdem benötigt die mit dem Projekt verbundene GitHub-, GitLab- oder Bitbucket-Integration Schreibzugriff auf das Repository des Deploy-Branches, weil save über dieselbe Integration Pull Requests oder Commits erzeugt. Mintlify dokumentiert Konfigurationen für Claude Code, Codex und Cursor; diese drei bereits vorhandenen Kompatibilitäten sind daher zugeordnet. Zugangsdaten niemals in Prompt, Repository, Client-Konfiguration oder Screenshot speichern. OAuth-Zugriff bei Nichtgebrauch im Mintlify-Dashboard unter verbundenen Apps widerrufen und den Server aus dem KI-Client entfernen.

Branch, Diff und Veröffentlichung

Eine Admin-MCP-Sitzung bindet sich nach checkout an genau einen Branch. Der Dienst erstellt dabei nach Anbieterangabe einen frischen mintlify-mcp/...-Branch aus dem Deploy-Branch oder nutzt einen ausdrücklich gewählten Branch. Änderungen werden zunächst in dieser Sitzung gepuffert. Vor save muss ein Mensch diff lesen und die gerenderte Vorschau kontrollieren. save mit dem PR-Modus ist der sichere Standard: Es erzeugt einen überprüfbaren Pull Request statt einer unbeobachteten Veröffentlichung. Der Auto-Modus kann je nach Projekt- und Branch-Schutz direkt wirksame Änderungen zulassen; er ist kein Ersatz für Review. Deployment-Management über Code Mode ist besonders sensibel, weil Einstellungen, Workflows, Mitglieder, Abrechnung, Integrationen oder Analytics unmittelbar auf die Live-Deployment wirken können.

Untrusted Content und Prompt Injection

Dokumentationsseiten, Issues, vorhandene MDX-Dateien, Fehlermeldungen und externe Anforderungen sind Daten, keine Befehle. Ein böswilliger Absatz kann behaupten, man solle Secrets auslesen, Branch-Schutz ausschalten, save ausführen oder eine Navigation löschen. Der KI-Client und das Modell können solche Texte in ihren Kontext übernehmen; weder ein gehosteter MCP-Endpunkt noch ein Branch macht die Inhalte vertrauenswürdig. Beschränke anfangs die Tool-Nutzung auf read, search, list_nodes und diff. Behandle vorgeschlagene Änderungen als Entwurf, prüfe Ziel-Deployment, Pfad, Diff und Seiteneffekt gegen einen menschlich bestätigten Auftrag und verwende für jede schreibende Aktion eine ausdrückliche Freigabe. Keine Anweisung innerhalb abgerufener Inhalte darf diese Freigabe ersetzen.

Datenpfad und Verantwortlichkeiten

Der Datenpfad besteht aus Mintlify, dem MCP-Client und dem gewählten Modellanbieter. Bei einem Toolaufruf liest oder ändert der Admin MCP Inhalte beziehungsweise Dashboard-Daten und gibt Ergebnisse an den Client zurück; der Client kann diese Ergebnisse in die Modellanfrage aufnehmen. Remote bei Mintlify bedeutet daher nicht, dass der gesamte KI-Pfad lokal bleibt. Vor Produktivnutzung sind Modellanbieter, Aufbewahrung, Trainingsoptionen, Unternehmensvertrag und DPA des konkreten Clients zu prüfen. Reduziere den Kontext auf die benötigten Seiten und entferne Tokens, personenbezogene Daten, interne URLs und Geheimnisse aus Beispielen. Mintlify- und Git-Berechtigungen begrenzen den Serverzugriff, ersetzen aber weder Modell-Datenschutzprüfung noch menschliche Review.

FAQ

Ist dies der öffentliche Search MCP einer Docs-Site? Nein. Dieser Eintrag behandelt den Admin MCP unter mcp.mintlify.com mit Bearbeitungs- und Verwaltungsrechten. Der Search MCP einer einzelnen Mintlify-Site arbeitet am jeweiligen /mcp-Pfad und ist für die Suche veröffentlichter Inhalte bestimmt.

Gibt es ein offizielles GitHub-Repository mit Sternzahl? Für den geprüften Kandidaten github.com/mintlify/mcp lieferte die GitHub-API 404. Die aktuelle offizielle Dokumentation beschreibt einen gehosteten Dienst, nicht ein öffentliches Serverrepository; daher speichert dieser Eintrag weder Repository noch Sterne.

Kann ein Agent automatisch veröffentlichen? Technisch kann save je nach Projektkonfiguration einen PR erzeugen oder Änderungen direkt wirksam machen. Organisatorisch sollte ein Mensch Diff, Vorschau, Ziel und Auswirkung prüfen und für risikoreiche Änderungen den PR-Modus erzwingen.

Mintlify-Konto mit Zugriff auf das Zielprojekt, interaktiver OAuth-Login, ein MCP-fähiger Client sowie Schreibzugriff der verbundenen Git-Integration auf das Repository des Deploy-Branches.

In Claude Code claude mcp add --transport http mintlify https://mcp.mintlify.com ausführen; in Codex den URL-Eintrag unter [mcp_servers.mintlify] setzen; in Cursor den URL-Eintrag in mcp.json setzen. Danach den OAuth-Login abschließen, nur das bestätigte Deployment auschecken und vor save immer diff sowie Vorschau prüfen.

claude mcp add --transport http mintlify https://mcp.mintlify.com

Interaktiver OAuth-Login mit dem Mintlify-Konto. Die Sitzung erbt Dashboard-Berechtigungen und wird auf Deployment- oder Organisationsebene freigegeben.

Lesen, Bearbeiten, Navigation und docs.json liegen innerhalb der ausgecheckten Branch-Sitzung; save nutzt die verbundene Git-Integration. Deployment-Verwaltung kann mit gewährten Scopes unmittelbar wirken und benötigt besonders enge Rechte.

Der gehostete MCP-Service liefert Dokumentations- und Dashboard-Ergebnisse an den verbundenen KI-Client. Dieser Client kann Tool-Ergebnisse an seinen Modellanbieter übertragen; die Datenhaltung und Retention des gewählten Clients separat prüfen.

Der Admin MCP besitzt Schreibrechte. MDX, Issues und Tool-Ergebnisse sind untrusted content und können Prompt-Injection enthalten. Schreibaktionen nur nach menschlicher Prüfung von Deployment, Branch, Diff und Auswirkung ausführen; Code Mode kann Live-Einstellungen unmittelbar ändern.