Подключить Strapi к ИИ-агенту в «СуперИнтеллекте» — значит выдать агенту два реквизита: адрес вашей установки Strapi без /api и API-токен из админки. После этого агент читает ваши коллекции и медиатеку, а если вы отдельно включите права на изменение — создаёт и обновляет записи, загружает картинки и ставит обложки. Полный цикл — текст, обложка из МедиаЛаб, черновик в нужной коллекции — собирается прямо в чате, без ручного копирования и загрузки файлов. Ниже — пять шагов настройки, разбор прав токена и честный список того, что по умолчанию выключено.
Что умеет коннектор Strapi: 12 инструментов в трёх модулях
Коннектор «Strapi CMS» рассчитан на Strapi 5 — популярную систему управления контентом, на которой работают сайты и приложения. Он одинаково работает с облачной установкой и с вашей собственной. Агент получает 12 инструментов, разложенных по трём модулям: «Контент», «Медиатека», «Публикация и удаление». По умолчанию агент работает только на чтение: права на изменение включаются отдельно, а модуль публикации и удаления выключен.
| Модуль | Инструментов | Что делает агент |
|---|---|---|
| «Контент» | 5 | Смотрит список коллекций, с которыми настроен коннектор; выводит записи с фильтрами, сортировкой, постраничностью, выбором «черновик/опубликовано» и языком; открывает запись целиком — с медиа и связями; создаёт запись (по умолчанию черновик, если в проекте включён режим черновиков); частично обновляет запись |
| «Медиатека» | 5 | Загружает картинку по ссылке — в том числе изображение, только что сгенерированное в МедиаЛаб; загружает картинку из данных; ищет файлы медиатеки по имени; получает файл; привязывает загруженный файл к полю записи — например, ставит обложку статьи |
| «Публикация и удаление» | 2 | Публикует черновик; удаляет запись. Модуль выключен по умолчанию, удаление необратимо и требует вашего подтверждения |
Шаг 1. Создайте API-токен в админке Strapi
- Откройте админку Strapi и перейдите в раздел Settings → API Tokens.
- Нажмите Create new API Token.
- Задайте понятное имя — например, «Агент СуперИнтеллект». Потом будет ясно, чей это доступ и какой токен отзывать.
- Срок действия поставьте Unlimited — иначе интеграция однажды перестанет работать в самый неудобный момент.
- Выберите тип: Full access — самый быстрый путь, или Custom — если хотите ограничить доступ вручную.
- Сохраните токен и сразу скопируйте его значение: именно оно пойдёт в поле коннектора. Храните его как пароль.
Если вы выбрали Custom, не закрывайте окно, не пройдя по всем нужным правам. Кроме коллекций — чтение, создание, изменение и публикация — там отдельным блоком лежат права плагина Upload. Без них медиатека работать не будет: подробности в разделе про права ниже.
Шаг 2. Скопируйте адрес Strapi — без /api
Коннектор ждёт базовый адрес установки, а не адрес конкретного эндпоинта. Проще всего взять его из адресной строки админки: всё, что идёт до /admin. Лишний хвост /api — типичная причина, по которой первые запросы агента возвращают ошибку.
Адрес установки Strapi
Правильно (базовый адрес установки):
https://cms.example.ru
https://example.ru/cms
Неправильно (лишний путь):
https://cms.example.ru/api
https://cms.example.ru/admin
https://cms.example.ru/api/blog-postsШаг 3. Заполните поля коннектора в каталоге интеграций
Откройте страницу коннектора в каталоге интеграций и заполните форму подключения. Обязательных полей два — адрес и токен. Остальное настраивается по желанию и отвечает за то, насколько широкие права получает агент.
| Поле | Что вписать | Где взять |
|---|---|---|
| Адрес Strapi | Базовый адрес установки, без /api | Адресная строка админки — всё, что идёт до /admin |
| API-токен | Скопированное значение токена | Strapi → Settings → API Tokens → Create new API Token |
| Коллекции (необязательно) | Список через запятую, например blog-posts, guides | Имена коллекций, с которыми должен работать агент |
| Права на изменение | Включаются отдельно, если агент должен создавать и обновлять записи | Настройки коннектора |
| Модуль «Публикация и удаление» | Выключен по умолчанию — включайте осознанно | Настройки коннектора |
Шаг 4. Перечислите коллекции — по желанию
Поле со списком коллекций можно не заполнять. Это подсказка агенту, с чем именно ему работать: если написать blog-posts, guides, он не будет гадать между десятком типов контента и сразу пойдёт в нужные. На больших проектах со сложной схемой это экономит переспрашивания и уменьшает шанс, что агент создаст запись не там.
Шаг 5. Проверьте связь: попросите агента показать список записей
Проверить связь проще всего живым запросом. Откройте чат с агентом, у которого включён коннектор, и попросите его обычными словами вывести содержимое коллекции. Если агент вернул реальные заголовки из вашей системы — адрес и токен приняты. Если пришёл отказ по доступу, дело почти всегда в правах токена или в лишнем /api в адресе.
Проверочные запросы агенту
Покажи, с какими коллекциями Strapi ты сейчас можешь работать.
Выведи 10 последних записей из blog-posts: заголовок, слаг,
статус (черновик/опубликовано), дату. Сначала новые.
Открой запись blog-posts с id 42 целиком — со всеми полями,
обложкой и связями.
Создай черновик в blog-posts: заголовок «Тест коннектора»,
слаг test-konnektora, короткий анонс на два предложения.Первые три запроса — на чтение, они работают сразу. Последний сработает, только если вы включили агенту права на изменение: по умолчанию он умеет лишь смотреть.
Права токена: почему без Upload не работает медиатека
Strapi выдаёт токену ровно те права, которые вы отметили при создании. Модуль «Медиатека» ходит не в коллекции, а в плагин Upload — это отдельный набор разрешений, и он не включается автоматически вместе с правами на статьи.
- Full access — токен получает полный доступ к API: и к коллекциям, и к плагину Upload. Подходит, если Strapi ваш и вы контролируете, кому выдан токен.
- Custom — доступ собирается вручную. Отметьте чтение, создание и изменение по каждой нужной коллекции, а также публикацию, если планируете её включать.
- Плагин Upload — отдельный блок прав в том же окне Custom. Без него агент не сможет ни загрузить картинку, ни посмотреть список файлов, ни поставить обложку: все пять инструментов медиатеки вернут отказ.
- Срок действия — Unlimited. Токен с ограниченным сроком однажды истечёт, и подключение перестанет работать без явной причины.
Сценарий: статья с обложкой из МедиаЛаб за один диалог
Ради этого коннектор и делался. Агент пишет текст, генерирует обложку в МедиаЛаб «СуперИнтеллекта», сам заливает её в медиатеку Strapi, привязывает к полю обложки и — если модуль включён — публикует запись. Скачивать файл, переименовывать и тащить его через админку не нужно. Промпты для картинок под задачу удобно подсмотреть в гайде про изображения для бизнеса.
- Агент пишет текст статьи по вашему брифу — прямо в чате, с правками по ходу.
- Создаёт запись в нужной коллекции. По умолчанию это черновик, если в проекте включён режим черновиков.
- Генерирует обложку в МедиаЛаб.
- Загружает изображение в медиатеку Strapi по ссылке — той самой, что вернула генерация.
- Привязывает файл к полю обложки записи.
- Публикует черновик — только если модуль «Публикация и удаление» включён вами заранее.
Пример задачи на полный цикл
Задача на статью для блога.
1) Напиши текст: тема — «Как выбрать CRM для сервисного центра»,
структура с подзаголовками, без воды, примерно 7000 знаков.
2) Создай черновик в коллекции blog-posts:
title, slug, excerpt, body, язык — русский.
3) Сгенерируй в МедиаЛаб горизонтальную обложку 16:9:
рабочее место мастерской, спокойные тона, без текста на картинке.
4) Загрузи готовую картинку в медиатеку Strapi и привяжи её
к полю cover этой записи.
5) Верни id записи и ссылку на файл. Публиковать не нужно —
черновик я проверю сам.Безопасность: публикация и удаление выключены по умолчанию
- По умолчанию агент работает на чтение. Права на изменение включаются отдельно и осознанно.
- Модуль «Публикация и удаление» выключен. Пока вы его не включили, агент не может отправить материал на сайт.
- Создание записи даёт черновик, если в проекте включён режим черновиков. Материал не появится у читателей, пока вы его не проверите.
- Удаление необратимо — агент обязан подтвердить действие с вами перед выполнением.
- Второй контур защиты — сам токен. Если агент нужен только для черновиков, не выдавайте ему прав на публикацию на уровне Strapi.
Отдельно про расход: вызовы инструментов Strapi не расходуют нейроны платформы — коннектор ходит в вашу собственную систему по вашему токену.
Частые вопросы
Коннектор работает только с облачным Strapi?
Нет. Он рассчитан на Strapi 5 и одинаково подходит и к облачной установке, и к своей — развёрнутой на вашем сервере. Условие одно: агент должен добираться до адреса вашей установки и иметь действующий API-токен. Если Strapi доступен только изнутри закрытого контура, подключение не заработает — нужен доступ к системе снаружи.
Агент сразу сможет публиковать и удалять записи?
Нет. По умолчанию он работает на чтение, права на изменение включаются отдельно, а модуль «Публикация и удаление» выключен полностью. Даже после включения удаление остаётся необратимым действием, которое агент обязан подтвердить с вами.
Агент не может загрузить картинку в медиатеку — что проверить первым делом?
Права токена. При типе Custom к правам на коллекции нужно отдельно добавить права плагина Upload — без них все пять инструментов модуля «Медиатека» вернут отказ. Вторая по частоте причина — адрес с лишним /api на конце.
Обязательно ли перечислять коллекции при подключении?
Нет, поле необязательное. Это подсказка агенту, с чем работать: например blog-posts, guides. Без неё агент опирается на то, что видит по токену, — на проектах со сложной схемой это чуть медленнее и требует больше уточнений в чате.
Расходуются ли нейроны на работу со Strapi?
Вызовы инструментов Strapi не расходуют нейроны платформы: работает ваш собственный доступ к системе по вашему API-токену.
С чего начать
Настройка занимает несколько минут: токен в Strapi, адрес без /api, проверочный запрос агенту. Создайте аккаунт в «СуперИнтеллекте», откройте каталог интеграций и добавьте Strapi. Что ещё умеет эта связка — в анонсе коннектора. А если рядом с сайтом живёт учёт, посмотрите, как подключить 1С.
