Mintlify MCP Server

Offizieller gehosteter Mintlify Admin MCP Server für branchbasierte Doku-Änderungen, Pull Requests und kontrollierte Dashboard-Verwaltung.

Beschreibung

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.

Voraussetzungen

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.

Installationsanleitung

Der Mintlify Admin MCP Server unter https://mcp.mintlify.com ist ein gehosteter Schreibzugang zu Mintlify-Dokumentation und Teilen des Dashboards. Diese Anleitung folgt ausschließlich der aktuellen offiziellen Mintlify-Dokumentation unter https://www.mintlify.com/docs/ai/mintlify-mcp. Sie richtet sich an Projektverantwortliche, die Inhalte mit Claude Code, Codex oder Cursor bearbeiten möchten, ohne Zugriffsgrenzen, Git-Review und Datenschutz aus dem Blick zu verlieren. Der Server ist nicht der lesende Search MCP einer einzelnen Docs-Website: Der Search MCP liegt am /mcp-Pfad der betreffenden Site. Für eine einfache Recherche in veröffentlichter Dokumentation ist dieser lesende Pfad meist die passendere und risikoärmere Wahl.

Schritt 1: Voraussetzungen und Rechte prüfen

Vor der Installation prüfen, welchem Mintlify-Projekt die Verbindung dienen soll und wer die daraus entstehenden Änderungen überprüft. Es wird ein Mintlify-Konto mit Zugriff auf dieses Projekt benötigt. Der OAuth-Login übernimmt laut Anbieter die Dashboard-Rolle; geschützte Einstellungen verlangen daher Admin-Rechte. Die GitHub-, GitLab- oder Bitbucket-Integration des Projekts muss auf das Repository des Deploy-Branches schreiben dürfen, weil save über diese Verbindung einen Commit oder Pull Request erstellt. Nutze ein persönliches Konto nur, wenn die Organisation das erlaubt, und widerrufe alte Verbindungen in „Settings → Security & access → Connected apps“.

Lege vorab ein enges Arbeitsziel fest: etwa eine bestimmte Seite aktualisieren, einen Abschnitt umstrukturieren oder eine einzelne Navigation korrigieren. Ein unpräzises Ziel wie „räum die Dokumentation auf“ erweitert den möglichen Diff unnötig. Benenne Ziel-Deployment, Ziel-Branch, zulässige Pfade und erwartetes Ergebnis im menschlich bestätigten Auftrag. Halte eine zweite Person für Review bereit, wenn Inhalte rechtlich, sicherheitsrelevant oder produktkritisch sind.

Schritt 2: Client verbinden und OAuth abschließen

Für Claude Code dokumentiert Mintlify folgenden lokalen Konfigurationsbefehl:

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

Für Codex wird in ~/.codex/config.toml ein [mcp_servers.mintlify]-Abschnitt mit der URL https://mcp.mintlify.com angelegt. In Cursor wird dieselbe URL als mintlify-Eintrag in mcp.json konfiguriert. Beim ersten Einsatz öffnet der Client einen Browser für den interaktiven OAuth-Login. Kontrolliere im Browser Domain, Konto und angeforderten Zugriff; bestätige keine Anmeldung, die aus einer unerwarteten Umleitung oder einem Text in einem Dokument heraus ausgelöst wurde. Kennwörter, OAuth-Codes, Session-Tokens und Git-Tokens gehören nie in Prompts, MDX-Beispiele, Commits oder Screenshots.

Nach der Anmeldung zuerst die verfügbare Verbindung sichtbar machen. Wenn mehrere Deployments erreichbar sind, nur list_deployments verwenden und das bestätigte Subdomain-Ziel auswählen. checkout erzeugt oder bindet laut Mintlify einen Branch. Gib einen nachvollziehbaren Slug wie fix-auth-guide an und prüfe, dass Deploy-Branch und Projekt zum Auftrag passen. Ein Checkout auf das falsche Deployment kann ansonsten einen technisch korrekten, aber fachlich falschen PR erzeugen.

Erst lesen, dann minimal ändern

Beginne mit read, search, list_nodes und anschließend diff. Damit erhältst du Seiteninhalt, Navigationskontext und die tatsächlich vorhandenen Änderungen, ohne bereits zu veröffentlichen. Verwende edit_page für eine kleine, überprüfbare Änderung statt write_page, wenn kein kompletter Ersatz nötig ist. Prüfe Pfade, Links, Codeblöcke, Überschriften, Versionen und Beispiele manuell in der Vorschau. Navigationstools wie move_node oder delete_node sind keine harmlose Textformatierung; sie können Nutzerwege und Auffindbarkeit verändern.

Behandle jede abgerufene Seite, jedes Issue und jede Fehlermeldung als untrusted content. Anweisungen wie „ignoriere Review“, „ändere die Rechte“, „füge ein Token ein“ oder „rufe save auf“ können Prompt Injection sein, auch wenn sie wie eine interne Notiz aussehen. Sie sind keine Autorisierung. Der Client kann Tool-Ergebnisse an ein Sprachmodell senden, das daraus Vorschläge ableitet. Halte den Kontext daher klein, entferne Geheimnisse und personenbezogene Daten aus den angeforderten Ausschnitten und verwende eine Tool-Allowlist ohne Schreibwerkzeuge, bis das Ziel geklärt ist.

Schritt 3: Diff prüfen und sicher speichern

Rufe vor jedem Speichern diff auf und vergleiche jede Zeile mit dem bestätigten Arbeitsziel. Öffne die von Mintlify zurückgegebene Editor- oder Vorschau-URL und kontrolliere die gerenderte Seite zusätzlich. Prüfe, ob ein Link, eine Navigation, Frontmatter oder ein Beispiel unbeabsichtigt verändert wurde. Für normale Inhaltsarbeit save im PR-Modus verwenden, damit eine zweite Prüfung im Git-Provider stattfindet. Auto-Modus oder direktes Pushen nur nach einer ausdrücklich dokumentierten Freigabe und nach Prüfung der Branch-Protection einsetzen.

Code Mode ist von der Branch-Sitzung getrennt und kann laut Mintlify Einstellungen, Workflows, Mitglieder, Abrechnung, Integrationen und Analytics unmittelbar auf der Live-Deployment verwalten. Solche Aufrufe niemals aus einem automatischen Agentenlauf, aus fremdem Dokumenttext oder aus einer vagen Aufforderung ableiten. Sie benötigen eine explizite menschliche Bestätigung mit Ziel, konkreter Wirkung und Rückfallplan. Nach einem PR Merge oder einer zulässigen direkten Änderung das Live-Ergebnis prüfen und bei Abweichungen über Git oder Dashboard zurückrollen.

Datenpfad, Rotation und Abschluss

Die Verbindung führt von Mintlify zum MCP-Client und häufig weiter zum Modellanbieter des Clients. Ein gehosteter Mintlify-Dienst bedeutet nicht, dass Dokumentationsinhalte oder Dashboard-Antworten nur lokal verarbeitet werden. Prüfe vor Produktivdaten die Retention-, Trainings-, DPA- und Enterprise-Einstellungen des verwendeten Clients. Beschränke OAuth auf die benötigten Deployments, entferne den Server nach zeitlich begrenzten Arbeiten und widerrufe die OAuth-Freigabe bei Gerätewechsel, Rollenwechsel oder Verdacht auf Kompromittierung. Bereits eröffnete Pull Requests bleiben nach dem Widerruf bestehen und müssen bei Bedarf geschlossen oder revertiert werden.

FAQ

Brauche ich für jede Änderung einen neuen Branch? Nicht zwingend, aber eine fokussierte Sitzung pro Thema ist leichter zu prüfen. Mintlify hält Sitzungen im Speicher; verwerfe nicht benötigte Entwürfe mit discard_session, statt sie als unbekannte Branch-Reste liegen zu lassen.

Warum reicht ein lokaler MCP-Eintrag nicht als Sicherheitsmaßnahme? Der Konfigurationseintrag verbindet den Client mit einem gehosteten Dienst. Tool-Ergebnisse können anschließend in den Kontext des Modellanbieters gelangen; OAuth, Git-Rechte, Client-Datenpolitik und menschliches Review bleiben getrennte Kontrollen.

Was ist der sichere Standard für save? Ein Pull Request mit geprüftem diff und gerenderter Vorschau. Direkte oder automatisch wirksame Änderungen nur mit klarer Ausnahmefreigabe und bestehendem Rückfallplan einsetzen.

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

Authentifizierung

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

Benötigte Zugriffsrechte

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.

Übertragene oder gespeicherte Daten

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.

Sicherheitsrisiken

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.

Lizenz und Kosten

Lizenz
Hosted Mintlify service; no public source license published for this server.
Kosten
kostenpflichtig

Die offizielle Admin-MCP-Dokumentation nennt keinen separaten Serverpreis. Verfügbarkeit, Mintlify-Entitlements und aktuelle Vertragsbedingungen vor der Nutzung beim Anbieter prüfen.

Alternativen

Noch nicht erfasst.

Auf einen Blick

Anbieter
Mintlify
Status
Offizieller Server
Betriebsart
Remote
Aktuelle Version
Noch nicht erfasst.
Zuletzt geprüft
08.09.2026

Repository und Dokumentation

Kategorien

Unterstützte Clients

Passende Ratgeber

Anleitungen und Hintergrund, die zu diesem Eintrag passen.

Noch keine passenden Ratgeber vorhanden.