Du skriver inte kommandonamn på fastsite. Du säger vad du vill ha och agenten väljer verktyget. Namnen finns här ändå, av två skäl: så att du kan känna igen vad din agent just har gjort med din webbplats, och så att du kan vara exakt i de fall det spelar roll. Om ingen klient är ansluten ännu, börja med att ansluta din agent och kom tillbaka.

De två öppnarna

Två kommandon är värda att känna till vid namn, eftersom varje session börjar med dem.

Visa mina webbplatser.list_sites — returnerar handtagen. Ett webbplatshandtag är det första argumentet till nästan alla andra kommandon, så det är så en session orienterar sig.
Läs författarguiden för webbplatsen blog, och skriv sedan ett utkast till sidan.get_authoring_guide — reglerna som bygggranskaren faktiskt verkställer, sammanvävda med webbplatsens språkinställningar och inbäddningssyntax. En agent som läser den skriver uppmärkning som publiceras. En som gissar skriver uppmärkning som avvisas.

Dina första tio minuter

Från tom motor till publicerad sida. Säg dessa en i taget och läs svaret innan du går vidare.

  1. Skapa en webbplats kallad Notes på notes.example.com. create_site ger dig ett handtag att adressera allt annat med.
  2. Läs författarguiden för den webbplatsen. get_authoring_guide. Gör detta innan du skriver eller designar, inte efter det första avvisandet.
  3. Visa mig skalfilerna. shell_list_files — Twig-mallarna och CSS-tokens som omsluter varje sida.
  4. Ta en ögonblicksbild av skalet och gör sedan rubriken mörkare. shell_snapshot, sedan shell_put_file. Ögonblicksbilder är billiga och att återställa en är ett enda kommando.
  5. Skriv en kort om-sida. create_page. Den hamnar som ett utkast.
  6. Förhandsgranska webbplatsen. preview_site bygger utan att driftsätta och lämnar tillbaka en URL. Bygggranskaren körs här, så det är här felaktig uppmärkning upptäcks.
  7. Publicera. publish_site. Ett git-commit, live bakom CDN:et.

Ingenting når CDN:et på egen hand

Skrivande, redigering, översättning och omdesign stannar alla inne i motorn. Den publika webbplatsen förändras när du säger publicera, och det är ett enda commit som du kan återställa. Be om en förhandsgranskning istället och du får ett bygge som ingen annan ser.

Innehåll

Vad har jag på bloggen?list_posts
Visa mig inlägg 14.get_post — inkluderar HTML-kroppen, vilket är vad du vill ha innan du ber om en redigering.
Skriv ett inlägg om releasen och publicera det.create_post
Lägg till en prissättningssida.create_page — samma sak utan datum. Slugar kan vara nästlade, så help/getting-started fungerar om du bevarar en gammal URL-struktur.
Strama upp den andra halvan av det inlägget och fixa rubriken.update_post — bara de fält det skickar ändras.
Kasta den gamla lanseringssidan.delete_content — papperskorgen, inte borta. Nästa bygge tar bort sidan.

Forskning och kontroll

Båda anropar en webbaserad modell, så de kostar ett ögonblick och är värda det för allt med ett siffervärde i sig.

Undersök vad som förändrades i EU:s tillgänglighetsregler i år innan du skriver.research — en strukturerad genomgång med siffror och källhänvisningar att skriva utifrån. Källor först, utkast sedan.
Faktagranska det inlägget.fact_check — utfall per påstående med källor, sparade på innehållsraden. Priser och statistik är vad det är till för. Aktivera per webbplats.

Media

Importera den bilden och använd den som utvald bild.upload_media_from_url. Alternativtext krävs vid uppladdning, och bilder bäddas in med media-id — en extern bild-URL i en kropp underkänns i bygget.
Vad finns i mediebiblioteket?list_media
Ta bort den gamla skärmbilden.delete_media, reversibelt med restore_media. purge_media är den som raderar filerna permanent.

Design

Skalet är inramningen kring varje sida: Twig-mallar, CSS-tokens, översättningssträngar. Innehåll bär aldrig sin egen styling, så det är här en omdesign sker.

Vad finns i skalet?shell_list_files
Visa mig basmallen.shell_get_file
Gör accentfärgen varmare över hela webbplatsen.shell_put_file på tokens-filen — vanligtvis en enradsredigering som ändrar färgen på allt. Valideras vid skrivning och utlöser ett nytt bygge.
Ta en ögonblicksbild av skalet först.shell_snapshot
Återställ det som det var.shell_restore — och en återställning tar sin egen ögonblicksbild först, så att ångra en ångring fungerar.

Komponenter

Bygg en prissättningstabell-komponent åt mig.upsert_component — HTML eller React. Bygget renderar den till statisk uppmärkning, så inget skickas som JavaScript.
Vilka komponenter har den här webbplatsen?list_components, och delete_component för att ta bort en.

Språk

Lägg till tyska och översätt allt.add_language — lägger till språkinställningen och köar översättningen.
Uppdatera översättningarna, jag har ändrat tre sidor.translate_site, som publicerar när det är klart.
Lägg till en språkväxlare i rubriken.get_language_switcher returnerar markören och uppmärkningen. Placering är ditt ansvar — ingenting infogas automatiskt.
Ta bort svenska.remove_language — tar bort översättningarna och språkinställningens sidor och bygger sedan om.

Publicering

Förhandsgranska det.preview_site — bygger, kör granskningen, driftsätter ingenting.
Publicera.publish_site — returnerar ett jobb att följa.
Är det klart?get_build_status
Vad har byggts nyligen?list_jobs — byggen, publikationer och översättningar, nyaste först.

Routing och webbplatsskript

Peka den gamla prissättnings-URL:en mot den nya.upsert_redirect. list_redirects visar också fångade 404:or, vilket är den bättre startpunkten.
Ta bort den omdirigeringen.delete_redirect
Lägg till analyskodavsnittet.upsert_script — huvud eller kropp, angivet på webbplatsnivå snarare än inklistrat i en kropp. list_scripts och delete_script för resten.

Ett skript är det enda som kostar dig poängen

Allt annat i motorn är byggt för att hålla en sida på 100 över hela linjen. Aktivera ett huvud- eller sidfotsskript och webbplatsen avstår från den garantin — det är ditt val, men gör det medvetet snarare än av vana att klistra in en tagg.

Att ångra saker

Tre separata skyddsnät, i tre olika storlekar.

Vad finns i papperskorgen?list_trash, sedan restore_content. purge_content är den permanenta.
Återställ skalet till gårdagens version.shell_restore — endast design, inget innehåll berörs.
Säkerhetskopiera webbplatsen.backup_site, list_backups, restore_backup — hela webbplatsen, databas inkluderad. En återställning bygger om och publicerar.

Webbplatser, team och inloggningsuppgifter

Skapa en webbplats för den nya kunden.create_site
Ändra bas-URL:en och git-grenen.update_site — också där serve-läge, kanonisk värd och faktagranskningstoggelns inställningar finns.
Lägg till min GitHub-token så att detta kan publicera.add_github_credential, med list_github_credentials och delete_github_credential. Tokens lagras krypterade och returneras aldrig.
Bjud in min designer.create_team, invite_member, accept_invite, list_teams.

Webhooks

Vad kan posta till den här webbplatsen?list_webhooks — listar också de inbyggda mapparna, som är det som omvandlar en inkommande nyttolast till ett inlägg eller en sida.
Ge mig en slutpunkt som min automatisering kan posta utkast till.create_webhook
Utlöstes det?webhook_deliveries

Den fullständiga mekaniken finns på webhooks-sidan.

När ett kommando returnerar ett fel

Fel returneras som läsbara meddelanden snarare än transportfel, vilket innebär att din agent vanligtvis kan läsa meddelandet och korrigera sig själv. Be den om det. De tre du möter först:

  • Kroppen avvisades. Innehåll är enbart HTML-kropp — inga <script>, inga inline-stilar, inga externa bilder. Be agenten läsa författarguiden och skriva om.
  • En bild underkändes i bygget. Bilder måste laddas upp först och refereras med media-id, med alternativtext. En länkad URL godkänns aldrig.
  • Ingenting förändrades på den publika webbplatsen. Att skriva är inte att publicera. Be om publish_site, eller kontrollera get_build_status om du redan gjort det.

Protokollet under ytan — discovery, omfång, token-livstider, den auktoritativa verktygskatalogen för din version — finns på MCP-referensen. Föredrar du vanlig HTTP? REST API:et täcker samma område med en API-nyckel.