Kommandoer med eksempler

Du skriver ikke kommandonavn på fastsite. Du sier hva du vil ha, og agenten velger verktøyet. Navnene er likevel her, av to grunner: slik at du kan gjenkjenne hva agenten nettopp gjorde med nettstedet ditt, og slik at du kan være presis i de tilfellene der det har betydning. Hvis ingen klient er tilkoblet ennå, begynn med å koble til agenten din og kom tilbake.

De to åpnerne

To kommandoer er verdt å kjenne ved navn, fordi hver økt begynner med dem.

List opp nettstedene mine.	list_sites — returnerer håndtakene. Et nettstedshåndtak er det første argumentet til nesten alle andre kommandoer, så dette er hvordan en økt får oversikt.
Les forfatterguiden for nettstedet blog, og lag deretter utkastet til siden.	get_authoring_guide — reglene som byggerevisjonen faktisk håndhever, kombinert med nettstedets lokaliseringer og innbyggingssyntaks. En agent som leser den skriver markup som publiseres. En som gjetter, skriver markup som blir avvist.

De første ti minuttene dine

Fra tom motor til publisert side. Si disse én om gangen og les hva som kommer tilbake før du går videre.

1. Opprett et nettsted kalt Notes på notes.example.com. create_site gir deg et håndtak å adressere alt annet med.
2. Les forfatterguiden for det nettstedet. get_authoring_guide. Gjør dette før du skriver eller designer, ikke etter den første avvisningen.
3. Vis meg skallfilene. shell_list_files — Twig-malene og CSS-tokens som omslutter hver side.
4. Ta et øyeblikksbilde av skallet, og gjør deretter overskriften mørkere. shell_snapshot, deretter shell_put_file. Øyeblikksbilder er billige, og å gjenopprette ett er én enkelt kommando.
5. Skriv en kort om-side. create_page. Den lagres som utkast.
6. Forhåndsvis nettstedet. preview_site bygger uten å publisere og returnerer en URL. Byggerevisjonen kjører her, så dette er der dårlig markup dukker opp.
7. Publiser. publish_site. Én git-commit, live bak CDN-en.

Innhold

Hva har jeg på bloggen?	list_posts
Vis meg innlegg 14.	get_post — inkluderer HTML-brødteksten, som er det du vil ha før du ber om en redigering.
Skriv et innlegg om utgivelsen og publiser det.	create_post
Legg til en prisside.	create_page — samme ting uten dato. Slug-er kan nøstes, så help/getting-started fungerer hvis du bevarer en gammel URL-struktur.
Stram inn den andre halvdelen av det innlegget og fiks overskriften.	update_post — bare feltene den sender endres.
Slett den gamle lanseringssiden.	delete_content — søppelkassen, ikke borte. Det neste bygget fjerner siden.

Research og sjekk

Begge kaller ut til en nettbasert modell, så de tar et øyeblikk og er verdt det for alt som inneholder tall.

Research hva som endret seg i EUs tilgjengelighetsregler i år før du skriver.	research — en strukturert oversikt med tall og kilder å skrive fra. Kilder først, utkast etterpå.
Faktasjekk det innlegget.	fact_check — per-påstand-vurderinger med kilder, lagret på innholdsraden. Priser og statistikk er det den er laget for. Aktiver det per nettsted.

Media

Importer det bildet og bruk det som fremhevet bilde.	upload_media_from_url. Alt-tekst er påkrevd ved opplasting, og bilder legges inn med medie-id — en ekstern bilde-URL i en brødtekst feiler bygget.
Hva er i mediebiblioteket?	list_media
Fjern det gamle skjermbildet.	delete_media, kan angres med restore_media. purge_media er den som sletter filene permanent.

Design

Skallet er rammen rundt hver side: Twig-maler, CSS-tokens, oversettelsesstrenger. Innhold bærer aldri sin egen styling, så dette er der et redesign skjer.

Hva er i skallet?	shell_list_files
Vis meg basismal​en.	shell_get_file
Gjør aksentfargen varmere på hele nettstedet.	shell_put_file på tokens-filen — vanligvis en enlinjes redigering som farger om alt. Valideres ved skriving, utløser et nybygg.
Ta et øyeblikksbilde av skallet først.	shell_snapshot
Sett det tilbake til slik det var.	shell_restore — og en gjenoppretting tar sitt eget øyeblikksbilde først, så det å angre en angring fungerer.

Komponenter

Bygg meg en pristabell-komponent.	upsert_component — HTML eller React. Bygget gjengir den til statisk markup, så ingenting sendes som JavaScript.
Hvilke komponenter har dette nettstedet?	list_components, og delete_component for å slette én.

Språk

Legg til tysk og oversett alt.	add_language — legger til lokaliseringen og setter oversettelsen i kø.
Oppdater oversettelsene, jeg endret tre sider.	translate_site, som publiserer når det er ferdig.
Legg inn en språkbytter i overskriften.	get_language_switcher returnerer markøren og markup-en. Plasseringen er din — ingenting settes inn automatisk.
Fjern svensk.	remove_language — fjerner oversettelsene og lokalisasjonens sider, og bygger deretter på nytt.

Publisering

Forhåndsvis det.	preview_site — bygger, kjører revisjonen, publiserer ingenting.
Publiser.	publish_site — returnerer en jobb å følge med på.
Er det ferdig?	get_build_status
Hva har blitt bygget nylig?	list_jobs — bygg, publiseringer og oversettelser, nyeste først.

Ruting og nettstedsskript

Pek den gamle pris-URL-en til den nye.	upsert_redirect. list_redirects viser også fangede 404-er, som er det bedre stedet å begynne.
Slett den omdirigeringen.	delete_redirect
Legg til analysekodebiten.	upsert_script — hode eller kropp, satt på nettstedsnivå i stedet for limt inn i en brødtekst. list_scripts og delete_script for resten.

Å angre ting

Tre separate sikkerhetsnett, i tre forskjellige størrelser.

Hva er i søppelkassen?	list_trash, deretter restore_content. purge_content er den permanente.
Gjenopprett skallet til gårsdagens revisjon.	shell_restore — bare design, ingen innhold berøres.
Ta sikkerhetskopi av nettstedet.	backup_site, list_backups, restore_backup — hele nettstedet, database inkludert. En gjenoppretting bygger opp på nytt og publiserer.

Nettsteder, team og legitimasjon

Opprett et nettsted for den nye kunden.	create_site
Endre basis-URL-en og git-grenen.	update_site — også der servemodus, kanonisk vert og faktasjekkbryteren finnes.
Legg til GitHub-tokenet mitt slik at dette kan publisere.	add_github_credential, med list_github_credentials og delete_github_credential. Tokens lagres kryptert og returneres aldri.
Inviter designeren min.	create_team, invite_member, accept_invite, list_teams.

Webhooks

Hva kan poste inn på dette nettstedet?	list_webhooks — viser også de innebygde mapperne, som er det som gjør om en innkommende nyttelast til et innlegg eller en side.
Gi meg et endepunkt som automatiseringen min kan poste utkast til.	create_webhook
Ble det utløst?	webhook_deliveries

Den fullstendige mekanikken finner du på webhooks-siden.

Når en kommando returnerer med en feil

Feil returneres som lesbare meldinger i stedet for transportfeil, noe som betyr at agenten din vanligvis kan lese meldingen og rette seg selv. Be den om det. De tre du vil møte først:

• Brødteksten ble avvist. Innhold er kun HTML-brødtekst — ingen <script>, ingen innebygde stiler, ingen eksterne bilder. Be agenten lese forfatterguiden og omskrive.
• Et bilde feilet bygget. Bilder må lastes opp først og refereres med medie-id, med alt-tekst. En hotlinket URL passerer aldri.
• Ingenting endret seg på det live nettstedet. Skriving er ikke publisering. Be om publish_site, eller sjekk get_build_status hvis du allerede har gjort det.

Protokollen under — oppdagelse, omfang, token-levetider, den autoritative verktøykatalogen for din versjon — finner du på MCP-referansen. Foretrekker du vanlig HTTP? REST API-et dekker det samme med en API-nøkkel.