NocoDB MCP Server: tabelle e record

💡 Nessuna installazione? Usa direttamente cloud.anythingmcp.com. Accedi, clicca su Connectors → NocoDB, incolla le tue credenziali, genera una chiave API MCP e il gioco è fatto. Niente Docker, niente git clone, nessun server locale.

NocoDB

Leggi workspace, base, tabelle e record di NocoDB da NocoDB Cloud o da un'istanza self-hosted. 7 strumenti di sola lettura con autenticazione tramite chiave API xc-token sull'API REST v3.

Configurazione

La configurazione richiede circa 2 minuti. Ti servono l'indirizzo del tuo NocoDB e un token API.

1. In NocoDB, apri Team & Settings → API Tokens e crea un token. Se possibile, usa un token con accesso di sola lettura. Copialo in NOCODB_API_TOKEN.
2. Imposta NOCODB_URL sull'host radice di NocoDB, senza slash finale: https://app.nocodb.com su NocoDB Cloud, oppure il tuo host, ad esempio https://nocodb.example.com.
3. Installa il connettore ed esegui nocodb_list_workspaces: elenca i workspace visibili al tuo token.

Ambito del token: i token API di NocoDB si applicano all'intera istanza NocoDB e vengono inviati nell'header xc-token. Per limitare ciò che l'AI può vedere, crea il token da un account utente che abbia solo i permessi necessari.

Dove gira NocoDB: AnythingMCP Cloud raggiunge solo istanze NocoDB pubblicamente raggiungibili. Se il tuo host NocoDB è privato o si risolve in uno spazio di indirizzi privato, esegui AnythingMCP in self-hosting sulla stessa rete e consenti l'host tramite SSRF_ALLOWED_HOSTS, altrimenti la protezione in uscita blocca la richiesta.

Cosa legge: tramite l'API v3 di NocoDB, i tuoi workspace, base e tabelle, le colonne di una tabella con nomi e tipi, i record, un singolo record tramite il suo ID di riga numerico e il conteggio dei record. Gli ID seguono una catena: nocodb_list_workspaces restituisce gli ID dei workspace (che iniziano con w), nocodb_list_bases gli ID delle base (che iniziano con p) e nocodb_list_tables gli ID delle tabelle. Prima di filtrare o ordinare, l'AI chiama nocodb_get_table per ottenere i nomi esatti dei campi. I filtri usano la sintassi di NocoDB, ad esempio (Status,eq,Open)~and(Priority,eq,High), e l'ordinamento è in JSON, ad esempio [{"field":"CreatedAt","direction":"desc"}].

Community Edition: un NocoDB self-hosted senza licenza può avere un unico workspace implicito, quindi nocodb_list_workspaces può restituire una sola voce o un elenco vuoto. In tal caso passa direttamente a nocodb_list_bases con l'ID del workspace noto, oppure alle tabelle se conosci già l'ID della base.

Limiti: pageSize viene limitato silenziosamente a 100 su NocoDB Cloud e a 1000 sulle istanze self-hosted; nocodb_count_records restituisce il totale prima di scorrere le pagine di una tabella grande. NocoDB consente circa 5 richieste al secondo per utente, condivise tra tutti i token di quell'utente. Oltre questo limite restituisce HTTP 429 con un header Retry-After.

Il connettore è di sola lettura: non crea, non aggiorna e non elimina record, tabelle, base o workspace, e non usa le viste (soggette al piano), gli allegati, i webhook né le API v1 e v2 deprecate.

Prerequisiti: NOCODB_URL, NOCODB_API_TOKEN

Installa il connettore in locale

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

Apri http://localhost:3000/connectors/store, scegli NocoDB e incolla le variabili d'ambiente elencate nei Prerequisiti.

Strumenti disponibili

Prossimi passi

• Collega a Claude
• Collega a ChatGPT