NocoDB MCP mit Gemini CLI verbinden

💡 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 + Gemini

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 über die v3-REST-API.

Voraussetzungen

Die vollständige Einrichtungsanleitung ist direkt im Connector enthalten (sichtbar im In-App-Store, wenn du den Connector auswählst). Die erforderlichen Umgebungsvariablen für diesen Connector sind:

NOCODB_URL, NOCODB_API_TOKEN

Schritt 1 — Zugangsdaten besorgen

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 schreibgeschütztem Zugriff. Kopiere es in NOCODB_API_TOKEN.
2. Setze NOCODB_URL auf den Root-Host von NocoDB, ohne abschließenden Schrägstrich: https://app.nocodb.com bei NocoDB Cloud oder deinen eigenen 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 notwendigen Berechtigungen hat.

Wo NocoDB läuft: AnythingMCP Cloud erreicht nur öffentlich erreichbare NocoDB-Instanzen. Wenn dein NocoDB-Host privat ist oder in einen privaten Adressraum auflö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 ist JSON, zum Beispiel [{"field":"CreatedAt","direction":"desc"}].

Community Edition: Eine nicht lizenzierte, self-hosted NocoDB-Instanz hat möglicherweise einen einzigen 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, falls 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, ändert oder löscht weder Datensätze, Tabellen, Bases noch Workspaces und nutzt keine Views (an einen Tarif gebunden), Anhänge, Webhooks oder die veralteten v1- und v2-APIs.

Schritt 2 — Adapter 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

Schritt 3 — Connector in Gemini hinzufügen

Deine Server-URL: Öffne in AnythingMCP MCP Servers → den Server, auf dem dieser Connector liegt, und kopiere seine URL (https://cloud.anythingmcp.com/mcp/…). Setze sie überall ein, wo diese Anleitung YOUR_SERVER_ID zeigt.

Gemini CLI liest MCP-Server aus ~/.gemini/settings.json (unter Windows %USERPROFILE%\.gemini\settings.json). Füge hinzu:

{
  "mcpServers": {
    "anythingmcp": {
      "httpUrl": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
      "headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
    }
  }
}

1. Erstelle in AnythingMCP unter MCP Servers → dein Server → API keys einen MCP-API-Key und setze ihn anstelle von YOUR_MCP_API_KEY ein.
2. Speichere die Datei und starte gemini neu.
3. Führe in der Gemini CLI /mcp aus (oder gemini mcp list im Terminal) — anythingmcp sollte als verbunden erscheinen.
4. Leg los: Gemini CLI kann jetzt die NocoDB-Tools aufrufen.

Verfügbare Tools

FAQ

Wo sucht Gemini CLI nach MCP-Servern? In ~/.gemini/settings.json für deinen Benutzer oder in .gemini/settings.json innerhalb eines Projekts. gemini mcp list zeigt jeden Server und ob er sich verbindet.

Nächste Schritte

• Connector-Landingpage
• Mit Claude verbinden
• Mit ChatGPT verbinden