Conectar NocoDB MCP con ChatGPT: tablas y registros

💡 ¿Sin instalar nada? Usa directamente cloud.anythingmcp.com. 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 + ChatGPT

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.

Requisitos previos

Consulta las instrucciones de configuración completas incluidas en el conector (visibles en la tienda dentro de la aplicación al seleccionar el conector). Las variables de entorno necesarias para este conector son:

NOCODB_URL, NOCODB_API_TOKEN

Paso 1 — Obtén las credenciales

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: muestra 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 únicamente 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 bloqueará 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 concreto por su ID de fila numérico y recuentos de registros. Los ID siguen una cadena: nocodb_list_workspaces devuelve los ID de espacio de trabajo (que empiezan por w), nocodb_list_bases los ID de base (que empiezan por p) y nocodb_list_tables los ID 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: un NocoDB autoalojado 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 al plan), archivos adjuntos, webhooks ni las API v1 y v2 obsoletas.

Paso 2 — Instala el adaptador

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

Paso 3 — Añade el conector en ChatGPT

La URL de tu servidor: en AnythingMCP, abre MCP Servers → el servidor en el que está este conector, y copia su URL (https://cloud.anythingmcp.com/mcp/…). Úsala donde esta guía muestre YOUR_SERVER_ID.

ChatGPT añade los servidores MCP como plugins en su página Plugins, en la web y en los planes de pago. Ya no se necesita el modo desarrollador. En un espacio de trabajo Business solo pueden añadirlos los administradores y propietarios; en Enterprise y Edu, un administrador puede conceder el permiso Create plugins with MCPs.

1. Ve a chatgpt.com/plugins, haz clic en Add y luego en Add custom MCP server.
2. Introduce un nombre, p. ej. Name: NocoDB.
3. En Connection, introduce la Server URL https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID y deja Authentication en OAuth.
4. Selecciona I understand and want to continue y después Create as a plugin. Cuando ChatGPT te lo pida, inicia sesión en AnythingMCP y permite el acceso.
5. Instala el nuevo plugin desde tus plugins personales, luego escribe @ en un chat y selecciónalo.

Herramientas disponibles

Preguntas frecuentes

¿Funciona el plan gratuito de ChatGPT con servidores MCP personalizados? OpenAI documenta los servidores MCP personalizados solo para planes de pago; el plan Free no figura en su lista.

Próximos pasos

• Página del conector
• Conectar con Claude