Conectar NocoDB MCP con Claude: 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 + Claude

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

Requisitos previos

Consulta las instrucciones completas de configuración incluidas en el conector (visibles en la tienda de la aplicación cuando seleccionas 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: 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 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: 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 da 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 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 Claude

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.

Método recomendado: funciona en claude.ai web sin editar ningún archivo de configuración.

1. En Claude, abre Customize → Connectors.
2. Haz clic en + y después en Add custom connector.
3. Introduce un nombre, p. ej. NocoDB, y la URL del servidor MCP remoto https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID, y luego haz clic en Add.
4. Haz clic en Connect e inicia sesión en AnythingMCP (OAuth) para conceder el acceso.

Todas las herramientas de abajo aparecen en tu chat: empieza a escribir tus peticiones.

Herramientas disponibles

Preguntas frecuentes

¿Funciona con Claude Code además de con Claude Desktop? Sí: apunta ambos a https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID.

Siguientes pasos

• Página del conector
• Conectar con ChatGPT