Подключить NocoDB MCP к Claude

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

NocoDB + Claude

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

Предварительные требования

Полную инструкцию по настройке можно найти прямо в коннекторе (она отображается в магазине внутри приложения при выборе коннектора). Для этого коннектора нужны следующие переменные окружения:

NOCODB_URL, NOCODB_API_TOKEN

Шаг 1 — Получи учётные данные

Настройка занимает около 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. Чтобы ограничить то, что видит AI, создай токен от имени пользователя, у которого есть только необходимые права.

Где работает 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 таблиц. Перед фильтрацией или сортировкой AI вызывает 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.

Шаг 2 — Установи адаптер

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

Шаг 3 — Добавь коннектор в Claude

URL твоего сервера: в AnythingMCP открой MCP Servers → сервер, к которому относится этот коннектор, и скопируй его URL (https://cloud.anythingmcp.com/mcp/…). Используй его везде, где в этом руководстве указано YOUR_SERVER_ID.

Рекомендуемый способ — работает в веб-версии claude.ai без редактирования конфигурационных файлов.

1. В Claude открой Customize → Connectors.
2. Нажми +, затем Add custom connector.
3. Введи имя, например NocoDB, и URL удалённого MCP-сервера https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID, затем нажми Add.
4. Нажми Connect и войди в AnythingMCP (OAuth), чтобы разрешить доступ.

Все перечисленные ниже инструменты появятся в твоём чате — можно писать запросы.

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

FAQ

Работает ли это с Claude Code, а также с Claude Desktop? Да — укажи в обоих https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID.

Дальнейшие шаги

• Страница коннектора
• Подключение к ChatGPT