ИИ-агенты и DynapiCMS

DynapiCMS построен так, что весь сайт — страницы, шаблоны, формы, контент — доступен через GraphQL API. Поэтому сайт можно доверить ИИ-агенту (Claude Code, Cursor, любому кодинг-ассистенту с доступом к терминалу): он подключится ключом, построит сайт и опубликует его, не открывая админку.

Что умеет агент

Всё то же, что и человек в админке:

  • создавать типы контента и наполнять их записями;
  • собирать страницы: маршруты, шаблоны (Liquid), статические файлы (CSS/JS/картинки);
  • настраивать формы и флоу — включая приём платежей, письма, личные кабинеты;
  • управлять библиотекой запросов, медиатекой, поддоменом и своим доменом;
  • проверять результат до публикации (превью) и после (логи прогонов).

Что нужно агенту для работы

Две вещи — их даёт человек:

  1. API-ключ. В админке: Ключи доступа → Создать. Ключ вида dca_…. Для работы с сайтом нужны области site:manage, data:write, media:write (или ключ с правами администратора).
  2. Адрес эндпоинта. Он один для всех: https://dynapi.ru/cms/graphql. Ключ сам определяет, какому проекту принадлежит запрос.

Каждый запрос агент отправляет так:

POST https://dynapi.ru/cms/graphql
Content-Type: application/json
X-API-Key: dca_…

Ключ никогда не передаётся в адресной строке (?api_key=) — только заголовком.

Три инструмента

Инструмент Что это Для чего
Скилл dynapi-site-dev Пакет знаний: правила платформы, рецепты, справочники по API и Liquid Загружается в кодинг-агента, чтобы он строил сайт по правилам платформы, а не наугад
flowctl Командная строка: проверка флоу, публикация, контент, логи прогонов Агент проверяет и выкатывает изменения командами, а не сырым HTTP
GraphQL API Полный API платформы Всё остальное: контент, схема, медиа, домены

Безопасность

  • Ключ — это доступ ко всему сайту. Не публикуйте его в открытых репозиториях и чатах; отзывается в той же админке одним кликом.
  • Превью-хост (https://preview-<поддомен>.dynapi.ru) всегда показывает черновики — посетители основного адреса их не видят, пока не случится публикация.
  • Агент не может выйти за пределы вашего проекта: ключ привязан к нему.

Далее: Скилл dynapi-site-dev