Retool MCP Server

Der Retool MCP Server verbindet KI-Assistenten mit der eigenen Retool-Organisation. Retool ist eine verbreitete Plattform, auf der Unternehmen interne Werkzeuge bauen: Verwaltungsoberflächen für den Kundendienst, Freigabe-Dashboards, Datenbank-Frontends oder automatisierte Workflows. Mit dem MCP-Server lassen sich solche Apps aus Claude, Codex, Cursor oder ChatGPT heraus erstellen und weiterentwickeln, angebundene Datenquellen abfragen und die Benutzerverwaltung erledigen, ohne die Retool-Oberfläche zu öffnen. MCP, das Model Context Protocol, ist ein offener Standard, über den ein KI-Assistent externe Werkzeuge aufruft. Betrieben wird der Server von Retool selbst; es gibt nichts zu installieren.

Wie der Server bereitgestellt wird

Jede Retool-Instanz bringt ihren eigenen MCP-Endpunkt mit. Die Adresse folgt dem Muster https://ihre-instanz.retool.com/mcp, bei selbst betriebenen Installationen entsprechend die eigene Domain. Der Server spricht HTTP als Transport und meldet Nutzer per OAuth 2.0 an. Beim ersten Verbinden öffnet sich ein Browserfenster, in dem Sie sich bei Retool anmelden und die gewünschten Berechtigungen auswählen. Laut Retool steht der Server in der Cloud bereit und auf selbst betriebenen Instanzen ab Version 4.0.0. Gestartet ist er am 23. April 2026 als Public Beta für alle Pläne, zunächst nur mit Werkzeugen für Organisation und Benutzer. Inzwischen hat Retool den App-Bau ergänzt.

Wichtig ist die Abgrenzung zur sogenannten MCP-Ressource in Retool. Die bindet umgekehrt fremde MCP-Server in Retool-Apps, Workflows und Agenten ein. Der hier beschriebene Server öffnet dagegen Retool selbst für externe Assistenten.

Apps per Prompt bauen

Der auffälligste Funktionsbereich ist der App-Bau. Sie beschreiben im Editor oder Chat, was Sie brauchen, etwa "eine Oberfläche, in der der Support Bestellungen nach Kundennummer findet und Erstattungen anstößt". Ihr lokaler Assistent reicht den Auftrag an den App-Bau-Agenten von Retool weiter. Der erzeugt die App und liefert einen Vorschau-Link zurück. Über weitere Werkzeuge verfolgt der Assistent den Fortschritt, liest die erzeugten Dateien, beantwortet Rückfragen des Agenten (Human in the Loop), bricht hängende Läufe ab und veröffentlicht die App am Ende in einen Ordner. Auch bestehende React-Apps lassen sich importieren. Klassische Retool-Apps aus dem Drag-and-drop-Editor baut der Server laut Dokumentation nicht. Die App-Werkzeuge erfordern den Scope mcp:write.

Ressourcen, Daten und Verwaltung

Der zweite Bereich sind Ressourcen, so nennt Retool die angebundenen Datenbanken, APIs, Speicher und KI-Anbieter. Der Assistent listet sie auf, liest ihre Konfiguration, legt neue an und kann für ausgewählte Ressourcen TypeScript-Definitionen erzeugen. Anschließend führt er kurze TypeScript-Abfragen dagegen aus, etwa für eine schnelle Datenanalyse. Der dritte Bereich ist die Organisation: Benutzer und Einladungen auflisten, Einladungen in großer Zahl verschicken oder zurückziehen, Workflows, Ordner und Umgebungen einsehen sowie Audit-Logs durchsuchen. Diese Werkzeuge verlangen den Scope mcp:admin, den nur Organisations-Administratoren wählen können. Audit-Logs gibt es laut Werkzeugliste nur in den Plänen Business und Enterprise, Berechtigungsgruppen nur in Enterprise.

Rechte und Sicherheit

Die OAuth-Scopes heißen mcp:read, mcp:write und mcp:admin. Laut Retool gewähren sie nie mehr, als das eigene Retool-Konto ohnehin darf. Der Assistent sieht nur Apps, Ressourcen und Workflows, für die Sie berechtigt sind. Trotzdem gilt: Ein Werkzeug wie retool_execute_resource_ts führt Code gegen echte Datenbanken aus, und retool_delete_workflow löscht ohne Papierkorb. Beginnen Sie deshalb mit mcp:read und vergeben Sie Schreib- und Admin-Rechte erst, wenn Sie sie brauchen.

Kosten und Voraussetzungen

Der MCP-Server selbst kostet laut Retool nichts extra und steht in allen Plänen bereit, auch im kostenlosen Plan für kleine Teams. Verwaltungs- und Abfrageaufgaben verbrauchen keine Retool-Credits. Der App-Bau dagegen verbraucht KI-Credits aus dem monatlichen Kontingent des Plans, außer bei Enterprise-Kunden mit eigenem API-Schlüssel. Hinzu kommen die Kosten Ihres lokalen Assistenten, der separat abrechnet. Neben dem kostenlosen Einstieg führt Retool die kostenpflichtigen Pläne Team und Business sowie Enterprise mit individuellem Angebot; Details stehen auf der Preisseite von Retool.

Für wen lohnt sich der Retool MCP Server?

Er lohnt sich für Teams, die interne Werkzeuge bereits auf Retool bauen oder damit anfangen wollen. Entwickler können eine erste Version einer Admin-Oberfläche direkt aus Claude Code oder Cursor anstoßen und den Fortschritt im gewohnten Werkzeug verfolgen. Administratoren erledigen wiederkehrende Aufgaben per Satz statt per Klick, etwa "Wer hat seit drei Monaten keinen Zugriff mehr genutzt?" oder "Lade diese 40 Adressen in die Gruppe Support ein". Wer Retool nicht nutzt, hat keinen Vorteil, denn der Server spricht nur die eigene Retool-Instanz an.

Eine Retool-Organisation in der Cloud oder eine selbst betriebene Instanz ab Version 4.0.0, ein Retool-Konto mit passenden Rechten (für Verwaltungswerkzeuge Organisations-Administrator) und ein MCP-Client mit HTTP-Transport und OAuth, etwa Claude Code, Claude, Codex, ChatGPT im Entwicklermodus, Cursor, Kiro CLI oder VS Code ab 1.102 mit GitHub Copilot Chat.

Mit dem Retool MCP Server baut ein KI-Assistent interne Apps in Retool, fragt angebundene Datenquellen ab und erledigt die Benutzerverwaltung. Dieser Ratgeber führt von der Einrichtung bis zur ersten App.

Schritt 1: Voraussetzungen

Sie brauchen eine Retool-Organisation in der Cloud oder eine selbst betriebene Instanz ab Version 4.0.0 und einen MCP-Client mit HTTP-Transport und OAuth, etwa Claude Code, Codex, Cursor oder VS Code ab 1.102 mit GitHub Copilot Chat. Für die Verwaltungswerkzeuge müssen Sie Organisations-Administrator sein. Die Adresse Ihres Servers ist die Adresse Ihrer Instanz mit angehängtem /mcp, zum Beispiel https://ihre-instanz.retool.com/mcp.

Schritt 2: In Claude Code einbinden

Der Befehl lautet claude mcp add --transport http retool https://ihre-instanz.retool.com/mcp. Starten Sie danach eine neue Sitzung, rufen Sie /mcp auf, wählen Sie retool und melden Sie sich im Browser bei Retool an. Dort wählen Sie auch die Scopes aus.

claude mcp add --transport http retool https://ihre-instanz.retool.com/mcp

Schritt 3: Codex, Cursor und VS Code

In Codex genügt codex mcp add retool --url https://ihre-instanz.retool.com/mcp; anschließend bestätigen Sie die Scopes im Browser. In Cursor tragen Sie unter mcpServers einen Eintrag retool mit "type": "http" und der Adresse ein, global in den Einstellungen oder in .cursor/mcp.json im Projekt. Die Anmeldung startet beim ersten Werkzeugaufruf. In VS Code legen Sie eine Datei .vscode/mcp.json an, wählen Add Server, dann HTTP, und geben die Adresse ein. Die Einstellung chat.mcp.access darf nicht auf none stehen.

codex mcp add retool --url https://ihre-instanz.retool.com/mcp

Claude und ChatGPT

In der Claude-App finden Nutzer der Pläne Free, Pro und Max Retool unter Customize, Connectors, Browse connectors. In Team- und Enterprise-Organisationen muss ein Owner den Server als benutzerdefinierten Connector hinzufügen. In ChatGPT ist der Entwicklermodus nötig; dort legen Sie unter Settings, Apps, Advanced settings eine neue App mit der Adresse und OAuth an.

Den passenden Scope wählen

mcp:read erlaubt nur lesende Werkzeuge, etwa Apps und Ressourcen auflisten. mcp:write ist für den App-Bau und für Ressourcen-Änderungen nötig, ebenso für das Ausführen von TypeScript gegen Datenquellen. mcp:admin schaltet Benutzer, Einladungen, Workflows und Audit-Logs frei und steht nur Administratoren zur Wahl. Kein Scope gewährt mehr, als Ihr Retool-Konto ohnehin darf.

Die erste App bauen

Beschreiben Sie in Ihrem Assistenten, was die App leisten soll, zum Beispiel: "Baue in Retool eine Oberfläche, in der ich Bestellungen aus unserer Postgres-Ressource nach Kundennummer suche." Der Assistent gibt den Auftrag an den App-Bau-Agenten von Retool weiter und liefert einen Vorschau-Link zurück. Stellt der Agent Rückfragen, beantworten Sie sie im Chat. Gefällt Ihnen das Ergebnis, lassen Sie die App in einen Ordner veröffentlichen.

OAuth 2.0 mit Anmeldung im Browser; beim Zustimmen werden die Scopes mcp:read, mcp:write und mcp:admin (nur für Organisations-Administratoren) ausgewählt.

Lesend: Apps, App-Zugriffe, Ressourcen und deren Konfiguration, Workflows, Ordner, Umgebungen, Benutzer, Einladungen, Organisationseinstellungen und (Business/Enterprise) Audit-Logs. Schreibend: Apps per Prompt erstellen, ändern, importieren und veröffentlichen, App-Zugriffe vergeben und entziehen, Ressourcen anlegen und ändern, TypeScript gegen Ressourcen ausführen, Einladungen anlegen und löschen, Workflows löschen. Was gelingt, hängt von Scope und Konto-Rechten ab.

Der Server läuft auf der jeweiligen Retool-Instanz, in der Cloud also bei Retool, selbst betrieben in der eigenen Infrastruktur. Abgefragte Daten aus Ressourcen, Benutzerlisten und Audit-Logs gelangen in den Kontext des KI-Clients und damit zum jeweiligen Modellanbieter. Beim App-Bau verarbeitet zusätzlich der App-Bau-Agent von Retool den Auftrag, mit von Retool verwalteten Schlüsseln oder bei Enterprise mit eigenem Schlüssel.

Mit mcp:write kann der Assistent TypeScript gegen echte Datenbanken und APIs ausführen, Ressourcen-Konfigurationen ändern und Apps veröffentlichen; mit mcp:admin Einladungen verschicken und Workflows löschen. Inhalte aus Datenbanken, Apps oder Audit-Logs können Prompt Injection enthalten. Mit mcp:read beginnen, Admin-Scope nur bei Bedarf wählen und schreibende Aktionen im Client bestätigen.