NocoDB MCP-сервер: таблицы, записи и базы

💡 Не хочешь ничего устанавливать? Используй cloud.anythingmcp.com напрямую. Войди в аккаунт, нажми Connectors → NocoDB, вставь свои учётные данные, создай API-ключ MCP — готово. Без Docker, без git clone, без локального сервера.

NocoDB

Читай рабочие пространства, базы, таблицы и записи NocoDB в NocoDB Cloud или на собственном сервере. 7 инструментов только для чтения с аутентификацией по API-ключу xc-token через REST API v3.

Настройка

Настройка занимает около 2 минут. Тебе понадобятся адрес твоего NocoDB и API-токен.

1. В NocoDB открой Team & Settings → API Tokens и создай токен. По возможности используй токен с доступом только на чтение. Скопируй его в NOCODB_API_TOKEN.
2. Укажи в NOCODB_URL корневой хост NocoDB без завершающего слэша: https://app.nocodb.com для NocoDB Cloud или твой собственный хост, например https://nocodb.example.com.
3. Установи коннектор и выполни nocodb_list_workspaces: он вернёт список рабочих пространств, доступных твоему токену.

Область действия токена: API-токены NocoDB действуют на весь экземпляр NocoDB и передаются в заголовке xc-token. Чтобы ограничить то, что видит ИИ, создай токен из учётной записи пользователя, у которого есть только необходимые права.

Где работает NocoDB: AnythingMCP Cloud обращается только к общедоступным экземплярам NocoDB. Если твой хост NocoDB приватный или разрешается в приватное адресное пространство, разверни AnythingMCP на собственном сервере в той же сети и разреши хост через SSRF_ALLOWED_HOSTS, иначе защита исходящих запросов заблокирует обращение.

Что он читает: через API v3 NocoDB — твои рабочие пространства, базы и таблицы, столбцы таблицы с именами и типами, записи, одну запись по числовому ID строки и количество записей. ID образуют цепочку: nocodb_list_workspaces возвращает ID рабочих пространств (начинаются с w), nocodb_list_bases — ID баз (начинаются с p), а nocodb_list_tables — ID таблиц. Перед фильтрацией или сортировкой ИИ вызывает nocodb_get_table, чтобы получить точные имена полей. Фильтры используют синтаксис NocoDB, например (Status,eq,Open)~and(Priority,eq,High), а сортировка задаётся в JSON, например [{"field":"CreatedAt","direction":"desc"}].

Community Edition: в самостоятельно развёрнутом NocoDB без лицензии может быть единственное неявное рабочее пространство, поэтому nocodb_list_workspaces может вернуть одну запись или пустой список. В этом случае сразу переходи к nocodb_list_bases с известным ID рабочего пространства или к таблицам, если ты уже знаешь ID базы.

Ограничения: pageSize молча ограничивается значением 100 в NocoDB Cloud и 1000 на самостоятельно развёрнутых экземплярах; nocodb_count_records возвращает общее количество перед постраничным обходом большой таблицы. NocoDB допускает около 5 запросов в секунду на пользователя, и этот лимит общий для всех токенов пользователя. При превышении возвращается HTTP 429 с заголовком Retry-After.

Коннектор работает только на чтение: он не создаёт, не изменяет и не удаляет записи, таблицы, базы или рабочие пространства, а также не использует представления (доступны по тарифу), вложения, вебхуки и устаревшие API v1 и v2.

Требования: NOCODB_URL, NOCODB_API_TOKEN

Локальная установка коннектора

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

Открой http://localhost:3000/connectors/store, выбери NocoDB и вставь переменные окружения, перечисленные в разделе «Требования».

Доступные инструменты

Следующие шаги

• Подключение к Claude
• Подключение к ChatGPT