# IDEA: en egen blogg med admin, API och MCP, byggd med Claude En beskrivning och en färdig prompt för att bygga en blogg som **verkstad_**: snabb, färdigrenderad och sökmotorvänlig publikt, med en egen adminpanel, ett API och en MCP-server så att Claude kan skriva inlägg direkt. Kopiera prompten längst ned, justera det som står inom [hakparentes] och ge den till Claude Code i en tom katalog. ## Idén i korthet - **Publika sidor är vanlig HTML** från servern, inte en JavaScript-app. De laddas direkt, fungerar utan JavaScript och indexeras utan krångel. - **Admin är en separat app** (React) som bara du ser, på en adress du väljer själv. - **Ett enda API** används av admin, av skript med API-nyckel och av MCP-servern. Alla regler (validering, slugs, taggar, konfliktskydd) finns på ett ställe. - **MCP-servern** gör att Claude kan läsa skrivguiden, skapa utkast, ladda upp bilder och bifoga filer. Den publicerar bara när du ber om det. - **Inga externa beroenden i webbläsaren:** typsnitt och allt annat serveras från den egna servern. Ingen CDN, inga Google Fonts, ingen spårning. - **Två språk:** svenska i roten, engelska under /en/, med egna slugs, hreflang-länkar och översättningar som Claude skriver på begäran. ## Vad du behöver - En design. Vi gjorde den i Claude Design och fick en "handoff"-mapp med en HTML-prototyp och en README med färger, typografi och alla skärmar. En skiss eller en befintlig sajt att utgå från fungerar också. - En server med PHP 8.3 och MariaDB/MySQL, eller den stack du föredrar. - Docker lokalt, så att utvecklingsmiljön ser ut som produktionen. ## Beslut som visade sig viktiga 1. **Samma katalogstruktur lokalt som i produktion.** Bloggen ligger i en underkatalog (`/verkstad/`) på en större sajt. Kod som tar för givet att den äger "/" går sönder först i produktion, om den inte körs i underkatalog redan lokalt. 2. **Hemligheter utanför docroten.** Databaslösenordet och PHP-koden ligger i `private/verkstad/`. Webben når bara `public/verkstad/`. 3. **Färdig HTML + filcache.** Varje sida sparas som en fil och serveras utan databasanrop. Cachen töms vid varje ändring, oavsett om den görs från admin, via API:t eller via MCP. 4. **En markdown-dialekt, två identiska tolkar** (PHP och TypeScript), testade mot samma exempel. Förhandsvisningen i editorn är då exakt den sida som publiceras. 5. **Utkast sparas automatiskt, publicerat gör det inte.** Ändringar i ett publicerat inlägg syns först när du trycker Uppdatera. 6. **Konfliktskydd.** Varje ändring skickar med den version den utgick från. Har någon annan (en annan flik, eller Claude via MCP) hunnit före blir svaret 409 i stället för en tyst överskrivning. 7. **Tester i en riktig webbläsare.** En bugg som kraschade all navigering i admin (`window.scrollTo` returnerar en Promise i nyare webbläsare) syntes inte i vanliga tester. Testa med samma beteende som besökarnas webbläsare har. 8. **Ett ärendesystem från början.** Vi använde Linear: det som är byggt och verifierat, det som väntar på att någon provar det, och det som väntar på ett beslut. Det gör arbetet begripligt över flera sessioner. ## Prompten ``` Bygg en personlig blogg med adminpanel, API och MCP-server. Stack: PHP 8.3 + MariaDB utan ramverk och utan PHP-beroenden, Apache med .htaccess, lokal utveckling i Docker. Admin i React 18 + Vite + TypeScript. Design: se [katalogen design/ — en HTML-prototyp och en README med designtokens, typografi och alla skärmar]. Återskapa den så exakt som möjligt, i ljust och mörkt tema. Inga rundade hörn, inga skuggor [eller: din egen designregel]. Publik sajt: - Färdigrenderad HTML från PHP-mallar, fungerar utan JavaScript. - Sidor: start, arkiv (taggfilter, sidnumrering), inlägg, om, RSS-sida, 404, 500 (500-sidan ska fungera med databasen nere). - SEO: title, meta description, canonical, Open Graph, JSON-LD, sitemap.xml, RSS 2.0 (alla inlägg och per tagg), riktiga statuskoder. - Hela sidor cachas som filer och cachen töms vid varje ändring. - Bilder med srcset (400/800/1600 px). Inga anrop till andra värdar: självhosta typsnitten. - Bloggen ska ligga i underkatalogen [/blogg/] på en större sajt. Kör den så även lokalt. Kod och storage ska ligga utanför docroten: /[sajt]/public/[blogg]/ och /[sajt]/private/[blogg]/{app,storage}/. - En inställning för att stänga sajten för besökare (503, bara loggan syns) medan inloggad admin ser den som vanligt. - [Valfritt] Två språk: [svenska] i roten, [engelska] under /en/, varje inlägg med egen slug per språk, hreflang-länkar och en språkväxlare. Admin (på en adress du väljer, inte /admin): - Inloggning med "kom ihåg mig", CSRF-skydd och spärr mot gissning. - Inlägg: lista, editor med markdown-verktygsrad och förhandsvisning som använder samma tolk som sajten, autosparade utkast, konfliktskydd. - Media: uppladdning, alt-text, var bilden används. Uppladdningar ligger i en katalog per inlägg och följer med om inlägget byter slug. - Bifogade filer per inlägg (zip, md, pdf m.fl.), alltid som nedladdning. - Taggar, inställningar, och API-nycklar (läsa / läsa + skriva) som visas en gång. API: /api/v1/ med samma regler för admin-sessionen och för API-nycklar. All affärslogik i ett repository-lager som API och MCP delar. MCP-server: Streamable HTTP i samma PHP-app, tillståndslös, autentiserad med API-nyckel. Verktyg: skrivguide, lista/hämta/skapa/ändra/publicera/radera inlägg, ladda upp bild, bifoga fil[, spara översättning]. Nya inlägg blir utkast. Arbetssätt: - Planera först och fråga om det som är ett verkligt beslut. - Håll ett ärende per ändring [i Linear / GitHub Issues], med vad som mättes. - "Klart" betyder testat: röktest (curl), API-test, markdown-paritet och ett webbläsartest (Playwright) av admin. Kör testerna i samma katalogstruktur som produktionen. - Inga lösenord i versionerade filer. ``` ## Vad det blev Knappt 80 källfiler: ungefär 3 600 rader PHP och 2 400 rader TypeScript och CSS för admin. Inga PHP-beroenden. Publika sidor på ungefär 95 kB, med 100 i Lighthouses fyra kategorier. Fyra testsviter med sammanlagt omkring 140 kontroller. Artikeln som den här filen hör till skrevs och laddades upp av Claude via bloggens egen MCP-server.