Baserow

Baserow MCP

Verbinde deinen KI-Agenten mit Baserow. Dein Agent kann Tabellen in einem Baserow-Arbeitsbereich lesen und ändern, und zwar nur mit den Werkzeugen, die du bei der Anmeldung erlaubst.

Dieses Repository installiert den MCP-Server von Baserow sowie eine kurze Fähigkeit, die dem Agenten den Umgang damit beibringt. Es funktioniert mit Claude, ChatGPT, Codex, Cursor, VS Code, GitHub Copilot, Gemini CLI, OpenCode, Zed, Goose, Windsurf, Pi und anderen Agenten.

Server-URL

• baserow.io: https://api.baserow.io/mcp
• Selbst gehostet: deine Backend-URL gefolgt von /mcp, zum Beispiel https://baserow.example.com/mcp. Kopiere sie aus Meine Einstellungen → MCP-Server in Baserow.

Die Beispiele unten verwenden die baserow.io-URL. Bei selbst gehostetem Baserow verwende stattdessen deine eigene URL.

Schnellstart

npx add-mcp https://api.baserow.io/mcp -n baserow -g
npx skills add baserow/baserow-mcp

add-mcp findet die von dir installierten Agenten und fragt, zu welchen Baserow hinzugefügt werden soll. Deaktiviere Claude Desktop, falls es aufgeführt ist, und füge Baserow dort stattdessen als benutzerdefinierten Connector hinzu. skills add kopiert die baserow-basics-Fähigkeit in die Fähigkeitenordner deiner Agenten. Bei selbst gehostetem Baserow führe auch skills add aus, da nur die folgenden Plugins die Fähigkeit enthalten.

Anforderungen für Selbsthosting

• Eine Baserow-Version neuer als 2.4.1. Ältere Versionen haben kein /mcp oder keine Anmeldung; verwende dort einen Endpunkt-Schlüssel.
• BASEROW_MCP_OAUTH_ENABLED=true auf dem Backend. Es ist standardmäßig deaktiviert.
• Eine öffentliche HTTPS-Backend-URL, damit gehostete Apps wie Claude.ai und ChatGPT sie erreichen können, sowie ausgehendes HTTPS vom Backend, das die Client-Metadaten der Apps abruft.
• Dein Reverse-Proxy sendet /mcp und Pfade unter /mcp/, /oauth/, /.well-known/oauth-authorization-server und /.well-known/oauth-protected-resource an das Backend. Gleiche /mcp genau ab, nicht als Präfix: Das Frontend liefert die Anmeldeseite unter /mcp-authorize/.

Siehe MCP-OAuth-Anmeldung für selbst gehostetes Baserow.

Installation pro Agent

Agent	baserow.io	Selbst gehostet
Claude Code	Plugin	Gleiches Plugin, gib bei Aufforderung deine URL ein
Claude.ai, Claude Desktop	Benutzerdefinierter Connector	Gleich, mit deiner URL
ChatGPT	Benutzerdefinierter MCP-Server	Gleich, mit deiner URL
Codex	Plugin	codex mcp add baserow --url <your url>
GitHub Copilot CLI	Plugin	Nur Server
Gemini CLI	gemini extensions install https://github.com/baserow/baserow-mcp	gemini mcp add -s user -t http baserow <your url>
Cursor	Zu Cursor hinzufügen	Konfigurationsdatei
VS Code	Zu VS Code hinzufügen	Konfigurationsdatei
Goose	Zu Goose hinzufügen	Schnellstart mit deiner URL
OpenCode, Windsurf, Zed	Konfigurationsdatei	Gleich, mit deiner URL
Jeder andere Agent	Schnellstart	Gleich, mit deiner URL

Die Codex-, Copilot- und Gemini-Plugins sowie die Schaltflächen „Hinzufügen" zeigen immer auf baserow.io. Füge bei selbst gehostetem Baserow für diese Agenten daher nur den Server hinzu.

Claude Code

/plugin marketplace add baserow/baserow-mcp
/plugin install baserow@baserow

Wenn nach der URL gefragt wird, drücke Esc, um baserow.io beizubehalten, oder gib deine selbst gehostete URL ein. Um sie später zu ändern, führe /plugin configure baserow@baserow aus.

Claude.ai und Claude Desktop

Anpassen → Connectors → + Hinzufügen → Benutzerdefinierten Connector hinzufügen. Nenne ihn Baserow und gib deine Server-URL ein. Bei Team- und Enterprise-Plänen fügt ein Besitzer ihn unter Organisationseinstellungen → Connectors hinzu.

ChatGPT

Öffne Plugins, wähle die Plus-Schaltfläche, dann „Benutzerdefinierten MCP-Server hinzufügen", und gib deine Server-URL ein. Menünamen ändern sich häufig. Bei Business- und Enterprise-Plänen muss ein Administrator zuerst benutzerdefinierte MCP-Server erlauben.

Codex

codex plugin marketplace add baserow/baserow-mcp
codex plugin add baserow@baserow
codex mcp login baserow

GitHub Copilot CLI

copilot plugin marketplace add baserow/baserow-mcp
copilot plugin install baserow@baserow

Bei selbst gehostetem Baserow füge nur den Server hinzu: copilot mcp add --transport http baserow <your url>. Wenn das Plugin installiert ist, deinstalliere es zuerst mit copilot plugin uninstall baserow; sein Server ersetzt deinen ohne Warnung.

Konfigurationsdateien

Um nur den Server hinzuzufügen, ohne das Plugin:

• Cursor, ~/.cursor/mcp.json:

  { "mcpServers": { "baserow": { "url": "https://api.baserow.io/mcp" } } }
  

• VS Code, .vscode/mcp.json:

  { "servers": { "baserow": { "type": "http", "url": "https://api.baserow.io/mcp" } } }
  

• OpenCode, opencode.json, dann opencode mcp auth baserow:

  { "mcp": { "baserow": { "type": "remote", "url": "https://api.baserow.io/mcp" } } }
  

• Windsurf, ~/.codeium/windsurf/mcp_config.json:

  { "mcpServers": { "baserow": { "serverUrl": "https://api.baserow.io/mcp" } } }
  

• Zed, Einstellungen:

  { "context_servers": { "baserow": { "url": "https://api.baserow.io/mcp" } } }
  

Anmelden

Dein Agent öffnet eine Baserow-Seite in deinem Browser. Melde dich an, wähle den Arbeitsbereich und aktiviere die Werkzeuge, die der Agent verwenden darf. Lese-Werkzeuge erlauben dem Agenten, Datenbanken, Tabellen und Zeilen zu durchsuchen; Schreib-Werkzeuge erlauben ihm, Zeilen zu erstellen, zu aktualisieren und zu löschen. Bei einer ersten Verbindung sind nur die Lese-Werkzeuge aktiviert.

Wo die Anmeldung beginnt:

• Claude Code: führe /mcp aus, wähle plugin:baserow:baserow und authentifiziere dich.
• Codex: codex mcp login baserow.
• Gemini CLI: /mcp auth baserow.
• Claude.ai, ChatGPT, Cursor und VS Code: die Schaltfläche „Verbinden" oder „Anmelden" neben dem Server.

Um Arbeitsbereich oder Werkzeuge zu ändern, melde dich erneut an: Authentifiziere den Server in deinem Agenten neu oder trenne die App unter Meine Einstellungen → MCP-Server in Baserow und verbinde sie erneut. Eine einfache Wiederverbindung behält die alte Anmeldung bei.

Fehlerbehebung

• Ein Werkzeug fehlt, oder keine Datenbanken werden aufgelistet. Die Verbindung hat nur den Arbeitsbereich und die Werkzeuge, die du bei der Anmeldung ausgewählt hast. Melde dich wie oben beschrieben erneut an. Werkzeuge, die Tabellen oder Felder ändern, sind über MCP nicht verfügbar.
• Die Anmeldung startet nie, oder der Client sagt, der Server unterstützt kein OAuth oder keine Client-Registrierung. Bei selbst gehostetem Baserow prüfe die Anforderungen für Selbsthosting.
• Die Verbindung schlägt mit einer von dir eingegebenen URL fehl. Kopiere die URL genau so, wie sie unter Meine Einstellungen → MCP-Server angezeigt wird. Sie endet mit /mcp, ohne abschließenden Schrägstrich.
• Zwei Baserow-Server in Claude Code. Wenn claude mcp list den plugin:baserow:baserow des Plugins und einen baserow-Server zeigt, den du manuell hinzugefügt hast, behalte den, der sich verbindet. claude plugin disable baserow@baserow deaktiviert den des Plugins; claude mcp remove baserow entfernt deinen.

Endpunkt-Schlüssel

Baserow 2.4.1 und älter akzeptiert nur einen Endpunkt-Schlüssel, und das Plugin richtet diesen nicht ein. Kopiere die Endpunkt-URL aus Meine Einstellungen → MCP-Server. Sie endet mit /sse und enthält deinen Schlüssel. Füge sie manuell zu einem Agenten hinzu, der SSE-Server unterstützt, wie Claude Code, Cursor oder VS Code; Codex und Goose tun das nicht:

npx add-mcp "<endpoint url>" -t sse -n baserow -g -a claude-code

Neuere Versionen akzeptieren den Schlüssel auch als Header auf /mcp, was für Skripte nützlich ist:

npx add-mcp https://baserow.example.com/mcp -n baserow -g -a claude-code -h "Authorization: Bearer <key>"

Der Schlüssel gewährt vollen Zugriff auf seinen Arbeitsbereich. -g schreibt ihn in deine Benutzerkonfiguration statt in den aktuellen Ordner, damit er nicht in einen Commit geraten kann.

Datenschutz und Support

• Datenschutzrichtlinie: https://baserow.io/privacy-policy
• Bedingungen: https://baserow.io/terms-and-conditions
• Hilfe: Community-Forum oder kontaktiere uns

Entwicklung

Führe in scripts/ npm install aus, dann npm test und npm run check. CI führt dieselben Prüfungen aus. Die Werkzeuge befinden sich dort, damit Plugin-Installationen nicht deren Abhängigkeiten installieren.

Das Claude-Code-Plugin deklariert seinen Server in .claude-plugin/plugin.json, damit es die von dir eingegebene URL verwenden kann. .mcp.json enthält die baserow.io-URL für andere Werkzeuge, die Claude-Format-Plugins lesen, wie GitHub Copilot CLI und Cursor.

Lizenz

MIT