Kommandoer med eksempler

Du skriver ikke kommandonavne på fastsite. Du siger, hvad du vil have, og agenten vælger værktøjet. Navnene er her alligevel, af to grunde: så du kan genkende, hvad din agent netop har gjort ved dit site, og så du kan være præcis i de situationer, hvor det har betydning. Hvis der endnu ikke er tilsluttet en klient, så start med at tilslutte din agent og kom tilbage.

De to åbnere

To kommandoer er værd at kende ved navn, fordi hver session starter med dem.

List mine sites.	list_sites — returnerer handles. Et site-handle er det første argument til næsten alle andre kommandoer, så det er sådan en session får sit udgangspunkt.
Læs forfatterguiden til site blog, og skriv derefter siden som udkast.	get_authoring_guide — de regler, som build-revisionen faktisk håndhæver, samlet med det sites sprogindstillinger og embed-syntaks. En agent, der læser den, skriver markup, der publiceres. En, der gætter, skriver markup, der bliver afvist.

Dine første ti minutter

Fra tom motor til publiceret side. Sig disse én ad gangen og læs, hvad der kommer tilbage, inden du går videre.

1. Opret et site kaldet Notes på notes.example.com. create_site giver dig et handle til at adressere alt andet med.
2. Læs forfatterguiden til det site. get_authoring_guide. Gør dette inden du skriver eller designer, ikke efter den første afvisning.
3. Vis mig shell-filerne. shell_list_files — de Twig-skabeloner og CSS-tokens, der omslutter hver side.
4. Tag et snapshot af shellen, og gør derefter headeren mørkere. shell_snapshot, derefter shell_put_file. Snapshots er billige, og gendannelse af ét er en enkelt kommando.
5. Skriv en kort om-side. create_page. Den lander som et udkast.
6. Forhåndsvis sitet. preview_site bygger uden at deployere og giver en URL tilbage. Build-revisionen kører her, så det er her dårlig markup dukker op.
7. Publicer. publish_site. Ét git-commit, live bag CDN'et.

Indhold

Hvad har jeg på bloggen?	list_posts
Vis mig indlæg 14.	get_post — inkluderer brødtekstens HTML, hvilket er det, du vil have, inden du beder om en redigering.
Skriv et indlæg om udgivelsen, publicer det.	create_post
Tilføj en prisside.	create_page — samme ting uden en dato. Slugs kan indlejres, så help/getting-started virker, hvis du bevarer en gammel URL-struktur.
Stram den anden halvdel af det indlæg op og ret overskriften.	update_post — kun de felter, det sender, ændres.
Slet den gamle lanceringside.	delete_content — papirkurv, ikke væk. Det næste build fjerner siden.

Research og kontrol

Begge kalder ud til en webbaseret model, så de koster et øjeblik og er det værd ved alt med et tal i det.

Undersøg hvad der ændrede sig i EU's tilgængelighedsregler i år, inden du skriver.	research — et struktureret resumé med tal og kilder at skrive ud fra. Kilder først, udkast bagefter.
Faktatjek det indlæg.	fact_check — per-påstand afgørelser med kilder, gemt på indholds-rækken. Priser og statistikker er det, det er til. Aktiver det per site.

Medier

Importér det billede og brug det som fremhævet billede.	upload_media_from_url. Alt-tekst er påkrævet ved upload, og billeder indlejres via medie-id — en ekstern billed-URL i en brødtekst fejler buildet.
Hvad er i mediebiblioteket?	list_media
Fjern det gamle screenshot.	delete_media, kan fortrydes med restore_media. purge_media er den, der sletter filerne.

Design

Shellen er den ramme, der omgiver hver side: Twig-skabeloner, CSS-tokens, oversættelsesstrengeStrenge. Indhold bærer aldrig sin egen styling, så det er her et redesign sker.

Hvad er i shellen?	shell_list_files
Vis mig baseskabelonen.	shell_get_file
Gør accentfarven varmere på tværs af hele sitet.	shell_put_file på tokens-filen — normalt en enkelt linje, der genfarvning alt. Valideres ved skrivning, udløser et rebuild.
Tag et snapshot af shellen først.	shell_snapshot
Sæt det tilbage, som det var.	shell_restore — og en gendannelse tager sit eget snapshot først, så fortrydelse af en fortrydelse virker.

Komponenter

Byg mig en pristabel-komponent.	upsert_component — HTML eller React. Buildet renderer den til statisk markup, så intet sendes som JavaScript.
Hvilke komponenter har dette site?	list_components, og delete_component for at slette én.

Sprog

Tilføj tysk og oversæt alt.	add_language — tilføjer lokaliteten og sætter oversættelsen i kø.
Opdater oversættelserne, jeg har ændret tre sider.	translate_site, som publicerer, når det er færdigt.
Sæt en sprogvælger i headeren.	get_language_switcher returnerer markøren og markup'en. Placering er dit ansvar — intet indsættes automatisk.
Fjern svensk.	remove_language — fjerner oversættelserne og lokalitetens sider, og rebuilder derefter.

Publicering

Forhåndsvis det.	preview_site — bygger, kører revisionen, deployer intet.
Publicer.	publish_site — returnerer et job at følge.
Er det færdigt?	get_build_status
Hvad er der blevet bygget for nylig?	list_jobs — builds, publiceringer og oversættelser, nyeste først.

Routing og site-scripts

Peg den gamle pris-URL mod den nye.	upsert_redirect. list_redirects viser også registrerede 404'er, hvilket er det bedre sted at starte.
Slet den omdirigering.	delete_redirect
Tilføj analytics-snippetten.	upsert_script — head eller body, sat på site-niveau frem for indsat i en brødtekst. list_scripts og delete_script til resten.

At fortryde ting

Tre separate sikkerhedsnet, i tre forskellige størrelser.

Hvad er i papirkurven?	list_trash, derefter restore_content. purge_content er den permanente.
Gendan shellen til gårsdagens revision.	shell_restore — kun design, intet indhold berøres.
Sikkerhedskopier sitet.	backup_site, list_backups, restore_backup — hele sitet, database inkluderet. En gendannelse rebuilder og publicerer.

Sites, teams og legitimationsoplysninger

Opret et site til den nye klient.	create_site
Skift basis-URL'en og git-branchen.	update_site — også her lever serve-tilstand, kanonisk host og faktatjek-skiftet.
Tilføj mit GitHub-token, så dette kan publicere.	add_github_credential, med list_github_credentials og delete_github_credential. Tokens gemmes krypteret og returneres aldrig.
Invitér min designer.	create_team, invite_member, accept_invite, list_teams.

Webhooks

Hvad kan poste ind i dette site?	list_webhooks — viser også de indbyggede mappere, som er det, der omdanner en indgående payload til et indlæg eller en side.
Giv mig et endpoint, som min automatisering kan poste udkast til.	create_webhook
Blev det afsendt?	webhook_deliveries

Den fulde mekanik findes på webhooks-siden.

Når en kommando returnerer en fejl

Fejl returneres som læsbare beskeder frem for transportfejl, hvilket betyder, at din agent normalt kan læse beskeden og rette sig selv. Bed den om det. De tre, du møder først:

• Brødteksten blev afvist. Indhold er kun brødtekst-HTML — ingen <script>, ingen inline-styles, ingen eksterne billeder. Bed agenten om at læse forfatterguiden og skrive om.
• Et billede fejlede buildet. Billeder skal uploades først og refereres via medie-id med alt-tekst. En hotlinket URL består aldrig.
• Intet ændrede sig på det live site. Skrivning er ikke publicering. Bed om publish_site, eller tjek get_build_status, hvis du allerede har gjort det.

Protokollen underneath — opdagelse, scopes, token-levetider, det autoritative værktøjskatalog for din version — findes på MCP-referencen. Foretrækker du plain HTTP? REST API'et dækker det samme med en API-nøgle.