NocoDB MCP-Server: Tabellen, Datensätze und Bases

💡 Keine Installation? Nutze direkt cloud.anythingmcp.com. Melde dich an, klicke auf Connectors → NocoDB, füge deine Zugangsdaten ein und erstelle einen MCP-API-Key — fertig. Kein Docker, kein git clone, kein lokaler Server.

NocoDB

Lies NocoDB-Workspaces, Bases, Tabellen und Datensätze aus NocoDB Cloud oder einer self-hosted Instanz. 7 schreibgeschützte Tools mit xc-token-API-Key-Authentifizierung gegen die v3-REST-API.

Einrichtung

Die Einrichtung dauert etwa 2 Minuten. Du brauchst deine NocoDB-Adresse und ein API-Token.

1. Öffne in NocoDB Team & Settings → API Tokens und erstelle ein Token. Verwende nach Möglichkeit ein Token mit reinem Lesezugriff. Kopiere es in NOCODB_API_TOKEN.
2. Setze NOCODB_URL auf den Root-NocoDB-Host, ohne abschließenden Schrägstrich: https://app.nocodb.com bei NocoDB Cloud oder dein eigener Host, zum Beispiel https://nocodb.example.com.
3. Installiere den Connector und führe nocodb_list_workspaces aus: Das Tool listet die Workspaces auf, die dein Token sehen kann.

Token-Umfang: NocoDB-API-Tokens gelten für die gesamte NocoDB-Instanz und werden im Header xc-token gesendet. Um einzuschränken, was die KI sehen kann, erstelle das Token mit einem Benutzerkonto, das nur die nötigen Berechtigungen hat.

Wo NocoDB läuft: AnythingMCP Cloud erreicht nur öffentlich erreichbare NocoDB-Instanzen. Ist dein NocoDB-Host privat oder wird er in privaten Adressraum aufgelöst, betreibe AnythingMCP self-hosted im selben Netzwerk und erlaube den Host über SSRF_ALLOWED_HOSTS, sonst blockiert der Outbound-Schutz die Anfrage.

Was gelesen wird: über die NocoDB-v3-API deine Workspaces, Bases und Tabellen, die Spalten einer Tabelle mit Namen und Typen, Datensätze, ein einzelner Datensatz anhand seiner numerischen Zeilen-ID sowie Datensatzanzahlen. Die IDs folgen einer Kette: nocodb_list_workspaces liefert Workspace-IDs (beginnend mit w), nocodb_list_bases Base-IDs (beginnend mit p) und nocodb_list_tables Tabellen-IDs. Vor dem Filtern oder Sortieren ruft die KI nocodb_get_table auf, um die exakten Feldnamen zu erhalten. Filter verwenden die NocoDB-Syntax, zum Beispiel (Status,eq,Open)~and(Priority,eq,High), und die Sortierung erfolgt als JSON, zum Beispiel [{"field":"CreatedAt","direction":"desc"}].

Community Edition: Eine nicht lizenzierte self-hosted NocoDB-Instanz hat möglicherweise nur einen impliziten Workspace, sodass nocodb_list_workspaces einen Eintrag oder eine leere Liste zurückgeben kann. Gehe dann direkt zu nocodb_list_bases mit der bekannten Workspace-ID oder zu den Tabellen, wenn du die Base-ID bereits kennst.

Limits: pageSize wird bei NocoDB Cloud stillschweigend auf 100 und bei self-hosted Instanzen auf 1000 begrenzt; nocodb_count_records liefert die Gesamtzahl, bevor du eine große Tabelle seitenweise durchgehst. NocoDB erlaubt etwa 5 Anfragen pro Sekunde und Benutzer, geteilt von allen Tokens dieses Benutzers. Darüber hinaus gibt es HTTP 429 mit einem Retry-After-Header zurück.

Der Connector ist schreibgeschützt: Er erstellt, aktualisiert oder löscht keine Datensätze, Tabellen, Bases oder Workspaces und nutzt weder Views (planabhängig), Anhänge, Webhooks noch die veralteten v1- und v2-APIs.

Voraussetzungen: NOCODB_URL, NOCODB_API_TOKEN

Den Connector lokal installieren

curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d

Öffne http://localhost:3000/connectors/store, wähle NocoDB und füge die unter Voraussetzungen aufgeführten Umgebungsvariablen ein.

Verfügbare Tools

Nächste Schritte

• Mit Claude verbinden
• Mit ChatGPT verbinden