Agenci AI (MCP)
page-builder-sandwich dla agentów AI
Twoja witryna WordPress jest osobnym serwerem MCP. Asystent AI loguje się jako użytkownik WordPressa za pomocą hasła aplikacyjnego i może robić to, co ten użytkownik może zrobić za pomocą page-builder-sandwich – nic więcej.
96 akcji: 46 bezpłatnych, 50 w planie Pro.
Dokumentacja dla programistów: każda akcja, jej ścieżka REST oraz parametry
Skonfiguruj to w trzech krokach
Sprawdź przełącznik
Potrzebujesz WordPress 6.9 lub nowszego oraz page-builder-sandwich 6.23.0 lub nowszego. W ustawieniach wtyczki opcja „Zezwalaj na agentów AI (MCP)” jest włączona, chyba że została wyłączona.
Utwórz hasło aplikacji
W WordPressie otwórz Użytkownicy, następnie Profil i dodaj hasło aplikacyjne nazwane na cześć swojej aplikacji AI. Skopiuj je: WordPress wyświetla je tylko raz.
Dodaj witrynę do swojej aplikacji AI
Użyj swojej nazwy użytkownika WordPress, hasła do aplikacji oraz adresu połączenia swojej witryny:
https://example.com/wp-json/pbs/v1/mcp
Konfiguracja dla popularnych aplikacji AI
Każda aplikacja poniżej komunikuje się z Twoją witryną za pośrednictwem oficjalnego pełnomocnika WordPress, @automattic/mcp-wordpress-remote. Zastąp adres, nazwę użytkownika i hasło własnymi danymi.
Claude Desktop
// claude_desktop_config.json
{
"mcpServers": {
"page-builder-sandwich": {
"command": "npx",
"args": [
"-y",
"@automattic/mcp-wordpress-remote@latest"
],
"env": {
"WP_API_URL": "https://example.com/wp-json/pbs/v1/mcp",
"WP_API_USERNAME": "your-username",
"WP_API_PASSWORD": "your-application-password"
}
}
}
}Claude Code
claude mcp add page-builder-sandwich \
-e WP_API_URL=https://example.com/wp-json/pbs/v1/mcp \
-e WP_API_USERNAME=your-username \
-e WP_API_PASSWORD=your-application-password \
-- npx -y @automattic/mcp-wordpress-remote@latestKursor i VS Code
// .cursor/mcp.json · .vscode/mcp.json
{
"mcpServers": {
"page-builder-sandwich": {
"command": "npx",
"args": [
"-y",
"@automattic/mcp-wordpress-remote@latest"
],
"env": {
"WP_API_URL": "https://example.com/wp-json/pbs/v1/mcp",
"WP_API_USERNAME": "your-username",
"WP_API_PASSWORD": "your-application-password"
}
}
}
}ChatGPT i inne aplikacje
Każda aplikacja obsługująca serwery MCP przez standardowe wejście i wyjście może używać tego samego polecenia i tych samych ustawień. Aplikacje, które łączą się tylko ze zdalnymi serwerami HTTP, mogą uzyskać bezpośredni dostęp do adresu połączenia przy użyciu tej samej nazwy użytkownika i tego samego hasła aplikacji.
Co może zrobić agent AI
Wszystko, co potrafią własne ekrany wtyczki. Akcje oznaczone jako Pro wymagają licencji page-builder-sandwich Pro.
| Akcja | Jak to działa | Wydanie |
|---|---|---|
| Włącz wgraną czcionkę (Pro) | Sprawia, że przesłana czcionka niestandardowa (plik czcionki w bibliotece mediów, według identyfikatora) jest dostępna w selektorach czcionek. | Edycja Pro |
| Hostuj czcionkę we własnym zakresie | Pobiera rodzinę czcionek Google (family, weights, italic) i udostępnia ją z tej witryny. | Wersja darmowa |
| Dodaj sekcję do strony | Dodaje gotową sekcję do strony: na początku, na końcu lub po sekcji na określonej pozycji. | Wersja darmowa |
| Zastosuj zestaw marki (Pro) | Stosuje kolory i czcionki z zapisanego zestawu identyfikacji wizualnej w projekcie witryny. | Edycja Pro |
| Zaimportuj zestaw witryny | Importuje strony zestawu witryny (wszystkie lub wskazane z nazwy), opcjonalnie je publikując, ustawiając stronę główną i dodając je do menu. Ponowne importowanie aktualizuje te same strony. | Wersja darmowa |
| Zastosuj znajdź i zamień (Pro) | Stosuje zadanie, którego podgląd został wyświetlony. Każdy zmieniony post zachowuje kopię zapasową dla pbs/undo-replace. | Edycja Pro |
| Utwórz kilka stron | Tworzy do 50 stron w jednym wywołaniu, każdą z sekcji i/lub treści blokowych. Każda strona jest sprawdzana i tworzona osobno; odpowiedź zawiera listę wszystkich utworzonych i odrzuconych stron wraz z podaniem przyczyny. | Edycja Pro |
| Połącz z Adobe Fonts (Pro) | Łączy projekt internetowy Adobe Fonts (Typekit) za pomocą jego identyfikatora zestawu (kit id), dzięki czemu czcionki pojawiają się w selektorach czcionek. | Edycja Pro |
| Połącz z pomocą techniczną | Łączy tę witrynę z pomocą techniczną Zinn Digital® (imię i nazwisko, adres e-mail, zgoda). | Wersja darmowa |
| Skonwertuj jedną starszą stronę | Konwertuje jedną stronę 5.x na bloki (najpierw tworzona jest kopia zapasowa). | Wersja darmowa |
| Utwórz klasę globalną (Pro) | Tworzy globalną klasę stylu wielokrotnego użytku: etykietę, slug i jej style. | Edycja Pro |
| Utwórz stronę | Tworzy stronę z sekcji (zobacz pbs/list-sections) i/lub zawartości bloków. Nowa strona jest szkicem, chyba że zażądano innego statusu. | Wersja darmowa |
| Utwórz zespół biblioteki (Agencja) | Tworzy bibliotekę zespołu (name), do której inne witryny mogą dołączyć za pomocą kodu zaproszenia. | Edycja Pro |
| Wyłącz przesłaną czcionkę (Pro) | Usuwa niestandardową czcionkę (według identyfikatora slug) z selektorów czcionek. | Edycja Pro |
| Usuń klasę globalną (Pro) | Usuwa klasę globalną. Elementy, które z niej korzystały, zachowują swoją treść, ale tracą jej style. | Edycja Pro |
| Usuń wgraną ikonę | Usuwa przesłaną ikonę; bloki, które jej używały, zachowują własną kopię. | Wersja darmowa |
| Usuń projekt biblioteki w chmurze (Pro) | Usuwa projekt z biblioteki w chmurze. | Edycja Pro |
| Przenieś stronę do kosza | Przenosi stronę do kosza. Można ją przywrócić ze strony Strony > Kosz w ciągu 30 dni. | Wersja darmowa |
| Usuń zespół biblioteki (Agencja) | Usuwa zespół i każdy projekt znajdujący się w jego bibliotece. | Edycja Pro |
| Odłącz od pomocy technicznej | Odłącza tę witrynę od pomocy technicznej. | Wersja darmowa |
| Duplikuj klasę globalną (Pro) | Kopiuje klasę globalną pod nowym identyfikatorem. | Edycja Pro |
| Powiel stronę | Kopiuje stronę (jej tytuł, treść i szablon) do nowego szkicu. | Wersja darmowa |
| Eksportuj projekty i ustawienia | Eksportuje wybrane szablony i wzorce (identyfikatory) oraz, opcjonalnie, ustawienia jako jedną paczkę dla innej witryny. | Wersja darmowa |
| Napisz stronę za pomocą AI | Tworzy stronę z sekcji (podanych lub wybranych przez sztuczną inteligencję z biblioteki sekcji) i sprawia, że sztuczna inteligencja przepisuje cały jej tekst zgodnie z Twoimi wytycznymi, zachowując projekt. Korzysta z dostawcy sztucznej inteligencji skonfigurowanego w ustawieniach sztucznej inteligencji w wtyczce. Strona jest szkicem, chyba że zażądano innego statusu. | Edycja Pro |
| Opisz blok kreatora | Zwraca ustawienia jednego bloku (atrybuty wraz z ich typami, wyborszami i wartościami domyślnymi), obsługiwane funkcje, bloki, jakie może zawierać, oraz gotowy do użycia przykład w znacznikach bloku. | Wersja darmowa |
| Przeczytaj punkty przerwania RWD | Zwraca szerokości dla tabletów i urządzeń mobilnych (oraz niestandardowe punkty przerwania w wersji Pro), z których korzystają elementy sterujące responsywnością. | Wersja darmowa |
| Odczytaj projekt witryny | Zwraca ogólnowitrynowe kolory i czcionki (nagłówka i treści) używane przez każdy blok, w taki sposób, w jaki prezentuje je ekran Projektu witryny. | Wersja darmowa |
| Przeczytaj system projektowania (Pro) | Zwraca system projektowy Pro: globalne klasy, zmienne, tokeny projektowe, tryb ciemny, zestaw marki i czcionki niestandardowe. | Edycja Pro |
| Przeczytaj diagnostykę strony | Zwraca dane diagnostyczne, które zawierałby bilet pomocy technicznej: wersje, aktywne wtyczki, limity oraz ostatnie błędy. | Wersja darmowa |
| Odczytaj konto biblioteki w chmurze (Pro) | Zwraca użycie pamięci masowej biblioteki chmurowej, limit planu i informacje o zespole. | Edycja Pro |
| Uzyskaj projekt biblioteki w chmurze (Pro) | Zwraca jeden zapisany projekt, gotowy do wstawienia na tej stronie (jego obrazy zostały dodane do biblioteki mediów). | Edycja Pro |
| Odczytaj ustawienia pamięci własnej (Pro) | Zwraca ustawienia własnej pamięci masowej R2/S3 (klucz tajny nigdy nie jest zwracany). | Edycja Pro |
| Przeczytaj licencję | Zwraca plan Page Builder Sandwich tej witryny, stan licencji, datę odnowienia oraz informacje o tym, co zawiera plan. | Wersja darmowa |
| Tryb konserwacji (Pro) | Tryb konserwacji / w budowie: tryb, strona, ponowna próba za i role, które nadal widzą witrynę. | Edycja Pro |
| Zapoznaj się z migracją starszej wersji | Zwraca postęp i raport konwersji zawartości z wersji 5.x. | Wersja darmowa |
| Przeczytaj połączenie z biuletynem (Pro) | Określa, czy klucz Mailchimp jest zapisany (sam klucz nigdy nie jest zwracany). | Edycja Pro |
| Przeczytaj stronę | Zwraca tytuł strony, status, odnośniki i zawartość blokową oraz sekcje (bloki najwyższego poziomu), z których się składa. | Wersja darmowa |
| Wyświetl podgląd operacji znajdź i zamień (Pro) | Zwraca dopasowania oferty pracy strona po stronie w celu ich sprawdzenia przed aplikowaniem. | Edycja Pro |
| Przeczytaj źródła opinii (Pro) | Zwraca źródła Google i Trustpilot, które wyświetla blok opinii. | Edycja Pro |
| Odczytaj uprawnienia kreatora (Pro) | Zwraca informacje o tym, które role mogą korzystać z kreatora, projektowania, kodu i szablonów (tryb klienta). | Edycja Pro |
| Odczytaj ustawienia wtyczki | Zwraca prefiks klasy front-endu, stan aktualizacji wersji beta oraz informację, czy dozwolone są agenci sztucznej inteligencji (MCP). | Wersja darmowa |
| Przeczytaj połączenie pomocy technicznej | Informuje, czy ta witryna jest połączona z pomocą techniczną Zinn Digital® i jako kto. | Wersja darmowa |
| Przeczytaj markę własną (Agencja) | Zwraca ustawienia marki własnej: włączone lub wyłączone, wyświetlaną nazwę oraz użytkowników, którzy nadal widzą oryginał. | Edycja Pro |
| Importuj projekty i ustawienia | Importuje pakiet utworzony przez pbs/export-designs (najpierw dryRun, aby zobaczyć, co ulegnie zmianie; tryb: skip lub replace; media; ustawienia). | Wersja darmowa |
| Zaproś witrynę do zespołu (Agencja) | Tworzy jednorazowy kod zaproszenia (rola: odczyt lub zapis; etykieta; ważność w dniach). Kod jest wyświetlany jeden raz. | Edycja Pro |
| Dołącz do zespołu (Pro) | Dołącza do biblioteki zespołowej za pomocą kodu zaproszenia. | Edycja Pro |
| Opuść zespół (Pro) | Opuszcza bibliotekę zespołową, do której ta strona dołączyła. | Edycja Pro |
| Wyświetl bloki kreatora | Wyświetla listę wszystkich bloków Page Builder Sandwich, z których ta strona może korzystać (również bloków Pro, gdy wersja Pro jest aktywna): nazwę, tytuł, kategorię i opis. Użyj pbs/get-block, aby pobrać ustawienia bloku, a następnie umieść blok w treści strony. | Wersja darmowa |
| Lista formularzy | Wyświetla listę formularzy utworzonych za pomocą bloku Formularz oraz wtyczek formularzy, które można w nim osadzić. | Wersja darmowa |
| Wyświetl zestawy stron internetowych | Wyświetla listę zestawów stron internetowych (zestawów gotowych stron dla określonego rodzaju działalności), które ta witryna może zaimportować. | Wersja darmowa |
| Wyświetl projekty biblioteki w chmurze (Pro) | Wyświetla listę projektów zapisanych w bibliotece w chmurze (rodzaj: sekcja, strona lub wzorzec; zespół: biblioteka zespołu). | Edycja Pro |
| Wyświetl hostowane samodzielnie czcionki | Wyświetla czcionki Google, które ta witryna hostuje samodzielnie (pobierane raz, serwowane z witryny, brak żądań do Google). | Wersja darmowa |
| Wyświetl listę animacji Lottie (Pro) | Wyświetla listę przesłanych animacji Lottie. | Edycja Pro |
| Lista stron | Wyświetla strony, które możesz edytować, zaczynając od najnowszych, z opcjonalnym wyszukiwaniem. | Wersja darmowa |
| Lista zadań znajdź i zamień (Pro) | Wyświetla listę globalnych zadań znajdowania i zamieniania oraz ich stan. | Edycja Pro |
| Wyświetl sekcje | Wyświetla listę gotowych sekcji (nagłówek, funkcje, FAQ, opinie, wezwanie do działania i inne), które można dodać do strony. | Wersja darmowa |
| Lista tymczasowych logów pomocy technicznej | Wyświetla listę tymczasowych użytkowników wsparcia przyznanych naszemu zespołowi oraz czas wygaśnięcia dostępu każdego z nich. | Wersja darmowa |
| Lista członków zespołu (Pro) | Wyświetla listy witryn w zespole oraz ich uprawnienia dostępu. | Edycja Pro |
| Wyświetl zespoły biblioteki (Pro) | Wyświetla listy zespołów, do których należy lub które posiada ta witryna. | Edycja Pro |
| Wypisz elementy, które można wyeksportować | Wyświetla listę szablonów, wzorców i ustawień, które można wyeksportować do innej witryny. | Wersja darmowa |
| Wyświetl wgrane ikony | Wyświetla ikony SVG przesłane do biblioteki ikon, zaczynając od najnowszych. | Wersja darmowa |
| Przenieś sekcję | Przenosi sekcję strony z jednej pozycji na inną (indeksowanie od 0, tak jak na liście z pbs/get-page). | Wersja darmowa |
| Otwórz zgłoszenie do pomocy technicznej | Tworzy zgłoszenie do pomocy technicznej (temat, wiadomość, rodzaj, adres e-mail) wraz z diagnostyką tej witryny; parametry access_days i credentials opcjonalnie przyznają naszemu zespołowi tymczasowy dostęp. | Wersja darmowa |
| Wyrażenie zgody na diagnostykę wsparcia | Rejestruje zgodę administratora na przesyłanie danych diagnostycznych wraz ze zgłoszeniami do pomocy technicznej. | Wersja darmowa |
| Odśwież opinie teraz (Pro) | Pobiera najnowsze opinie z Trustpilot teraz, zamiast czekać na codzienne odświeżenie. | Edycja Pro |
| Usuń blok ze strony | Usuwa jeden blok (całą sekcję lub blok w jej wnętrzu) ze strony, odnajdując go po jego ścieżce. Poprzednia wersja strony pozostaje w jej wersjach historycznych. | Wersja darmowa |
| Zatrzymaj korzystanie z własnej pamięci masowej (Pro) | Usuwa ustawienia własnej pamięci masowej; ponownie używana jest pamięć masowa planu. | Edycja Pro |
| Usuń czcionkę hostowaną we własnym zakresie | Usuwa pliki samodzielnie hostowanej rodziny czcionek. | Wersja darmowa |
| Usuń członka zespołu (Agencja) | Usuwa witrynę z zespołu. | Edycja Pro |
| Cofnij tymczasowe loginy pomocy technicznej | Usuwa tymczasowych użytkowników wsparcia (identyfikatory). | Wersja darmowa |
| Zapisz projekt w bibliotece chmury (Pro) | Zapisuje znaczniki bloku (tytuł, typ, znaczniki, style, tagi) w bibliotece w chmurze lub zespołowej; obrazy są pakowane razem z nimi. | Edycja Pro |
| Użyj własnej pamięci masowej (Pro) | Zapisuje własną pamięć masową (bring-your-own storage): dostawca (r2 lub s3), zasobnik (bucket), region, punkt końcowy (endpoint), prefiks, key_id, secret, włączone. | Edycja Pro |
| Zmień tryb konserwacji (Pro) | Włącza lub wyłącza tryb konserwacji (503) lub tryb „wkrótce” (mode), wraz ze stroną do wyświetlenia (page_id), parametrem retry_after oraz rolami, które go pomijają. | Edycja Pro |
| Połącz z Mailchimp (Pro) | Zapisuje (lub, w przypadku pustej wartości, usuwa) klucz API Mailchimp używany przez blok biuletynu. | Edycja Pro |
| Zmień źródła opinii (Pro) | Ustawia miejsce w Google i firmę w Trustpilot, z których blok opinii pobiera dane. | Edycja Pro |
| Zmień uprawnienia kreatora (Pro) | Określa uprawnienia dla poszczególnych ról w kreatorze (role), np. rola klienta z dostępem wyłącznie do treści. | Edycja Pro |
| Zmień białą etykietę (Agencja) | Włącza lub wyłącza markę własną i ustawia nazwę widoczną dla klientów (enabled, name, agency_users). | Edycja Pro |
| Konwertuj starszą zawartość | Rozpoczyna (lub wznawia) konwersję każdej strony w wersji 5.x na bloki; każdy wpis jest najpierw kopiowany zapasowo. | Wersja darmowa |
| Znajdź i zamień w całej witrynie (Pro) | Uruchamia bezpieczne blokowo wyszukiwanie i zastępowanie (find, replace, kind: text, link lub colour; match_case; types). Nic nie ulega zmianie do momentu wykonania pbs/apply-replace. | Edycja Pro |
| Rozpocznij bezpłatny okres próbny wersji Pro | Rozpoczyna 14-dniowy okres próbny Page Builder Sandwich Pro dla tej witryny (bez konieczności płatności). | Wersja darmowa |
| Przetestuj własną pamięć masową (Pro) | Zapisuje, odczytuje i usuwa obiekt testowy we własnej pamięci masowej oraz raportuje każdy krok. | Edycja Pro |
| Cofnij jedną konwersję | Przywraca jedną skonwertowaną stronę z kopii zapasowej. | Wersja darmowa |
| Cofnij starszą migrację | Przywraca każdy skonwertowany wpis z jego kopii zapasowej. | Wersja darmowa |
| Cofnij znajdź i zamień (Pro) | Przywraca wpisy zmodyfikowane przez zadanie (edycja wpisu dokonana później pozostaje bez zmian). | Edycja Pro |
| Zmień ustawienia jednego bloku | Zmienia ustawienia (atrybuty) jednego bloku wewnątrz strony, znalezionego po jego ścieżce; wysłane atrybuty są scalane z obecnymi. Działa na blokach, które witryna renderuje ze swoich ustawień; w przypadku bloku, którego kod HTML jest zapisany na stronie, wyślij nową strukturę za pomocą pbs/update-page. | Wersja darmowa |
| Zmień zestaw marki (Pro) | Zapisuje zestaw identyfikacji wizualnej: nazwę, logo, kolory, czcionki nagłówków i tekstu oraz ton głosu marki używany przez sztuczną inteligencję do pisania. | Edycja Pro |
| Zmień punkty graniczne dla urządzeń mobilnych | Zmienia szerokość dla tabletu i urządzeń mobilnych w pikselach; z wersją Pro dostępne są niestandardowe punkty łamania. | Wersja darmowa |
| Zmień klasę globalną (Pro) | Zmienia etykietę, uproszczoną nazwę lub style klasy globalnej; każdy element, który jej używa, zostanie zaktualizowany. | Edycja Pro |
| Zmień tryb ciemny (Pro) | Ustawia tryb ciemny (tryb: off, auto lub toggle) oraz jego kolory. | Edycja Pro |
| Zmień projekt strony | Zmienia kolory w całej witrynie (colors), czcionki (fonts, headingFont, bodyFont). Każda strona uwzględnia tę zmianę; plik theme.json motywu jest utrzymywany w synchronizacji. | Wersja darmowa |
| Aktualizuj stronę | Zmienia tytuł, status lub zawartość bloku strony. Przesłana treść zastępuje zawartość strony. | Wersja darmowa |
| Zmień ustawienia wtyczki | Zmienia prefiks klasy front-endu (od 1 do 8 małych liter lub cyfr, zaczynający się od litery) i/lub włącza lub wyłącza agenty AI (MCP) (wartość mcp: false usuwa wszystkie uprawnienia oraz punkt końcowy MCP). | Wersja darmowa |
| Zmień tokeny projektu (Pro) | Zmienia skalę odstępów, promieni i cieni (space, radius, shadow) lub przywraca ich domyślne wartości (reset). | Edycja Pro |
| Zmień zmienne CSS (Pro) | Zastępuje zmienne projektu witryny (zmienne: lista nazw i wartości). | Edycja Pro |
| Wgraj ikonę | Dodaje ikonę SVG (nazwa, znacznik SVG) do biblioteki ikon; kod SVG jest najpierw oczyszczany. | Wersja darmowa |
| Prześlij animację Lottie (Pro) | Weryfikuje dokument Lottie JSON (json, name) i publikuje go jako plik statyczny dla bloku Lottie. | Edycja Pro |
Wprowadzenie krok po kroku
Serwer oferuje również gotowe przepływy pracy, które Twoja aplikacja AI wyświetla jako prompty:
- Utwórz stronę docelową — Prowadzony krok po kroku proces: agent wybiera sekcje pasujące do Twojej firmy, tworzy stronę jako szkic i pisze jej tekst.
Bezpieczny z założenia
Każda akcja sprawdza to samo uprawnienie WordPress co ekran samej wtyczki, dla dokładnej strony lub posta, których dotyczy. Subskrybent nie może w ogóle nawiązać połączenia.
Hasła aplikacyjne można w każdej chwili unieważnić w sekcji Użytkownicy, Profil, bez konieczności zmiany zwykłego hasła.
Wyłącz opcję „Zezwalaj na agentów AI (MCP)”, a działania i adres połączenia znikną z witryny.
Strony zmodyfikowane przez agenta zachowują swoje wersje WordPress, dzięki czemu każdą zmianę można cofnąć.
Hostowane w Zinn Digital®?
Jeśli Zinn Digital® hostuje witrynę, nasz własny serwer MCP może wykonywać te działania w Twoim imieniu bez hasła aplikacji: połącz swoją aplikację AI z serwerem MCP Zinn Digital® i użyj wordpress_abilities_list oraz wordpress_ability_run.