Tinybird MCP Server

Der Tinybird MCP Server verbindet KI-Assistenten mit Tinybird, einer Plattform für Echtzeit-Analytik auf großen Datenmengen. Wer Ereignisdaten, Logs oder Produktkennzahlen in Tinybird sammelt, kann dem Assistenten damit Fragen stellen wie „Wie viele Nutzer waren in der letzten Stunde aktiv?“ oder „Welche Endpoints liefern die meisten Fehler?“. Der Assistent ruft dafür veröffentlichte Endpoints auf oder formuliert eine SQL-Abfrage, führt sie aus und erklärt das Ergebnis im Gespräch. Der Server wird von Tinybird selbst betrieben und in der offiziellen Dokumentation als Zugang für sogenannte Analytics-Agenten beschrieben.

Was ist der Tinybird MCP Server?

Der Server implementiert das Model Context Protocol (MCP), einen offenen Standard, über den KI-Anwendungen Werkzeuge und Datenquellen ansprechen. Er läuft gehostet unter https://mcp.tinybird.co und nutzt Streamable HTTP. Eine lokale Installation ist nicht nötig. Clients, die Streamable HTTP nicht selbst beherrschen, können laut Dokumentation über die Brücke mcp-remote angebunden werden. Voraussetzung ist ein Tinybird-Konto mit einem Workspace und ein Token, dessen Berechtigungen zu den gewünschten Werkzeugen passen.

Welche Werkzeuge der Server bereitstellt

Die Dokumentation nennt sechs Werkzeuge. Mit list_endpoints und call_endpoint findet der Assistent veröffentlichte Endpoints samt Parametern und ruft sie auf; das Ergebnis kommt standardmäßig als CSV, alternativ als JSON oder Markdown. list_datasources und list_service_datasources zeigen die Data Sources des Workspaces und die Service-Data-Sources von Tinybird. Mit execute_query führt der Assistent SQL über die Query API aus und kann den Abfrageplan anzeigen lassen, und text_to_sql übersetzt eine Frage in natürlicher Sprache in SQL. Welche dieser Werkzeuge nutzbar sind, hängt vom Token ab: Ein JWT oder ein auf Ressourcen beschränktes Token erlaubt nur ausgewählte Endpoints oder Data Sources, ein Admin-Token öffnet alle Endpoints.

Einrichtung und Token

Für Claude Code genügt ein einzelner Befehl mit HTTP-Transport; in Cursor tragen Sie die Adresse in der MCP-Konfiguration ein. Das Token wird laut Dokumentation als Parameter token an die Adresse angehängt. Liegt der Workspace nicht in der Standardregion, muss zusätzlich der Parameter host mit der regionalen API-Adresse gesetzt werden, weil ein JWT keine Regionsinformation enthält. Für Claude Desktop enthält die Dokumentation keine eigene Anleitung.

Sicherheit und Grenzen

Da das Token Teil der Adresse ist, kann es in Konfigurationsdateien, Verlaufsdaten oder Protokollen auftauchen. Behandeln Sie die vollständige Adresse deshalb wie ein Passwort und committen Sie sie nicht in ein Repository. Die Dokumentation empfiehlt ausdrücklich, ein Admin-Token nur für vertrauenswürdige interne Werkzeuge zu verwenden. Für einen KI-Assistenten ist ein eng gefasstes, auf einzelne Endpoints oder Data Sources beschränktes Token oder JWT die bessere Wahl. Abfrageergebnisse gelangen in den Kontext des Sprachmodells und damit zum Modellanbieter; enthalten Ihre Daten personenbezogene Angaben, sollten Sie das vorher prüfen. Eine automatisch erzeugte SQL-Abfrage sollten Sie lesen, bevor Sie dem Ergebnis vertrauen, denn sie kann Rechenzeit und damit Kosten verursachen.

Kosten

Die Dokumentation nennt keine gesonderte Gebühr für den MCP-Server. Die Nutzung zählt zum jeweiligen Tinybird-Tarif. Laut Preisseite gibt es einen kostenlosen Einstieg ohne Kreditkarte mit begrenzten Ressourcen, darüber die kostenpflichtigen Pläne Developer und SaaS auf geteilter Infrastruktur sowie Enterprise mit dediziertem Cluster. Aktuelle Konditionen stehen auf der offiziellen Preisseite. Zur Lizenz des Servers macht die Dokumentation keine Angaben.

Für wen lohnt sich der Tinybird MCP Server?

Er lohnt sich für Teams, die Tinybird bereits für Produkt- oder Betriebsanalysen einsetzen und Fragen an die Daten ohne Umweg über Dashboard oder SQL-Editor stellen wollen. Besonders nützlich ist er, wenn Endpoints schon veröffentlicht sind: Der Assistent nutzt dann geprüfte, parametrisierte Abfragen statt freier SQL. Wer Tinybird nicht verwendet, hat keinen Vorteil, denn der Server ist ein Zugang zur Plattform und keine eigenständige Analytik.

Ein Tinybird-Konto mit Workspace, ein passend berechtigtes Token und ein MCP-Client mit Streamable-HTTP-Unterstützung (oder mcp-remote).

Der Tinybird MCP Server läuft gehostet bei Tinybird. Dieser Ratgeber führt durch Einrichtung, Token-Wahl und die ersten Abfragen.

Schritt 1: Voraussetzungen

Sie brauchen ein Tinybird-Konto mit Workspace, ein Token und einen MCP-Client, der Streamable HTTP unterstützt. Clients ohne diese Unterstützung können über npx -y mcp-remote angebunden werden.

npx -y mcp-remote

Schritt 2: Token wählen

Legen Sie für den Assistenten ein eng gefasstes Token oder ein JWT an, das nur die benötigten Endpoints oder Data Sources freigibt. Ein Admin-Token ist laut Dokumentation nur für vertrauenswürdige interne Werkzeuge gedacht.

Schritt 3: In Claude Code einrichten

Führen Sie claude mcp add tinybird --scope user --transport http "https://mcp.tinybird.co?token=TINYBIRD_TOKEN" aus und ersetzen Sie den Platzhalter durch Ihr Token. Liegt Ihr Workspace nicht in der Standardregion, hängen Sie &host= mit der regionalen API-Adresse an, zum Beispiel https://api.eu-central-1.aws.tinybird.co.

claude mcp add tinybird --scope user --transport http "https://mcp.tinybird.co?token=TINYBIRD_TOKEN"

Schritt 4: In Cursor einrichten

Tragen Sie in ~/.cursor/mcp.json (global) oder .cursor/mcp.json (Projekt) unter mcpServers einen Eintrag tinybird mit der url https://mcp.tinybird.co?token=TINYBIRD_TOKEN ein. Legen Sie die Datei mit dem Token nicht in ein Repository.

Schritt 5: Erste Abfragen

Lassen Sie den Assistenten zuerst die veröffentlichten Endpoints und die Data Sources auflisten. Fragen Sie dann nach einer Kennzahl, die ein vorhandener Endpoint liefert, und prüfen Sie bei frei erzeugtem SQL die Abfrage, bevor Sie dem Ergebnis vertrauen.

Tinybird-Token (statisch, ressourcenbezogen, JWT oder Admin-Token) als Parameter token in der Adresse.

Endpoints aufrufen, Data Sources auflisten, SQL ausführen und Fragen in SQL übersetzen; der Umfang richtet sich nach den Scopes des Tokens. Ein JWT beschränkt auf ausgewählte Endpoints, ein Admin-Token öffnet alle.

Der Server läuft gehostet bei Tinybird. Abfrageergebnisse gelangen in den Kontext des KI-Clients und damit zum Modellanbieter.

Token als Teil der Adresse (Gefahr in Konfigurationen und Protokollen), zu weit gefasste Admin-Token, personenbezogene Daten im Kontext des Modellanbieters und rechenintensive, frei erzeugte SQL-Abfragen.