Collegare NocoDB MCP a ChatGPT

💡 Non vuoi installare nulla? Usa direttamente cloud.anythingmcp.com. Accedi, clicca su Connectors → NocoDB, incolla le tue credenziali, genera una chiave API MCP: fatto. Niente Docker, niente git clone, nessun server locale.

NocoDB + ChatGPT

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.

Prerequisiti

Consulta le istruzioni di configurazione complete incluse nel connettore (visibili nello store dell'app quando selezioni il connettore). Le variabili d'ambiente richieste da questo connettore sono:

NOCODB_URL, NOCODB_API_TOKEN

Passo 1 — Ottieni le credenziali

La configurazione richiede circa 2 minuti. Ti servono l'indirizzo di 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 che il tuo token può vedere.

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, ospita 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, le base e le 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 fornisce 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 fornisce il totale prima di scorrere le pagine di una tabella di grandi dimensioni. NocoDB consente circa 5 richieste al secondo per utente, condivise da tutti i token di quell'utente. Oltre tale soglia restituisce HTTP 429 con un header Retry-After.

Il connettore è di sola lettura: non crea, aggiorna né 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.

Passo 2 — Installa l'adapter

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

Passo 3 — Aggiungi il connettore in ChatGPT

L'URL del tuo server: in AnythingMCP, apri MCP Servers → il server su cui si trova questo connettore e copia il suo URL (https://cloud.anythingmcp.com/mcp/…). Usalo ovunque questa guida mostri YOUR_SERVER_ID.

ChatGPT aggiunge i server MCP come plugin nella sua pagina Plugins, sul web e con i piani a pagamento. La modalità sviluppatore non è più necessaria. In un workspace Business solo gli admin e i proprietari possono aggiungerne uno; in Enterprise ed Edu un admin può concedere il permesso Create plugins with MCPs.

1. Vai su chatgpt.com/plugins, clicca su Add, poi su Add custom MCP server.
2. Inserisci un nome, ad es. Name: NocoDB.
3. In Connection, inserisci il Server URL https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID e lascia Authentication su OAuth.
4. Seleziona I understand and want to continue, poi Create as a plugin. Quando ChatGPT lo richiede, accedi ad AnythingMCP e consenti l'accesso.
5. Installa il nuovo plugin dai tuoi plugin personali, poi digita @ in una chat e selezionalo.

Strumenti disponibili

FAQ

Il piano ChatGPT gratuito funziona con i server MCP personalizzati? OpenAI documenta i server MCP personalizzati solo per i piani a pagamento; il piano Free non è nel suo elenco.

Prossimi passi

• Pagina del connettore
• Collega a Claude