AI & Agents
Der Remote-MCP-Endpunkt
Der MCP-Server ist ein Entwicklertool: Er läuft auf Ihrem Rechner und enthält einen Service-Key
oder einen API-Key. Ein deploytes Backend kann MCP unter /mcp auch selbst bereitstellen,
für die Personen, die Ihre Anwendung nutzen. Ein Assistent, den einer von ihnen verbindet, liest und
schreibt im Projekt als diese Person, und jeder Aufruf wird unter deren eigener
Row-Level-Security ausgeführt.
Es ist standardmäßig deaktiviert, und beide Variablen sind erforderlich:
REBASE_MCP_ENABLED=trueREBASE_PUBLIC_URL=https://app.example.com # this deployment's real originOhne REBASE_PUBLIC_URL, ein JWT-Secret oder einen Datentreiber, der eine Abfrage
auf einen einzelnen Benutzer einschränken kann, verweigert der Endpunkt das Einbinden und nennt die Begründung im Boot-Log. Keine
REBASE_ROLE aktiviert ihn.
-
OAuth mit einem Zustimmungsbildschirm. Ein Client findet den Autorisierungsserver über
/.well-known/oauth-protected-resource, registriert sich selbst (dynamische Registrierung ist standardmäßig aktiv;REBASE_MCP_OPEN_REGISTRATION=falsebeschränkt sie auf Clients, die Sie registrieren) und leitet die Person zu einem Zustimmungsbildschirm weiter, der sie über Ihr bestehendes/auth/loginanmeldet. Ein Konto mit einem zweiten Faktor wird anschließend über die bestehenden/auth/mfa/challenge-Routen nach seinem Authenticator-Code oder einem Wiederherstellungscode gefragt. Wenn das Frontend Ihrer eigenen App eine Sitzung im selben Browser hält, bietet der Bildschirm dieses Konto an, und „Zulassen“ erteilt die Zustimmung ohne Passwort; so verbindet sich jemand, der sich nur mit Google, GitHub oder einem E-Mail-Link anmeldet. Andernfalls erfolgt die Anmeldung mit einem Passwort, und Personen ohne Passwort richten zuerst über/auth/forgot-passwordeines ein („Passwort vergessen“ Ihrer App); der Bildschirm weist sie darauf hin. Er nennt auch den Host, an den der Autorisierungscode gesendet wird, und weist darauf hin, dass dieser Host nicht verifiziert ist: Jeder kann einen Client unter einem beliebigen Namen registrieren, daher ist der Host der Teil, den eine Person überprüfen kann. -
Siebzehn Tools, drei Scopes. Dieselben Scopes, die alle Zugangsdaten verwenden.
data:readbietetlist_collections,describe_collection,query_collection,count_documents,aggregate_documents,get_document, die drei Ansichten,show_collection,show_recordundshow_app,show_app_guidesowie die experimentellenlist_appsundopen_app;data:writefügtcreate_document,update_documentund die experimentellensave_appunddelete_apphinzu;data:deletefügtdelete_documenthinzu. Ein Client, der nichts anfordert, erhältdata:read. Jeder Scope lässt sich auf eine Collection eingrenzen:data:read:postslistet, beschreibt und liestpostsund sonst nichts. Ein Scope entscheidet, welche Tools angeboten werden und welche Collections sie erreichen, nicht welche Zeilen: Eine leere Liste kann bedeuten, dass RLS greift, unddata:writekann weiterhin keine Zeile schreiben, zu der die Person keine Berechtigung hat. -
Drei Tools bringen Ihr Admin-Panel direkt zur Person. In einem Client, der MCP Apps rendert (wie etwa Claude), öffnen sie die Ansichten des Admin-Panels direkt in der Konversation, basierend auf Ihren Collections: deren Feldern, Enums, Validierungen, Relationen, Formularabschnitten und Ansichtseinstellungen.
-
show_collectionakzeptiert die Argumente vonquery_collectionsowieview(table,list,cardsoderkanban) und öffnet die Collection-Ansicht: Die Person kann suchen, filtern, sortieren und paginieren, das Formular einer Zeile öffnen und Zeilen hinzufügen. -
show_recordöffnet das Formular einer Zeile (id) oder ein Formular für eine neue Zeile, das mit den vom Modell ausgefülltenvaluesvorausgefüllt ist, damit die Person es selbst prüfen und speichern kann. -
show_appführt eine App aus, die das Modell für die jeweilige Aufgabe schreibt: eine React-Komponente (code) und diecollections, die sie liest. Sie importiert die Rebase-eigenen Pakete, sodass derselbe Code in Ihrem Projekt funktioniert:@rebasepro/app:useRows,useRow,useRowCount,useAggregateunduseRowWritesüber die Zeilen des Projekts;@rebasepro/cms: dasCollectionPaneldes Admin-Panels (mitCollectionToolbarund dessen Komponenten sowieonRowClick, das der App die angeklickte Zeile so übergibt, wieuseRowssie liest),RecordFormundFormField,RecordDetail,FieldValueunduseSidePanel, wobei jede Komponente ihre Collection über den Pfad benennt, mit Ihren benutzerdefinierten Feldern, Ansichten und Aktionen;@rebasepro/ui: das gesamte UI-Kit, einschließlichSplitViewsowie KPI-Kacheln und Diagrammen.
Der Server kompiliert den Code zuerst; ein Syntaxfehler, ein Modul, das die Ansicht nicht bereitstellt, oder ein Name, den sie aus
@rebasepro/cmsoder@rebasepro/appnicht anbietet, führt zu einem Fehler beim Aufruf samt Zeilenangabe. Ein Fehler während der Ausführung wird an entsprechender Stelle angezeigt und dem Modell mit der nächsten Nachricht der Person mitgeteilt. Eine App darf nur die Collections verwenden, die sie auflistet. Für Styles werden die Standard-Utilities von Tailwind verwendet, die vor dem Laden der App mit der Ansicht gebaut werden: Ein willkürlicher Wert wieh-[560px]hat dort keine Wirkung, daher wird eine exakte Größe überstyledefiniert.Die Beschreibung von
show_appenthält nur das Wesentliche, weil ein Client eine lange Tool-Beschreibung abschneiden kann (claude.ai tut das bei etwa 4.000 Zeichen). Sie weist das Modell an, zuerstshow_app_guideaufzurufen; das liefert jeden Hook, jede Komponente und jede Prop, die eine App verwenden darf, samt einem durchgespielten Beispiel.show_app_guidewird überall angeboten, woshow_appangeboten wird.
Jeder Lese- und Speichervorgang in der Ansicht ist ein Aufruf der Lese- und Schreib-Tools, ausgeführt als die Person unter ihrer RLS. Ein Formular bietet daher nur das, was für deren Verbindung autorisiert wurde: Ohne
data:writeist es schreibgeschützt, und ein Feld, das ihre Rollen nicht lesen dürfen, ist darin nicht enthalten. Das ist auch die Grenze, innerhalb derer der Code einer App operiert: Er läuft in der Ansicht, sodass jeder Aufruf, den er tätigt, eines dieser Tools als die Person ausführt – er kann nichts tun, was das Modell nicht auch mit denselben Tools tun könnte. Auf dem gehosteten Connector wird jeder Schreibvorgang zudem vom Server geplant und bestätigt. Innerhalb dieses Rahmens fragtuseRowWritesdie Person vor dem Schreiben um Erlaubnis, sodass eine App nicht ohne deren Klick schreibt; die eigenen Steuerelemente des Admins (das Speichern eines Formulars, ein Löschvorgang, eine Tabellenbearbeitung) verhalten sich so, wie sie es auf einemshow_collection-Bildschirm tun. Dem Modell wird mitgeteilt, was geändert wurde. Es liest die Zeilen, die jedes Tool zurückgibt, nicht die Collection-Konfigurationen, mit denen die Ansicht gerendert wird. Ein Client ohne MCP Apps (wie Claude Code oder Cursor) zeigt nichts an, und das Modell liest dieselben Zeilen, die es überquery_collectionerhalten würde. -
-
Experimentell: im Projekt gespeicherte Apps.
save_appbewahrt eine App, die das Modell mitshow_appgebaut hat, damit sie sich erneut öffnen lässt: Es kompiliert den Code wieshow_appund speichert ihn mittitle,collectionsundvisibility, alsopersonal(ihr Eigentümer, der Standard),roles(wer eine ihrerroleshat) oderteam(alle, die sich anmelden). Für mehr als sich selbst zu speichern erfordert die Admin-Rolle, denn eine geteilte App ist Code, den eine KI geschrieben hat und der für andere Menschen läuft. Nur ihr Eigentümer oder ein Admin ersetzt (id) oder löscht eine App, und eine Person behält höchstens 200.list_appslistet die Apps, die der Aufrufer öffnen darf,open_appöffnet eine, wie esshow_apptäte, unddelete_appentfernt eine. Eine App zu sehen heißt nicht, ihre Daten zu erreichen: Eine geöffnete App liest und schreibt über die obigen Tools, als die Person, die sie öffnet, unter deren RLS. Die Apps liegen inrebase.saved_apps, das das Backend beim ersten Gebrauch durch ein Tool anlegt und keinem Endnutzer gewährt. Das Admin-Panel öffnet dieselben Apps: Fügen SiesavedAppsViewaus@rebasepro/cmszu Ihrenviewshinzu. Es führt eine App in einem iframe aus, das ohneallow-same-originund ohne eigenes Netzwerk sandboxed ist, und leitet ihre Tool-Aufrufe anPOST /api/admin/apps/mcpweiter, dieselben Tools für die Sitzung des Admin-Panels, das mit den Admin-Routen eingebunden wird, obREBASE_MCP_ENABLEDgesetzt ist oder nicht. Namen und Formen der Tools können sich noch ändern. -
Vor 0.24 erteilte Berechtigungen behalten ihren Umfang.
mcp:readwird alsdata:readinterpretiert, undmcp:writealsdata:write data:delete– sowohl bei gespeicherten Berechtigungen als auch bei bereits ausgestellten Tokens. -
Ein API-Key funktioniert ebenfalls.
/mcpakzeptiert auchAuthorization: Bearer rk_…für einen Client, der über einen Header statt über einen OAuth-Flow konfiguriert ist. Der Key erreicht die Tools, die durch seinedata:*-Scopes abgedeckt sind, in der jeweiligen Rolle: ein persönlicher Key als sein Eigentümer, ein Service-Key alsapi-key:<id>. -
Das Vokabular des SDKs, die Antworten von REST. Die Tools akzeptieren dieselben Parameter wie das SDK –
where({"status": ["==", "paid"]}),orderBy(["created_at", "desc"]oder"created_at:desc"),limit,offset,searchStringsowiedatafür Schreibvorgänge – und lesen über den PfadGET /api/data/<collection>, sodass eine Zeile so zurückgegeben wird, wie REST sie liefert (ISO-Datumsangaben, einbelongsToals Fremdschlüssel, z. B.authorId), und in einem Update unverändert zurückgesendet werden kann.query_collectionantwortet mit{ data, meta }inklusivemeta.totalundmeta.hasMore, undcount_documentsmit{ count };tools/listgibt beiden,aggregate_documentsundget_documenteinoutputSchema, locker, wo eine Antwort variiert.aggregate_documentsentsprichtGET /api/data/<collection>/aggregate:selectist eine Liste in der REST-Grammatik (["count()", "sum(total)"]),groupByeine Liste von Feldern, und die Antwort ist{ data }mit einer Zeile pro Gruppe, plusmeta.hasMorebei einem gruppierten Aufruf, dessen Gruppen mitlimitundoffsetpaginiert und mitorderBysortiert werden. Bei einer Collection, die durch einenafterRead-Callback umgeschrieben wird, liefert es nurcount(), genau wie REST. Wie bei REST werden einlimitüber 1000, ein nicht deklariertes Argument sowie das Bearbeiten oder Löschen einer im Papierkorb befindlichen Zeile (404) abgelehnt; das Setzen des Soft-Delete-Feldes aufnullstellt sie wieder her.deleted: "only"(oder"include") beiquery_collection,count_documentsundaggregate_documentsliest den Papierkorb aus, wie es auch RESTs?deleted=tut, sodass eine durchdelete_documentin den Papierkorb verschobene Zeile zum Wiederherstellen wiedergefunden werden kann. Die Beschreibung weist das Modell darauf hin, dass der Löschvorgang nur dann dauerhaft ist, wenn die Collection kein Soft-Delete-Feld hat. -
Die Auflistung nennt die Collections;
describe_collectionliefert das Schema einer Collection.list_collectionsgibt für jede Collectionname,titleunddescriptionzurück, unddescribe_collection { collection }liefert die OpenAPI-Schemasrowundcreatedieser Collection sowiesoftDeleteField, falls Zeilen in einen Papierkorb verschoben werden. Die Tool-Beschreibungen weisen das Modell an, eine Collection vor dem Schreiben zu beschreiben. Die Auflistung eines Projekts mit 200 Collections umfasst etwa 5k Tokens, und jede Beschreibung unter 1k; wären alle Schemas in der Auflistung enthalten, wären es etwa 150k. -
Ein Token ausschließlich für diesen Endpunkt. Ein MCP-Access-Token wird von
/api/data,/api/adminund dem WebSocket abgelehnt, sodass das Verbinden eines Assistenten diesem keine reguläre Sitzung übergibt.
Jede Anfrage an /mcp liest das Konto der Person erneut ein. Ein gelöschtes oder deaktiviertes
Konto oder ein „Überall abmelden“ bzw. eine Passwortänderung nach Ausstellung des
Tokens stoppt einen verbundenen Client sofort mit einem 401. Eine Herabstufung von Berechtigungen greift ab dem
nächsten Tool-Aufruf. Jeder Refresh führt dieselben Prüfungen durch und verweigert eine solche Autorisierung
dauerhaft. Eine Gastsitzung kann überhaupt keine Zustimmung erteilen.
Eine Einschränkung: Das Trennen eines Clients (DELETE /api/oauth/grants/:clientId mit der
eigenen Sitzung der Person) widerruft dessen Refresh-Tokens sofort, ein bereits ausgestelltes
Access-Token bleibt jedoch bis zu seinem Ablauf (innerhalb einer Stunde) gültig.
Die Routen finden Sie unter Endpunkte und die Variablen unter Konfiguration.