NocoDB — это open-source-платформа, которая превращает базу данных в удобные таблицы, как в Airtable: облачный инстанс app.nocodb.com или собственный сервер (self-hosted), базы, таблицы, записи и связи между ними. Подключив NocoDB к ИИ-агенту СуперИнтеллекта, вы даёте ассистенту доступ к своим таблицам прямо в чате: он находит и считает записи, создаёт и обновляет строки, работает со связями «многие-ко-многим» — обычными фразами, без ручного экспорта и SQL. В этом гайде разберём, где взять API-токен (xc-token), как подключить коннектор в разделе «Интеграции» и как безопасно настроить права.
Что такое интеграция NocoDB с ИИ-агентом
Интеграция (коннектор) — это мост между вашим инстансом NocoDB и ИИ-агентом. Вы один раз приносите свой API-токен, он сохраняется на стороне платформы, а коннектор привязывается к конкретному ассистенту. После этого агент обращается к NocoDB через API v2: читает схему таблиц, выбирает записи с фильтрами, создаёт и меняет данные. Ключевой момент — токен ваш, доступ агент получает ровно к тем базам, которые видит этот токен, и ровно с теми правами, которые вы включите.
Коннектор работает и с облаком app.nocodb.com, и с self-hosted-инстансом — достаточно указать URL вашего сервера. Это удобно, если NocoDB развёрнут внутри компании.
Что умеет ИИ-агент с NocoDB
Коннектор NocoDB даёт агенту 12 инструментов: от разведки структуры баз до полного CRUD (создание, чтение, изменение, удаление) и работы со связями между таблицами.
- Ориентируется в данных: получает список баз и таблиц, читает схему конкретной таблицы (какие поля, типы, связи).
- Читает записи: выборка с where-фильтром, сортировкой и пагинацией, чтение одной записи по id, подсчёт количества строк.
- Меняет данные: создаёт, обновляет и удаляет записи по принесённому токену.
- Работает со связями «многие-ко-многим»: читает связанные записи, связывает и отвязывает их.
Полная таблица инструментов коннектора
| Инструмент | Что делает | Уровень прав |
|---|---|---|
| nocodb_list_bases | Список доступных баз | Чтение |
| nocodb_list_tables | Список таблиц в базе | Чтение |
| nocodb_get_table_schema | Схема таблицы: поля, типы, связи | Чтение |
| nocodb_list_records | Записи с where-фильтром, сортировкой и пагинацией | Чтение |
| nocodb_get_record | Одна запись по id | Чтение |
| nocodb_count_records | Подсчёт количества записей | Чтение |
| nocodb_create_records | Создание новых записей | Запись |
| nocodb_update_records | Обновление существующих записей | Запись |
| nocodb_delete_records | Удаление записей | Удаление |
| nocodb_list_linked_records | Чтение связанных записей (связь «многие-ко-многим») | Чтение |
| nocodb_link_records | Связать записи | Запись |
| nocodb_unlink_records | Отвязать записи | Запись |
Где взять API-токен (xc-token) в NocoDB
Для подключения нужны две вещи: URL вашего инстанса NocoDB и персональный API-токен (xc-token). URL — это адрес, по которому вы открываете NocoDB: облачный app.nocodb.com или адрес self-hosted-сервера. Токен создаётся в настройках аккаунта.
- Войдите в свой инстанс NocoDB (app.nocodb.com или self-hosted).
- Откройте настройки аккаунта и раздел «Tokens» (Настройки аккаунта → Tokens).
- Нажмите создание нового API-токена, при желании задайте ему понятное имя.
- Скопируйте значение токена (xc-token) сразу — оно показывается один раз.
- Запомните URL инстанса — он понадобится вместе с токеном.
Как подключить NocoDB к ИИ-агенту: пошагово
Когда URL и токен готовы, подключение занимает пару минут. Всё делается в разделе «Интеграции» в настройках нужного ассистента.
- Откройте настройки ИИ-ассистента и перейдите в раздел «Интеграции» — это каталог доступных коннекторов.
- Найдите в каталоге NocoDB и выберите его.
- Укажите URL вашего инстанса (облако или self-hosted) и вставьте API-токен (xc-token).
- Настройте права: по умолчанию включено только чтение. Включайте запись и удаление, только если агенту действительно нужно менять данные.
- При желании задайте базу по умолчанию — конкретную базу можно указывать и в каждом запросе отдельно.
- Сохраните коннектор и привяжите его к нужному агенту.
- В чате с ассистентом включите режим «ИИ-агент» — без него инструменты коннектора не вызываются.
Примеры промптов для агента
После подключения обращайтесь к данным обычными фразами — агент сам выберет нужный инструмент и таблицу. Несколько примеров:
- «Покажи, какие базы и таблицы мне доступны в NocoDB» — разведка структуры.
- «Сколько записей в таблице Заказы со статусом "Оплачен" за июль?» — фильтр и подсчёт.
- «Найди клиента по email и покажи все его заказы» — выборка со связями.
- «Создай запись в таблице Задачи: название, ответственный, дедлайн завтра» — создание (нужно право «Запись»).
- «Обнови статус заявки №128 на "В работе"» — обновление записи.
- «Свяжи заказ №540 с клиентом ООО "Ромашка"» — работа со связью «многие-ко-многим».
Безопасность и права доступа
Главный принцип — минимум необходимых прав. Агент действует от имени вашего токена, поэтому объём доступа определяете вы.
- Начинайте с чтения. Оставьте только уровень «Чтение», пока не убедитесь, что агенту нужно менять данные.
- Включайте удаление осознанно. Право «Удаление» (nocodb_delete_records) давайте лишь тем агентам, которым это действительно требуется.
- Ограничивайте область токена. Если NocoDB позволяет — привяжите токен к конкретным базам, а не ко всему аккаунту.
- Отдельный токен — отдельный контроль. Именованный токен под интеграцию легко отозвать в NocoDB, не задев остальную работу.
Частые вопросы
Нужен ли облачный аккаунт NocoDB или подойдёт self-hosted?
Подойдёт и то, и другое. Коннектор работает через API v2 и с облаком app.nocodb.com, и с собственным сервером — при подключении вы просто указываете URL своего инстанса вместе с токеном.
Где именно взять xc-token?
В настройках аккаунта NocoDB: Настройки аккаунта → Tokens → создать API-токен. Значение показывается один раз — скопируйте его сразу и вставьте в коннектор вместе с URL инстанса.
Сможет ли агент случайно удалить мои записи?
Нет, пока вы не включите право «Удаление». По умолчанию коннектор работает в режиме чтения. Инструменты записи и удаления активируются владельцем вручную, поэтому без вашего решения агент данные не меняет.
Можно ли работать с несколькими базами?
Да. Агент видит все базы, доступные вашему токену, получает их список и схему таблиц. Можно задать базу по умолчанию, а конкретную базу указывать прямо в запросе.
Умеет ли агент работать со связями между таблицами?
Да. Для связей «многие-ко-многим» есть три инструмента: чтение связанных записей (nocodb_list_linked_records), связать (nocodb_link_records) и отвязать (nocodb_unlink_records). Например, можно связать заказ с клиентом одной фразой в чате.
Как отключить интеграцию?
Есть два способа: удалить или отвязать коннектор в разделе «Интеграции» у ассистента, либо отозвать API-токен в самом NocoDB. Отзыв токена мгновенно закрывает доступ для всех, кто им пользовался.
Что дальше
Подключите NocoDB в разделе «Интеграции» у вашего ассистента и включите режим «ИИ-агент» — после этого можно работать с базами обычными фразами прямо в чате.
- Страница коннектора NocoDB: /partners/nocodb
- Все интеграции СуперИнтеллекта: /guides/vse-integracii-superintellekta
- Что нового в коннекторах баз данных и вики: /changelog/ai-agent-data-connectors
