Conectar NocoDB MCP con Gemini CLI

💡 ¿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 + Gemini

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 Gemini

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

Gemini CLI lee los servidores MCP de ~/.gemini/settings.json (en Windows, %USERPROFILE%\.gemini\settings.json). Añade:

{
  "mcpServers": {
    "anythingmcp": {
      "httpUrl": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
      "headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
    }
  }
}

1. Crea una clave de API MCP en AnythingMCP en MCP Servers → tu servidor → API keys y pégala en lugar de YOUR_MCP_API_KEY.
2. Guarda el archivo y reinicia gemini.
3. Ejecuta /mcp dentro de Gemini CLI (o gemini mcp list en tu terminal): anythingmcp debería aparecer como conectado.
4. Empieza a escribir prompts: Gemini CLI ya puede llamar a las herramientas de NocoDB.

Herramientas disponibles

Preguntas frecuentes

¿Dónde busca Gemini CLI los servidores MCP? En ~/.gemini/settings.json para tu usuario, o en .gemini/settings.json dentro de un proyecto. gemini mcp list muestra cada servidor y si se conecta.

Siguientes pasos

• Página del conector
• Conectar con Claude
• Conectar con ChatGPT