Servidor NocoDB MCP: tablas, registros y bases

💡 ¿Sin instalar nada? Usa cloud.anythingmcp.com directamente. Inicia sesión, haz clic en Connectors → NocoDB, pega tus credenciales, genera una clave de API de MCP y listo. Sin Docker, sin git clone, sin servidor local.

NocoDB

Lee espacios de trabajo, bases, tablas y registros de NocoDB desde NocoDB Cloud o una instancia autoalojada. 7 herramientas de solo lectura con autenticación mediante clave de API xc-token sobre la API REST v3.

Configuración

La configuración lleva unos 2 minutos. Necesitas la dirección de tu NocoDB y un token de API.

1. En NocoDB, abre Team & Settings → API Tokens y crea un token. Usa un token con acceso de solo lectura siempre que sea posible. Cópialo en NOCODB_API_TOKEN.
2. Establece NOCODB_URL con el host raíz de NocoDB, sin barra final: https://app.nocodb.com en NocoDB Cloud, o tu propio host, por ejemplo https://nocodb.example.com.
3. Instala el conector y ejecuta nocodb_list_workspaces: lista los espacios de trabajo que tu token puede ver.

Alcance del token: los tokens de API de NocoDB se aplican a toda la instancia de NocoDB y se envían en la cabecera xc-token. Para limitar lo que puede ver la IA, crea el token desde una cuenta de usuario que tenga solo los permisos necesarios.

Dónde se ejecuta NocoDB: AnythingMCP Cloud solo accede a instancias de NocoDB accesibles públicamente. Si tu host de NocoDB es privado o se resuelve a un espacio de direcciones privado, autoaloja AnythingMCP en la misma red y permite el host mediante SSRF_ALLOWED_HOSTS; de lo contrario, la protección de salida bloquea la petición.

Qué lee: a través de la API v3 de NocoDB, tus espacios de trabajo, bases y tablas, las columnas de una tabla con sus nombres y tipos, registros, un registro por su ID de fila numérico y recuentos de registros. Los IDs siguen una cadena: nocodb_list_workspaces devuelve los IDs de espacio de trabajo (que empiezan por w), nocodb_list_bases los IDs de base (que empiezan por p) y nocodb_list_tables los IDs de tabla. Antes de filtrar u ordenar, la IA llama a nocodb_get_table para obtener los nombres exactos de los campos. Los filtros usan la sintaxis de NocoDB, por ejemplo (Status,eq,Open)~and(Priority,eq,High), y la ordenación es JSON, por ejemplo [{"field":"CreatedAt","direction":"desc"}].

Community Edition: una instancia autoalojada de NocoDB sin licencia puede tener un único espacio de trabajo implícito, por lo que nocodb_list_workspaces puede devolver una entrada o una lista vacía. En ese caso, ve directamente a nocodb_list_bases con el ID de espacio de trabajo conocido, o a las tablas si ya conoces el ID de la base.

Límites: pageSize se limita silenciosamente a 100 en NocoDB Cloud y a 1000 en instancias autoalojadas; nocodb_count_records devuelve el total antes de paginar una tabla grande. NocoDB permite unas 5 peticiones por segundo por usuario, compartidas entre todos los tokens de ese usuario. Si se supera, devuelve HTTP 429 con una cabecera Retry-After.

El conector es de solo lectura: no crea, actualiza ni elimina registros, tablas, bases ni espacios de trabajo, y no usa vistas (sujetas a plan), adjuntos, webhooks ni las API v1 y v2, ya obsoletas.

Requisitos previos: NOCODB_URL, NOCODB_API_TOKEN

Instala el conector en local

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

Abre http://localhost:3000/connectors/store, elige NocoDB y pega las variables de entorno indicadas en los requisitos previos.

Herramientas disponibles

Siguientes pasos

• Conectar con Claude
• Conectar con ChatGPT