Przewodnik AI

Poradnik AI website builder: treści i sklep

Co agent AI robi dziś w headless CMS: strony, tłumaczenia i SEO, a do tego zamówienia, zwroty i rabaty - przez asystenta w panelu albo MCP, na Twoim kluczu, z Twoją akceptacją przed każdą nieodwracalną operacją.

Z
Zespół Cmssy
9 min read

Poradnik AI website builder: co agent może prowadzić w headless CMS

Co AI robi dziś w Cmssy: pracę nad treścią i operacje sklepu - zamówienia, zwroty, rabaty - przez asystenta w panelu albo serwer MCP, z Twoją akceptacją przed każdą nieodwracalną operacją.

Co tu znaczy "AI website builder"

"AI website builder" zwykle oznacza jedno narzędzie, które z prompta projektuje, buduje i hostuje stronę. Cmssy tym nie jest. To hostowany headless CMS: treści i sklep żyją w workspace Cmssy, a stronę renderuje Twoja własna aplikacja - Next.js, React, Astro albo Remix - na Twoim hostingu. Cmssy nie hostuje stron.

AI prowadzi workspace. Agent pracuje na treściach i sklepie za Twoją stroną - stronach, tłumaczeniach, SEO, produktach, rabatach, zamówieniach i zwrotach - tymi samymi narzędziami, których używa panel. Nigdy nie dotyka Twojego kodu.

Dwa wejścia: asystent i serwer MCP

  • Asystent w panelu - naciśnij Cmd + K (Ctrl + K na Windows i Linuksie) w workspace. Działa z uprawnieniami zalogowanego użytkownika, więc może to, co Twoja rola, i nic więcej. W edytorze stron może też wygenerować stronę, przetłumaczyć ją albo edytować otwartą stronę na kanwie, gdzie nic się nie zapisuje, dopóki sam nie zapiszesz.
  • Serwer MCP - @cmssy/mcp-server łączy Claude Code, Claude Desktop albo dowolnego innego klienta MCP z workspace'em za pomocą tokena API. Ten sam rdzeń narzędzi, poza panelem.

Oba są w każdym planie, łącznie z Hobby. Cmssy nie dostarcza własnego modelu: przynosisz klucz od Anthropic, OpenAI, Google, Mistral lub Groq, a dostawca rozlicza Cię bezpośrednio.

Samo MCP nie jest już niczym rzadkim - Contentful, Sanity, Storyblok i Payload też mają serwery MCP. Liczy się to, co narzędzia pozwalają agentowi zrobić i co go zatrzymuje.

Praca nad treścią

  • Tworzenie stron oraz dodawanie, edycja, zmiana kolejności i usuwanie bloków - z typów, które rejestruje Twoja strona.
  • Pisanie i przepisywanie tekstów oraz tłumaczenie stron na języki włączone w workspace.
  • Generowanie tytułu i opisu meta strony oraz wyciąganie tonu marki i słów kluczowych z opublikowanych stron.
  • Zarządzanie modelami i rekordami, mediami, formularzami i zgłoszeniami.
  • W asystencie: eksport wszystkiego, co może odczytać, do CSV, JSON lub Markdown.

Operacje sklepu

W planie z koszykiem i checkoutem (od Pro) ten sam agent obsługuje zaplecze:

  • Zamówienia - przeglądanie i odczyt zamówień, tworzenie ręczne, edycja pozycji, zapis płatności pełnej lub częściowej, dołączenie faktury, przesuwanie przez realizację i etapy pipeline'u albo anulowanie.
  • Zwroty - pełne lub częściowe, z referencją do Twojej ewidencji.
  • Rabaty - kody procentowe, kwotowe lub na darmową wysyłkę, z datą startu i końca, minimalną wartością koszyka i limitem użyć; włączanie i wyłączanie.
  • Produkty - zmiany zbiorcze i progi cenowe.
  • Klienci - wyszukanie konta, zablokowanie lub przywrócenie, wysłanie resetu hasła.

Cmssy zapisuje płatności, ale nie przesuwa pieniędzy. Zwrot zapisany przez agenta to zapis w Cmssy - pieniądze i tak oddaje Twój dostawca płatności, przez Twoją integrację.

Potwierdzenie przed operacjami nieodwracalnymi

Odczyty działają od razu. Narzędzia, których skutek najtrudniej cofnąć - m.in. zwroty, anulowanie zamówień, usuwanie i publikowanie stron, zbiorcze zmiany i usuwanie produktów, blokowanie klientów - nie działają przy pierwszym wywołaniu. Zwracają needsConfirmation: true, jednozdaniowe podsumowanie tego, co się stanie, i referencję, a nic się nie zmienia. Po Twojej akceptacji agent powtarza wywołanie z tą referencją.

Referencja działa raz, wygasa i tylko dla dokładnie tych argumentów, dla których ją wydano - zmień kwotę zwrotu, a serwer zapyta ponownie. W asystencie w panelu akceptujesz przyciskiem w czacie, a każdy inny zapis jest najpierw opisany i wykonuje się dopiero po Twojej zgodzie. Przez MCP agent pokazuje Ci podsumowanie, zanim potwierdzi.

Czego nie robi

  • Nie pisze Twojego kodu. Żadne narzędzie nie zapisuje plików, nie edytuje komponentów i nie otwiera pull requestów; schematy bloków zostają w Twoim repozytorium, pod review.
  • Niczego nie hostuje ani nie wdraża. Robi to Twoja aplikacja, na Twoim hostingu.
  • Nie przesuwa pieniędzy. Płatności i zwroty idą przez Twojego dostawcę; Cmssy je zapisuje.
  • Nie zarządza zespołem. Asystent może wypisać członków i role, ale nie zaprosi, nie usunie i nie zmieni nikomu roli.
  • Nie wyjdzie poza Twoją rolę. Zestaw narzędzi powstaje z Twoich uprawnień na początku każdego uruchomienia.

Na co patrzeć w CMS z AI

  • Czasowniki, nie tylko CRUD - czy agent umie zrobić zwrot, realizację i rabat, czy tylko tworzyć i aktualizować rekordy?
  • Krok potwierdzenia przy nieodwracalnym - wymuszany przez serwer, a nie zostawiony promptowi.
  • Własny klucz - jaki model, czyj rachunek i jakiego planu to wymaga.
  • Uprawnienia - czy agent działa jako Ty, z Twoją rolą, czy z kluczem głównym?
  • Kod zostaje Twój - zmiana treści nie powinna wymagać wdrożenia, a agent nie powinien potrzebować zapisu do Twojego repozytorium.

Jak zacząć

  1. Dodaj klucz dostawcy - Settings → AI Provider w panelu, potem Cmd + K. Zobacz dokumentację asystenta.
  2. Albo podłącz klienta MCP - utwórz token API i dodaj @cmssy/mcp-server do konfiguracji klienta. Zobacz dokumentację serwera MCP.
  3. Wyrenderuj to w swojej aplikacji - zacznij od cmssy-io/examples albo podłącz własną aplikację według przewodnika instalacji. Żeby zobaczyć działający sklep, otwórz dema.