mini-cms-mcp
Summary: mini-cms-mcp is a remote MCP server that lets an AI assistant run a small flat-file PHP website — creating, editing, publishing, and organizing pages, blog articles, images, and PDFs — while never touching code or configuration.
Inspect the site —
despre_site(name, description, address, allowed HTML, how URLs work, key permissions),listeaza,citeste,cauta,listeaza_versiuni,listeaza_imagini,listeaza_fisiere,listeaza_redirectionari.Start a new site from scratch —
pagini_de_pornirereturns skeletons for home, about, services, contact and privacy pages with[[COMPLETEAZĂ: …]]placeholders to fill in with the human.Create and edit content —
salveazafor pages and articles (draft by default; only changed fields need sending): title, description, HTML body, tags, author, cover image, parent page for one-level submenus, menu position, and event details (date, venue, artists, ticket link) that become GoogleEventstructured data.Publish, schedule, withdraw, delete, restore —
publica(with futurela= scheduled),retrageback to draft,sterge(reversible),restaureazaany previous version as a draft.Preview before publishing —
previzualizeazagives the human a signed, expiring link showing a draft or scheduled item exactly as it will look; it also returns AI-readability tips.Set site identity and appearance —
seteaza_site: name, description, author, language, accent colour, logo, favicon, theme, footer text and links (author-networksameAs), article label, whether dates show, GA4 measurement ID, and the "made by" credit.Upload and manage images —
urca_imagine(from an https URL or small base64),link_urcare(a temporary link the human uses to upload photos from phone/PC without a key),sterge_imagine(refuses if in use).Upload and manage PDFs —
urca_fisier(up to 25 MB, from URL or ~6 MB base64, with replace option keeping the same address),listeaza_fisiere,sterge_fisier(refuses if linked from content).Manage old URLs —
redirectioneazasets 301 redirects from old addresses to new ones on the same site.Back up all content —
exportareturns site identity, full pages and articles (including drafts), redirects and image list with fingerprints.Audit and monitor —
citeste_jurnal(who did what, when, plus tamper-evident hash-chain check),listeaza_conexiuni(which OAuth apps are connected and their permissions),retrage_conexiuneto revoke an app's access.Read-only vs. write keys — read commands work with the read key; a write key (or an editor's key) is needed to change content; site identity and OAuth connections stay with the owner.
Provides installation and management instructions for deploying the CMS on cPanel hosting, including uploading the package and verifying the server.
mini-cms-mcp
An MCP server and a flat-file PHP CMS in one: you edit your website by talking to Claude. No database, no admin panel, no plugins. The AI changes the content, never the code.
It is a small, self-hosted, open source (MIT) CMS for a site of a few pages and a blog. The MCP server lives inside
the site itself, at https://your-site/mcp, so there is nothing else to run: no Node, no Docker, no VPS.
It installs on ordinary shared hosting with cPanel or Plesk and PHP 8.0+.
Edit an existing website with AI, from Claude Code or from the claude.ai connector (web, desktop app and phone): "Add an announcement about Saturday's event" → a draft appears; you preview it and publish.
A WordPress alternative for small sites: plain PHP, content stored as JSON files, every change versioned and logged (who changed what, and when). Backup is a copy of one folder.
Remote MCP server over Streamable HTTP, stateless (each request is a POST with a JSON reply). OAuth 2.1 with PKCE for the claude.ai connector; a key in the header for Claude Code. Separate keys for editors (for example, your client).
Readable by AI search: sitemap, feed,
llms.txt, clean HTML, FAQ markup, a built-in check that ChatGPT, Claude, Perplexity, Bing and Google bots are not blocked, and a server-side count of the pages they read.English tool descriptions: on a site whose base language is not Romanian, the AI gets every tool title, description and parameter in English, with
title,readOnlyHintanddestructiveHintannotations on every tool. Command names and replies stay in Romanian.GA4 only after consent: with Google Analytics turned on, nothing loads from Google until the visitor presses "Accept".
Network of sites: articles and pages can end with links to the author's other sites on the same subject, read on the server from a shared index (
retea, off by default).395 automated tests (install, update, backup, OAuth, SEO, measurement, attacks).
In production on five sites, including cms.paycode.ro, which runs on it and is managed from a conversation with Claude.
Documentation in English: how to install it · how to edit your site with Claude · why I left WordPress · a security audit by another AI. The rest of this README is in Romanian, the author's language. The commands in it work as written.
Un CMS mic pentru site-uri de câteva pagini și un blog, administrat de un asistent AI prin MCP (Model Context Protocol).
Principiul: AI-ul e singurul editor. Poate schimba conținutul, niciodată codul.
Site și documentație: cms.paycode.ro, care rulează chiar pe mini-cms-mcp și e administrat din conversația cu Claude, inclusiv de pe telefon. Acolo sunt ghidul de instalare pas cu pas, cu capturi din cPanel, și articolele despre de ce există și cine îl scrie.
PHP simplu (8.0+). Fără Composer, fără bază de date, fără fișiere de pe alte servere, fără panou de administrare.
Merge pe orice găzduire PHP obișnuită (Apache, cu cPanel sau Plesk). MCP prin Streamable HTTP fără sesiuni: fiecare cerere e un POST cu răspuns JSON.
Câteva mii de rânduri de PHP simplu pe server, plus teste automate (395 de verificări, inclusiv instalarea, actualizarea, copia de siguranță, OAuth, SEO și măsurarea).
Se leagă de Claude Code (cheie în antet) și de conectorul din claude.ai, web și telefon (OAuth, aprobat cu cheia site-ului).
Instalarea: o comandă pe calculator și un zip urcat în cPanel sau Plesk (File Manager).
Structura
site/ ← se urcă pe server, ca rădăcină a site-ului
index.php site-ul public (pagini, articole, sitemap, feed, robots, llms.txt)
mcp.php punctul de intrare pentru AI → https://site/mcp
jurnal.php jurnalul, pentru om (cheia se trimite prin formular)
imagini.php urcarea imaginilor din browser, pentru om (cheia de scriere, prin formular)
.htaccess reguli Apache (doar mod_rewrite și mod_headers, în IfModule)
assets/stil.css aspectul implicit
assets/teme/ teme alese cu seteaza_site: <nume>.css + fonturile în <nume>/ (de bază: simpluspv, cinesunt)
app/ codul (blocat din web)
sabloane/ șabloanele HTML (blocate din web)
date/ creat automat: pagini, articole, versiuni, jurnal, documentele PDF (blocat din web)
media/ creat automat: imaginile urcate
teste/ruleaza.php testele: pornesc o copie a site-ului și încearcă funcțiile și atacurile
unelte/instaleaza.php instalarea: teste, chei, config.php, pachetul .zip, verificarea serverului, legarea Claude Code
unelte/actualizeaza.php actualizarea codului de pe depozit, cerută de om (cheia de cod), cu copie și punere înapoi
unelte/copie.php copia de siguranță: salvează tot site-ul pe calculator și îl poate pune la loc (sau pe alt site)
unelte/urca-imagine.php urcă poze de pe calculator: le întoarce după telefon, le micșorează, scoate locația GPS
unelte/demo.php site-ul demo: instantaneul curat și resetarea (cheia de cod)
unelte/editor.php editorii unui site (de ex. clientul): cheie pe numele lor, adăugare și scoatere (cheia de cod)
unelte/tema.php temele proprii ale unui site (lucrări pentru un client): le pune, le înlocuiește, le scoate (cheia de cod)
unelte/comun.php funcțiile comune ale uneltelor
unelte/stdio.php puntea stdio: un site demo gol, local, pentru inspectoare și cataloage MCP (Dockerfile)
unelte/genereaza-cheie.php, unelte/router-local.phpRelated MCP server: Agentic CMS
Instalare, în doi pași
Condiția: un domeniu sau subdomeniu doar pentru site (site-ul stă la rădăcină), cu PHP 8.0+ și HTTPS. Ghidul complet, pentru cine n-a instalat niciodată PHP, cu capturi din cPanel: cms.paycode.ro/instalare-cms-administrat-de-ai.
1. Pe calculator, din folderul repo-ului:
php unelte/instaleaza.php https://test.exemplu.roComanda rulează testele, generează cele două chei, scrie config.php (adresa și doar amprentele cheilor) și face
pachetul minicms-<versiune>-<nume>.zip. Cheile și pachetul stau în folderul de deasupra repo-ului, în afara lui git:
chei-<nume>.json și _livrare/<nume>/. Cheile nu apar niciodată pe ecran; copiază-le în managerul de parole.
La o nouă rulare, cheile existente se refolosesc, iar pachetul și config-ul vechi se păstrează cu data în nume.
2. În cPanel: File Manager → folderul domeniului → Upload zip-ul → Extract → șterge zip-ul. Apoi Enter în terminal.
Comanda verifică serverul (/mcp 405; dosarele interne, jurnalul și zip-ul blocate — 403 sau 404, după găzduire, fără nimic
din fișier în răspuns; ambele chei), leagă Claude Code
de site cu cheia de scriere (pentru folderul proiectului) și arată adresa jurnalului.
Dacă ceva nu e în regulă, spune cauza și așteaptă să repari pe server. Verificarea se poate relua oricând:
php unelte/instaleaza.php https://test.exemplu.ro --verificaDupă instalare, în Claude: „Cheamă despre_site, apoi setează numele site-ului, descrierea și autorul.”
Numele, descrierea, autorul, limba și culoarea sunt conținut: le schimbă AI-ul cu seteaza_site, rămân în jurnal și
au versiuni. config.php ține doar ce nu trebuie să schimbe AI-ul: adresa și amprentele. Nu intră în git și nu poate
fi modificat prin MCP; ajunge pe server o singură dată, în pachetul urcat de om.
Dacă folderul avea deja un .htaccess pus de cPanel (MultiPHP), după Extract alegi din nou versiunea de PHP în
MultiPHP Manager, ca cPanel să-și rescrie blocul.
Teme
O temă e o foaie de stil pusă de om în site/assets/teme/<nume>.css, cu fonturile ei în site/assets/teme/<nume>/
(găzduite pe site: CSP-ul permite fonturi doar de pe același domeniu). Se încarcă după assets/stil.css și schimbă doar
aspectul, pe același HTML. AI-ul vede temele în despre_site și alege una cu seteaza_site (tema, "" = aspectul
implicit); nu poate scrie CSS. O temă aleasă dar scoasă de pe server e ignorată, fără eroare.
Tema simpluspv copiază blogul de pe simpluspv.eu (Bricolage Grotesque, Hanken Grotesk, Newsreader, toate sub SIL OFL 1.1).
Culoarea principală rămâne cea din identitate. Știe și două clase din articolele de acolo: p.aerisit (spațiu mai mare
după paragraf) și img.ingust (captură de telefon, 340 px, centrată), plus containerul video div.cai-video.
Tema cinesunt e aspectul site-ului cinesunt.info, mutat aici din CMS-ul lui vechi (Space Grotesk, Inter, JetBrains Mono,
tot SIL OFL 1.1): erou pe două coloane cu o cartelă de chat, pașii metodei, pastile colorate pe domenii, carduri cu
eticheta peste imagine. Prima pagină se așază în aceeași grilă cu titlul din șablon, doar din CSS.
Ce știe tema despre ea o spune AI-ului: primul comentariu din foaia de stil apare în despre_site (teme.despre).
Acolo își descrie autorul temei blocurile (clasele) pe care le știe, ca AI-ul să le folosească în conținut fără să
ghicească. Pagina poartă și clasa tipului ei pe <body> (pagina-acasa, pagina-articol, pagina-lista…), iar
fiecare etichetă clasa eticheta-<slug>, deci o temă poate așeza diferit prima pagină și poate colora etichetele.
Teme de bază și teme proprii
În depozit stau doar temele de bază (simpluspv, cinesunt): vin cu fiecare pachet, pe orice site. O temă făcută
pentru un client e o temă proprie: nu intră în depozit și nici în pachet. Stă doar pe calculatorul tău și pe serverul
acelui client. Dosarul ei de lucru e teme/, lângă depozit (implicit <dosar>/teme/, deci în afara repo-ului), așezat
exact ca assets/teme/: client.css și, lângă ea, dosarul client/ cu fonturile și imaginile.
php unelte/tema.php https://site.ro temele de pe site: de bază și proprii, plus cea aleasă
php unelte/tema.php https://site.ro --pune=client pune sau înlocuiește tema din teme/client.css + teme/client/
php unelte/tema.php https://site.ro --scoate=client scoate tema proprie de pe site
php unelte/instaleaza.php https://site.ro --tema=client la instalare: tema se pune imediat după verificarea serveruluiMerge cu cheia de cod, ca actualizarea codului: AI-ul (cheia de scriere, conectorul din claude.ai) nu poate pune CSS pe site. După ce tema e pe server, AI-ul o vede în
despre_site(teme.proprii) și o alege cuseteaza_site.Tema se pune întreagă. Ce era pe server și lipsește din versiunea nouă iese. Versiunea înlocuită sau scoasă se păstrează întâi în
date/versiuni/teme/<nume>/<data>/.Sincronizarea cu depozitul nu atinge temele proprii, nici dacă depozitul capătă cândva o temă cu același nume: registrul lor stă în
date/teme-proprii.json, iardate/nu vine niciodată din depozit. Invers, o temă de bază nu poate fi înlocuită cu una proprie: tema clientului primește alt nume.Ce intră într-o temă:
.css,.woff2,.woff,.ttf,.otf,.png,.jpg,.gif,.webp,.avif; cel mult 80 de fișiere, 2 MB fiecare, 6 MB în total. Nu intră SVG (deschis direct, ar rula script pe domeniul site-ului) și nici fișiere ascunse;Thumbs.dbșidesktop.inise sar singure.Unealta verifică adresele din foaie: un font care lipsește, sau care vine din dosarul altei teme (o temă făcută din copia uneia de bază, redenumită doar pe jumătate), e semnalat înainte de trimitere.
Fonturile se țin în cache un an. Când schimbi un font, dă-i fișierului alt nume. Foaia de stil se reîncarcă singură.
Copia de siguranță (
copie.php) ține doar numele temei. Pusă pe alt site care nu are tema, copia pune restul identității și îți spune comanda cu care urci tema.
Blocurile comune și paginile de pornire
Un site nou nu mai pornește gol. Pentru asta există două piese, amândouă conținut, nu cod pus de AI:
Blocurile comune, în
assets/stil.css, deci pe orice site și sub orice temă:bloc-carduri(cubloc-card),bloc-pasi(pași numerotați),bloc-citat(cucite),bloc-actiune(chemarea de la final, cua.buton),bloc-coloane,bloc-galerie,bloc-nota(plusnota-verde,nota-galbena,nota-rosie) șibloc-cifre. Întrebările frecvente rămânh2+h3+ răspuns, direct în conținut, fără cutie: altfelFAQPagenu le mai găsește. AI-ul le vede îndespre_site(blocuri), fiecare cu rostul lui și un exemplu de HTML. Testele verifică exemplele: fiecare trece prin filtru neatins și fiecare clasă are reguli în foaia de bază. Regulile au prefixulmain .continut, ca să stea deasupra regulilor generale ale unei teme; o temă le restilizează cu același prefix.Paginile de pornire: comanda
pagini_de_pornire(cheia de citire ajunge) întoarce scheletele paginilor acasă, despre, servicii, contact și confidențialitate, făcute din blocuri, cu locuri[[COMPLETEAZĂ: …]], plus întrebările de pus omului. Nu creează nimic. AI-ul le completează cu ce află de la om, le salvează ca ciorne, trimite linkul de previzualizare, iar omul aprobă. Răspunsul arată și care pagini există deja, ca să nu fie suprascrise.Un loc de completat oprește publicarea:
publicarefuză un element care mai are[[COMPLETEAZĂ…]]în titlu, descriere sau conținut, iarsalveazarefuză să-l pună pe o pagină deja publicată. Un schelet uitat nu ajunge pe site.Pagina de confidențialitate descrie ce face tehnic site-ul, verificat în cod: nu pune cookie-uri proprii, nu are formulare, nu păstrează căutările, fonturile și imaginile vin de pe site, iar jurnalul lui scrie doar administrarea și încercările de a intra în ea, nu vizitele. Ce e pornit la momentul cererii intră singur: Cloudflare, GA4 (încărcat doar după acordul din banner, din 0.23) și videoclipurile YouTube/Vimeo din pagini. Datele firmei și ale găzduirii rămân locuri de completat. Nu e consultanță juridică: proprietarul o verifică înainte de publicare.
Actualizarea codului, fără zip și fără cPanel
Din 0.9, site-ul își ia singur versiunea nouă din depozit — dar numai când i-o ceri tu, niciodată de la sine și niciodată la cererea AI-ului. Prima instalare rămâne cu pachetul urcat de mână; de la ea încolo:
php unelte/actualizeaza.php https://site.roComanda întreabă serverul ce versiune are și ce e în depozit, îți arată fișierele care s-ar schimba, apoi (după ce
confirmi, sau direct cu --acum) îi cere să se sincronizeze. Același lucru se poate face și din browser, pe
https://site.ro/actualizare.php, lipind cheia de cod în formular.
Cheia de cod e a treia cheie, alături de cea de citire și cea de scriere. Stă doar pe calculatorul tău, în
chei-<nume>.json, iar pe server e tot o amprentă. Nu e cheie de MCP: AI-ul nu o primește niciodată, iar un token
OAuth al conectorului din claude.ai nu deschide nimic din actualizare. Principiul rămâne cel de la început — asistentul
schimbă conținutul, nu codul.
Ce face serverul, în ordine, într-o singură cerere:
descarcă pachetul depozitului (
depozitdinconfig.php, implicitpaycodero/mini-cms-mcp, ramuramain);verifică fiecare cale din el: doar din dosarul
site/, fără.., doar extensii din lista permisă;app/config.php,date/șimedia/nu se ating niciodată;refuză o versiune mai veche decât cea instalată (
fortao acceptă, dacă chiar vrei să cobori);salvează fișierele pe care urmează să le înlocuiască, în
date/versiuni/cod/<data>/;scrie doar ce diferă;
își cere singur prima pagină: dacă nu mai răspunde 200, pune la loc versiunea veche în aceeași cerere și îți spune ce a pățit. Dacă nu poate ajunge la el însuși (unele găzduiri nu permit), spune „necunoscut" și nu presupune nimic — verificarea din afară o face comanda de pe calculatorul tău, care pune și ea înapoi copia dacă site-ul nu răspunde cum trebuie.
Două lecții de pe o găzduire reală (cinesunt.info, 21 septembrie 2026), reparate în 0.12:
Memoria PHP a găzduirii (OPcache). Unele găzduiri țin codul compilat și nu se uită după fișierul schimbat: pe disc e versiunea nouă, dar site-ul rulează tot codul vechi și raportează versiunea veche. Acum serverul își golește memoria pentru fiecare fișier PHP pe care îl scrie. Iar comanda de pe calculator pune copia înapoi numai dacă site-ul nu mai răspunde; dacă merge dar raportează încă versiunea veche, așteaptă și reverifică, apoi spune ce vede, fără să atingă ceva.
Punerea înapoi a unei copii nu mai poate închide site-ul. Copiile făcute înainte de 0.12 conțineau paza dosarului de date (un
.htaccesscu „Require all denied”), iar punerea înapoi o scria peste.htaccess-ul site-ului: 403 pe orice adresă, fără cale de reparat din afară. Acum copiile nu mai au paza lor, iar punerea înapoi sare peste ea și la copiile vechi. Dacă ți s-a întâmplat pe o versiune mai veche: în cPanel urci din nousite/.htaccesspeste cel din rădăcină, apoi alegi din nou versiunea PHP în MultiPHP Manager.
Copiile rămân pe server: php unelte/actualizeaza.php https://site.ro --copii le listează, iar --pune=<copie> pune
una înapoi. 'actualizare' => false în config.php scoate cu totul pagina și comanda.
⚠️ Prețul acestei comodități, spus pe față: serverul are încredere în depozit. Cine ajunge la contul de GitHub poate
pune cod pe site. Ce se poate fără GitHub — cale în afara dosarului site/, extensie nepermisă, atingerea configurării,
coborârea versiunii — e refuzat de server. Dacă vrei și apărare împotriva unui depozit compromis, pasul următor e
semnarea pachetului cu o cheie privată de pe calculatorul tău; nu e construită.
Imaginile, fără base64 prin conversație
urca_imagine primea imaginea codată base64: bun pentru o siglă mică, prea scump și prea lent pentru o poză. O poză atașată
în chat nu ajută nici ea: ajunge la AI ca imagine de privit, nu ca fișier pe care să-l poată trimite mai departe. Drumurile:
Poza e la om (telefon, calculator, chat) — drumul obișnuit, din 0.13: AI-ul cheamă
link_urcareși îi dă omului un link semnat, valabil 30 de minute (5–120). Omul îl deschide, alege poza, apasă „Urcă”; nicio cheie, nimic de completat. Apoi AI-ul o găsește culisteaza_imaginiși o pune unde trebuie. Semnătura folosește cheia previzualizărilor într-un domeniu separat, deci un link de previzualizare nu merge ca link de urcare; un link falsificat se numără ca încercare eșuată.E deja pe internet:
urca_imaginecuurl(doar https, portul 443). Serverul o descarcă singur. Apărarea contra SSRF: numele se rezolvă o dată și toate adresele găsite trebuie să fie publice (nu 127.x, 10.x, 192.168.x, 169.254.x și celelalte rezervate; la IPv6 trec doar adresele globale,2000::/3, deci IPv4 ascuns în IPv6 e refuzat în orice formă ar fi scris:::ffff:127.0.0.1,::127.0.0.1,::a9fe:a9fe); conexiunea se face exact la adresa verificată, deci DNS-ul nu poate fi schimbat între verificare și descărcare; redirecționările, cel mult 3, trec fiecare prin aceleași verificări. Fără curl și fărăallow_url_fopen.'imagini_url' => falseînconfig.phpoprește drumul.E pe calculator (Claude Code):
php unelte/urca-imagine.php https://site.ro poza.jpg [alta.png …] [--latime=1600] [--original]Întoarce poza după orientarea din telefon, o micșorează la 1600 px pe latura mare și o rescrie, deci JPEG-ul pierde datele EXIF, inclusiv locația GPS. La final scrie adresele
/media/.... Are nevoie de GD; pe Windows, dacăphp_gd.dllstă lângă PHP dar e oprit înphp.ini, comanda îl pornește doar pentru ea. Fără GD, pozele pleacă neatinse.Fără AI:
https://site.ro/imagini.php, cu cheia de scriere în formular (niciodată în adresă, ca la jurnal). Pagina micșorează pozele în browser înainte de trimitere, deci pleacă repede și fără locația GPS; cheia de citire e refuzată, fiecare fișier e verificat și scris în jurnal, pagina nu se indexează. Apoi îi dai AI-ului adresa. Se scoate cu'pagina_imagini' => false.
Toate trei trec prin aceleași verificări ca base64: tipul aflat din conținut, cel mult 5 MB, fără cod ascuns, fără SVG.
Documentele PDF
urca_fisier pune pe site un document PDF (cel mult 25 MB) și întoarce adresa lui, /fisiere/<nume>.pdf, de pus într-un
link în conținut. Numele îl alege AI-ul (curățat: litere mici, cifre, cratime) și rămâne adresa documentului.
Nu stau în dosarul public, ca imaginile, ci în
date/fisiere/. Le servește PHP, cuContent-Type: application/pdf,nosniff,Content-Disposition: inlineși ETag. Un fișier urcat nu poate fi rulat de server oricum s-ar numi, antetele merg și fărămod_headers, actualizarea codului nu le atinge, iar copia de siguranță le ia odată cu conținutul.Tipul se află din conținut: începe cu
%PDF-și se încheie cu%%EOF. O imagine, un text redenumit sau un PDF tăiat sunt refuzate.De unde vine: din
url(https, aceeași apărare SSRF ca la imagini, 60 de secunde), așa că merg și documentele mari; dincontinut_base64încap cel mult ~6 MB, din cauza limitei de 8 MB pe cerere.Înlocuirea aceluiași nume cu alt conținut cere
inlocuieste=true. Adresa rămâne aceeași, deci linkurile din pagini nu se strică, iar versiunea veche se păstrează îndate/versiuni/fisiere/. Același conținut urcat din nou nu scrie nimic.sterge_fisierrefuză un document legat dintr-o pagină sau dintr-un articol, în afară de cazulforteaza=true.Documentul nu primește Content-Security-Policy, și asta e intenționat:
sandboxșiobject-src 'none'fac vizualizatorul PDF din Chrome să arate „blocat”. Protecția e tipul fix cunosniff: browserul nu-l tratează niciodată ca pagină a site-ului.Pe un site mutat de pe alt CMS, un PDF vechi pus de mână în dosarul public
/fisiere/are întâietate, fiindcă e fișier real. Un document nou cu același nume e refuzat, ca să nu stea ascuns în spatele celui vechi.
Site multilingv (RO + EN) — 0.20
Un site poate fi în mai multe limbi. Se pornește cu seteaza_site (limbi), o listă de coduri unde prima e limba
implicită și stă la rădăcină (/), iar celelalte primesc un prefix de adresă (/en/...). O singură limbă sau lista goală
= site monolingv, exact ca înainte — funcția e aditivă, nimic nu se schimbă pe site-urile cu o singură limbă.
Fiecare pagină și articol are un câmp
limba(una dintrelimbi; lipsa lui = limba implicită) și un câmpgrup, care leagă un element de traducerile lui:despre(ro) șiabout(en) primesc acelașigrup, iar site-ul știe astfel că sunt aceeași pagină în limbi diferite. Se pun lasalveaza.O singură adresă canonică pe limbă: pagina în engleză se vede la
/en/<slug>și nu la rădăcină; cea în română la/<slug>. Prima pagină a fiecărei limbi stă la/și/en(slugul ei redirecționează acolo).Comutatorul de limbă apare în antet și duce la traducerea paginii curente (sau la prima pagină a limbii, dacă nu are una).
hreflang peste tot:
<link rel="alternate" hreflang="…">+x-defaultîn<head>, șixhtml:linkîn sitemap — așa Google și asistenții AI știu că paginile sunt aceeași, în limbi diferite.<html lang>, JSON-LDinLanguage, feed-ul și llms.txt urmează limba paginii.Identitatea tradusă:
seteaza_site(traduceri) dă, per limbă, variantele denume,descriere,subsolșinume_articole. Ce lipsește într-o limbă cade pe valoarea de bază. ex.{"en":{"nume":"The New Journal…"}}.
Site demo, care se resetează singur (0.26)
Pentru un site pe care îl încearcă oameni din afară (de exemplu verificatorii directorului de conectori Claude):
'demo' => ['resetare' => '03:00'] în config.php. Setarea nu se poate schimba prin MCP.
php unelte/demo.php https://demo.site.ro starea
php unelte/demo.php https://demo.site.ro --instantaneu conținutul de acum devine starea curată
php unelte/demo.php https://demo.site.ro --reseteaza pune la loc instantaneul acumÎn fiecare zi, prima cerere de după ora aleasă pune la loc instantaneul: paginile, articolele, documentele, imaginile, redirecționările, identitatea site-ului și versiunile lor. Nu e nevoie de sarcini programate pe server.
Nu se resetează: jurnalul (rămâne urma a ce au făcut vizitatorii), cheile și editorii, conexiunile OAuth (cine e în mijlocul unui test nu își pierde conectorul), citirile AI, copiile de cod și temele proprii.
Site-ul demo nu se indexează (noindex,
robots.txtînchis), nu anunță IndexNow, nu măsoară cu GA4 și arată sus o bandă „Site demo” cu ora resetării.
Copia de siguranță
php unelte/copie.php https://site.roSalvează tot site-ul în _copii/<nume>/<data>/ (în folderul de deasupra repo-ului): export.json cu paginile și articolele
(inclusiv ciornele și cele programate), identitatea și redirecționările, plus imaginile și documentele PDF, verificate după amprentă. Folosește
cheia de citire. Nicio copie nu se scrie peste alta.
php unelte/copie.php https://site-nou.ro --pune=_copii/<nume>/<data>Pune copia pe un site (de obicei unul nou, gol), cu cheia de scriere: imaginile cu aceleași adrese, apoi identitatea,
elementele cu starea, data publicării și autorul lor, și redirecționările. Pe un site care are deja conținut cere și
--peste; elementele cu același slug se modifică, cu versiunea anterioară păstrată.
Schimbarea cheilor
Dacă o cheie a scăpat: php unelte/instaleaza.php https://site --chei-noi. Cheile vechi se păstrează cu data în nume,
config-ul și pachetul se refac. Urci pe server doar app/config.php din _livrare/<nume>/ (sau tot pachetul): din acel
moment cheile vechi nu mai merg. Apoi --verifica, care înlocuiește și cheia din conexiunea Claude Code.
Editorii: clientul scrie cu cheia lui (0.19)
Când clientul vrea să modifice singur site-ul, primește cheia lui, nu pe a ta. Poate tot ce poate cheia de scriere —
creează, modifică, publică direct, retrage, șterge (reversibil), restaurează, urcă imagini și PDF-uri, redirecționează —
afară de două lucruri, care rămân la tine: identitatea site-ului (seteaza_site: nume, logo, temă, subsol, mențiunea
realizatorului) și conexiunile OAuth (retrage_conexiune). Comenzile acestea nici nu apar în lista lui.
php unelte/editor.php https://site.ro editorii de pe site
php unelte/editor.php https://site.ro --adauga="Maria Popescu" cheie nouă pentru Maria, pusă pe site
php unelte/editor.php https://site.ro --scoate="Maria Popescu" cheia ei nu mai merge, nici conexiunile ei OAuthCheia se scrie în
chei-<nume>-editor-<om>.json, lângă cheile tale, cu adresa MCP și comandaclaude mcp addgata de copiat: fișierul acela i-l dai omului. Pe server ajunge doar amprenta, îndate/securitate/editori.json.Merge cu cheia de cod, ca temele: AI-ul nu își poate face singur chei. Nu se urcă nimic în cPanel.
Cine, ce, când: fiecare rând din jurnal are
cine(adminsau numele editorului), inclusiv refuzurile; fiecare pagină și articol ținemodificat_de, care trece în versiuni —listeaza_versiuniarată cine a scris fiecare versiune. Pozele urcate cu un link de urcare apar pe numele celui care a cerut linkul (semnat, nu se poate schimba).Pe claude.ai (web, aplicația pentru calculator, telefon): își ia singur codul de conectare de pe
https://site/oauth/conectare, cu cheia lui, apoi aprobă tot cu ea. Tokenul rămâne al lui; când îl scoți, moare odată cu cheia. În Claude Code se leagă direct cu cheia în antet (comanda e în fișierul lui), fără cod.
Conectorul din claude.ai (web și telefon)
Legarea se face într-o fereastră deschisă de tine, de pe calculator (din 0.6 — înainte, oricine putea porni o aprobare pe site-ul tău, cu numele „Claude", și dacă o aprobai primea el token-urile):
php unelte/instaleaza.php https://site.ro --oauthComanda cere serverului, cu cheia de scriere, să deschidă înregistrarea 15 minute și îți arată în terminal un cod de conectare
de 6 cifre. Fără terminal (0.19.1): pagina https://site/oauth/conectare face același lucru, după ce lipești cheia de scriere
sau o cheie de editor; codul apare pe pagină. Apoi, în claude.ai: Settings → Connectors → Add custom connector, cu adresa https://site/mcp. Claude se
înregistrează singur și deschide pagina de aprobare a site-ului: acolo introduci codul din terminal și cheia de scriere
(sau pe cea de citire, pentru acces doar de citire) și apeși Permite. După aprobare fereastra se închide singură; o închizi mai
devreme cu --oauth --inchide. De acolo, Claude primește token-uri temporare; conectorul apare și în aplicația de telefon.
Reînnoirea token-urilor merge oricând, și cu fereastra închisă: o conexiune aprobată nu se rupe.
În afara ferestrei,
/oauth/inregistrareși pagina de aprobare răspund „închis": un link de aprobare trimis de un străin nu deschide nimic. Codul de 6 cifre e singurul lucru pe care nu-l poate avea cineva care îți citește codul sursă.'oauth' => 'deschis'înconfig.phpreaduce purtarea din 0.5 (fără fereastră, fără cod), iarfalsescoate OAuth cu totul.OAuth 2.1 cu PKCE (S256) obligatoriu, înregistrare automată a clientului (RFC 7591), descoperire prin
/.well-known/oauth-protected-resourceși/.well-known/oauth-authorization-server.Codul de aprobare poate fi trimis doar spre
claude.ai,claude.comsau calculatorul omului (localhost, pentru Claude Code); alte gazde se adaugă înconfig.php, la'oauth_gazde'.Token de acces 1 oră, de reînnoire 60 de zile, rotit la fiecare folosire. Pe server stau doar amprentele lor.
Un token are drepturile cheii cu care a fost aprobat și nu mai merge după
--chei-noi. Accesul se vede culisteaza_conexiuniși se retrage curetrage_conexiune. Fiecare pas e în jurnal, fără token-uri sau coduri.
Legarea de mână la Claude Code
instaleaza.php o face singur. De mână, cu cheia citită din fișier (PowerShell), din folderul proiectului:
$k = (Get-Content chei-<nume>.json -Raw | ConvertFrom-Json).scriere.cheie
claude mcp add --transport http <nume> https://site/mcp --header "Authorization: Bearer $k"Dacă găzduirea nu transmite antetul Authorization către PHP, se folosește --header "X-API-Key: $k"
(instaleaza.php detectează singur cazul). Cheia de citire se folosește pentru un asistent care doar verifică.
Conectorul din claude.ai (web, telefon) cere OAuth, care e în lucru (vezi mai jos).
Comenzile
Comanda | Cheie | Ce face |
| citire | regulile site-ului, HTML-ul permis, blocurile comune, temele, rolul cheii |
| citire | scheletele paginilor unui site nou (acasă, despre, servicii, contact, confidențialitate), de completat cu omul; nu creează nimic |
| citire | paginile și articolele, fără conținut |
| citire | un element întreg |
| citire | caută în titluri, descrieri, conținut |
| citire | versiunile salvate automat ale unui element |
| citire | imaginile din |
| citire | ultimele intrări și verificarea lanțului |
| citire | site-ul se cere singur ca OAI-SearchBot, ChatGPT-User, GPTBot, Claude, Perplexity, Bing, Google: cine e oprit și de cine |
| citire | ce pagini au citit ChatGPT, Claude, Perplexity & co. și câți oameni au venit din ei (numărat pe server) |
| citire | link temporar (implicit 60 de minute) la care omul vede o ciornă exact ca pe site, înainte de publicare |
| citire | adresele vechi care trimit spre adrese noi |
| citire | tot conținutul, pentru copia de siguranță (vezi |
| citire | aplicațiile legate prin OAuth (conectorul claude.ai): cine, cu ce drepturi, dacă au acces acum |
| scriere | creează (ca ciornă) sau modifică o pagină ori un articol (pe un site multilingv: și |
| scriere | numele, descrierea, autorul, limba (și |
| scriere | pune pe site / scoate de pe site (rămâne ciornă); |
| scriere | anulează accesul unei aplicații legate prin OAuth |
| scriere | adresă veche → adresă nouă de pe site, 301 (doar când la adresa veche nu mai e nimic); |
| scriere | mută elementul între versiuni (reversibil) |
| scriere | aduce înapoi o versiune, ca ciornă |
| scriere | un link temporar la care omul urcă poze fără cheie; AI-ul le găsește apoi cu |
| scriere | JPEG/PNG/GIF/WebP, max 5 MB, din |
| scriere | mută imaginea între versiuni; refuză dacă e folosită |
| citire | documentele PDF din |
| scriere | un PDF, max 25 MB, din |
| scriere | mută documentul între versiuni; refuză dacă e legat din conținut |
Descrierile în engleză (0.25): pe un site a cărui limbă de bază nu e româna, tools/list și instrucțiunile de la
initialize vin în engleză (app/unelte_en.php, traducerea textului din app/unelte.php). Numele comenzilor, ale
parametrilor și răspunsurile rămân în română. Un test verifică la fiecare rulare că nicio descriere nu rămâne netradusă.
Paginile și articolele au adrese comune: /despre, /primul-articol. Pagina acasa e prima pagină.
Vizitatorii au căutare (/cauta?q=…, în antet): doar în ce e pe site, cu sau fără diacritice ("sedinta" găsește "ședința").
Articolele programate apar singure la ora lor: nu e nevoie de sarcini programate pe server.
SEO și citit de agenți
Site-ul e făcut ca să fie găsit de oameni prin Google și Bing, dar și citit de asistenți AI, fără nicio unealtă în plus.
Adrese generate singure:
/sitemap.xml(culastmod, coperțile ca imagini și paginile de etichetă),/feed.xml(RSS cu legătură spre el însuși, autor și etichete),/robots.txt(îi numește pe rând pe Googlebot, Bingbot, GPTBot, ClaudeBot, PerplexityBot și restul, și arată unde ellms.txt),/llms.txt(rezumatul site-ului pentru modele: adresă, limbă, autor, lista paginilor și a articolelor cu descriere, dată și etichete).Date structurate (JSON-LD):
Articlecu editor, limbă, etichete și pagina-părinte ·WebSitecuSearchAction(căutarea site-ului, pentru Google) ·BreadcrumbListpe fiecare pagină ·FAQPageconstruit singur dintr-o secțiune<h2>Întrebări frecvente</h2>cu<h3>întrebare + răspuns, dacă articolul are una.Cardurile sociale:
og:complet, cuog:locale, măsurile copertei, textul ei alternativ, data publicării și a modificării, etichetele. Titlul din bara browserului nu repetă numele site-ului când e deja în el.Verificarea în Search Console și Bing Webmaster Tools:
'verificari' => ['google-site-verification' => '…', 'msvalidate.01' => '…']înconfig.phppune etichetele meta cerute.IndexNow: la publicare, modificare sau retragere, adresa pleacă singură spre Bing (și Yandex, Seznam, Naver). Cheia stă în
date/securitate/și se servește lahttps://site/<cheie>.txt, fără niciun fișier pus în rădăcină. Se oprește cu'indexnow' => false. Google nu are un punct echivalent: acolo rămâne sitemap-ul.Citirile AI (0.21): GA4 nu vede când ChatGPT îți deschide pagina ca să răspundă cuiva — boții nu execută JavaScript. Site-ul numără pe server, pe zi, pe asistent și pe adresă:
ChatGPT-User& co. (asistentul a citit pagina pentru un om),OAI-SearchBot,PerplexityBot,bingbot(indexul din care se aleg sursele),GPTBot& co. (antrenare) și oamenii veniți din asistenți (Referer sauutm_source). Fără IP-uri, îndate/vizite-ai/AAAA-LL.json; se citește cuvizite_ai. Se oprește cu'vizite_ai' => false. Paginile servite din cache-ul Cloudflare nu ajung la server și nu se numără.Verificarea boților (0.22): robots.txt poate spune „Allow”, iar Cloudflare („Block AI bots”) sau firewallul găzduirii să-i oprească totuși.
verifica_boticere prima pagină și cel mai nou articol pe drumul public, ca browser și ca fiecare bot, și spune ce primește fiecare: aceeași pagină, 403 de la Cloudflare sau de la găzduire, provocarea „Just a moment”, altă pagină; plus dacă robots.txt ajunge la boți altfel decât îl scrie site-ul („Managed robots.txt”). Cererile de probă nu intră învizite_ai. Limită: proba pleacă de pe server cu numele botului, nu de la IP-ul lui — un „ok” e un semn bun, nu o garanție.Sfaturi de citabilitate (0.22):
previzualizeazașipublicaîntorcsfaturi_aicând textul e greu de citat de un asistent: lipsește descrierea, primul paragraf are peste 60 de cuvinte, secțiunea „Întrebări frecvente” nu devine FAQPage, un articol de peste 500 de cuvinte n-are niciun<h2>. Sunt sfaturi, nu reguli: publicarea nu se oprește.Măsurarea (GA4):
seteaza_site(ga4) primește DOAR identificatorul, ex.G-798XLP278H— eticheta o compune site-ul, cu nonce-ul paginii, iar sursele de care are nevoie intră singure în CSP. AI-ul poate porni măsurarea, dar nu poate pune JavaScript în pagină: identificatorul e validat cu un tipar, iar orice altceva e refuzat. Se încarcă numai pe paginile publice — jurnalul, actualizarea, căutarea, previzualizările și aprobările nu se măsoară.Consimțământul pentru măsurare (0.23): cu GA4 pornit, pagina nu încarcă nimic de la Google până când vizitatorul nu apasă „Accept” în bannerul de jos (
assets/consimtamant.js). „Refuz” are aceeași formă și aceeași greutate ca „Accept”. Alegerea stă în browser (localStorage), nu într-un cookie, și se schimbă din „Setări cookie”, în subsol; la refuz, cookie-urile_garămase de la un acord anterior se șterg. Bannerul trimite la/confidentialitate(în limba paginii, dacă are traducere), când pagina e publicată. Fără GA4, nu apare nici banner, nici script. Comutatorulga4_fara_acord(0.24):seteaza_sitecu"da"încarcă GA4 direct, fără banner, ca înainte de 0.23 — pentru un site al cărui proprietar a ales altfel (de exemplu, un client care își rezolvă acordul în alt mod). Implicit e"", adică bannerul. Consent Mode v2 (0.28):seteaza_sitecuga4_mod_acord="da"păstrează bannerul, dar încarcă eticheta GA4 de la început, cu stocarea refuzată (analytics_storage,ad_storage,ad_user_data,ad_personalization= denied). Înainte de acord, Google primește doar semnale anonime de vizită, fără cookie-uri, din care estimează vizitele pierdute; la „Accept" trece pe acordat, iar la „Refuz" rămâne refuzat, fără reîncărcarea paginii. Textul bannerului și pagina de confidențialitate spun singure ce se întâmplă. Implicit e""(nimic de la Google până la „Accept"). Unii juriști cer acord și pentru semnalele anonime: alegerea e a proprietarului.Rețeaua autorului:
seteaza_site(legaturi) pune celelalte site-uri și conturi în subsol, pe fiecare pagină, și aceleași adrese însameAsdin datele structurate — de acolo află Google și Bing că profilurile sunt ale aceleiași entități. Sunt conținut, nu configurare: rămân la locul lor când urci un pachet nou.Legăturile din rețea (0.27):
seteaza_site(retea) primește adresa https a unui index comun (JSON) al site-urilor aceluiași autor; la finalul articolelor și paginilor apare blocul „Pe același subiect, pe celelalte site-uri”. Indexul se citește pe server (îl văd și motoarele de căutare), cu o copie de 6 ore în date/. Implicit gol = fără bloc, fără nicio cerere în afară.Textul din subsol:
seteaza_site(subsol) pune o mențiune scurtă pe fiecare pagină și în llms.txt — ce nu oferă site-ul, sau firma și CUI-ul. Text simplu, fără HTML.Cine a făcut site-ul:
seteaza_site(realizare, ex. „Website realizat cu AI și miniCMS”, plusrealizare_url) pune mențiunea pe rândul cu ©, ca link dacă are adresă. Nu e o legătură a autorului: nu intră însameAs, nu arerel="me"și nu apare în llms.txt, ca Google să nu lege site-ul realizatorului de entitatea autorului.Cum se numesc articolele:
seteaza_site(nume_articole, ex.ghiduri) schimbă cuvântul din meniu, de pe prima pagină și din liste („Ultimele ghiduri", „Toate ghidurile"). Adresa rămâne/articole.Meniul pe două niveluri: o pagină cu
parinte(slugul unei pagini din meniu) stă în submeniul ei, în ordinea dinmeniu; adresa rămâne/<slug>. Submeniul se deschide la mouse și din tastatură, fără JavaScript; pe ecrane tactile, pagina-părinte își listează singură subpaginile („În această secțiune”), iar subpagina are un link înapoi și firimituri Acasă › Secțiune › Pagină. Un singur nivel de subpagini; o pagină care are subpagini nu se șterge până nu le muți.Data pe pagini: implicit nu apare (pe un site de documentație o dată lângă titlu face conținutul să pară vechi);
arata_data=dao pune pe articol și pe carduri, pentru un blog. În sitemap, feed și datele structurate e oricum.Evenimente: un articol care anunță un concert, un curs sau o lansare primește câmpul
eveniment(început, sfârșit, tip, loc, adresă, artiști, organizator, bilete, stare). Din el site-ul compune datele structurateEvent(sauMusicEvent,Festival…) pentru Google: conținutul nu poate avea<script>, deci JSON-LD scris de mână ar fi scos. Cardul arată ziua și ora evenimentului (și „amânat”/„anulat”), iar prima pagină pune întâi evenimentele care urmează, cel mai apropiat primul, apoi restul articolelor.Sub articol: „Citește mai departe" cu două articole, întâi cele cu aceeași primă etichetă. Coperta nu se repetă sus când aceeași imagine e deja în text. Blocurile
<pre>primesc un buton „Copiază", pus de șablon (cu nonce).Întrebările frecvente (
FAQPage) se opresc la primul<aside>sau<section>: un bloc de final pus după ele nu se mai lipește de ultimul răspuns.Iconița site-ului: o pui cu
seteaza_site(favicon), iar/apple-touch-icon.pngtrimite spre ea, pentru telefon. ⚠️ Adresa/favicon.icoe singura care nu se poate rezolva din cod pe un domeniu prin Cloudflare: e prinsă la margine și nu ajunge niciodată la PHP (verificat:/altceva.icoși/favicon.ICOajung,/favicon.iconu). Dacă o vrei și pe aceea, omul pune unfavicon.icoadevărat în rădăcina site-ului, o singură dată.Fără sărituri la încărcare: coperțile și miniaturile primesc
width/heightdin fișier, iar coperta articolului arefetchpriority="high"(e candidatul LCP).
Securitate
Nicio comandă nu scrie fișiere
.php, șabloane, configurare sau jurnal. Conținutul stă în JSON, îndate/.HTML-ul trece printr-o listă de etichete și atribute permise, la scriere și la afișare. Se scot
script,style, formulare, SVG, evenimenteleon*,javascript:, iframe-urile care nu sunt YouTube/Vimeo. Răspunsul spune AI-ului ce s-a scos. Unidnu poate lua numele variabilelor citite de eticheta GA4 (dataLayer,gtag,google…): în browser, un id devine și variabilă globală.Două chei (citire / scriere). Pe server stau doar amprentele SHA-256, comparate cu
hash_equals.8 încercări eșuate în 5 minute = adresă blocată 15 minute, pe toate punctele de intrare. La IPv6 se blochează prefixul /64, nu adresa exactă: cine are un bloc întreg nu trece prin plafon schimbând adresa la fiecare cerere.
Adresele care răspund fără cheie (fluxul OAuth) au și un plafon pe numărul de cereri, nu doar pe eșecuri.
Cererile din browser de pe alt site (antet
Originstrăin) sunt refuzate. Cererile peste 8 MB sunt refuzate înainte de a fi citite.Înainte de orice modificare se salvează o versiune. Ștergerea mută fișierul între versiuni.
Paginile publice au Content-Security-Policy cu nonce (fără
unsafe-inline),nosniff,X-Frame-Options: DENY.Imaginile: tipul se află din conținut; fișierele cu cod PHP ascuns și SVG-urile sunt refuzate.
Documentele PDF: tipul se află din conținut (
%PDF-…%%EOF); stau în afara rădăcinii web (date/fisiere/) și le servește PHP, caapplication/pdfcunosniff.Arhivele și copiile de siguranță (
.zip,.tar,.gz,.sql,.baketc.) nu se servesc: pachetul de instalare uitat pe server nu se poate descărca.IP-ul real din
CF-Connecting-IPe crezut doar când cererea vine chiar din rețeaua Cloudflare; altfel antetul e ignorat. Setarea se potrivește singură, cu sau fără Cloudflare ('cloudflare' => falseo oprește).HSTS pe orice răspuns servit prin https (
'hsts' => falseîl oprește).Linkurile de previzualizare sunt semnate (HMAC, cheie în
date/securitate/), expiră în cel mult 24 de ore, nu se indexează și sunt scrise în jurnal, inclusiv încercările cu semnătură greșită.Redirecționările duc doar spre adrese de pe același site; adresele site-ului (
/mcp,/app,/date, …) nu se pot redirecționa, iar buclele sunt refuzate. Excepție: sub/articole/site-ul nu servește nimic, deci acolo se pot scrie (adresele unui blog mutat). Fără ele,/articole/<slug>trimite singur, cu 301, spre/<slug>când articolul (sau pagina) există și se vede pe site.
Jurnalul
Fiecare apel (citire, scriere, încercare eșuată, blocare) e un rând JSON în date/jurnal/AAAA-LL.ndjson: când, IP, cheie, cine (admin sau numele editorului), comandă, țintă, rezultat, amprenta conținutului scris, durata. Fără rotație care să șteargă istoric.
Fiecare rând poartă amprenta rândului anterior (lanț SHA-256): un rând modificat, scos sau adăugat pe dinafară rupe lanțul, iar verificarea arată unde. AI-ul poate citi jurnalul, nu îl poate modifica.
Lanțul e tamper-evident, nu tamper-proof: prinde editarea sau ștergerea unui rând, dar cine are drept de scriere pe date/
poate recalcula tot lanțul și rescrie .lant. Pentru dovadă în fața cuiva din afară, copiază periodic amprenta de final în altă
parte. Adresele vizitatorilor care deschid linkuri de previzualizare se scriu trunchiate (ultimul octet la IPv4, prefixul /64 la
IPv6). La 16 MB, fișierul lunii se arhivează singur sub un nume care îi păstrează locul în lanț.
Teste
php teste/ruleaza.phpPornesc o copie a site-ului într-un dosar temporar, cu chei de unică folosință, pe serverul PHP încorporat, și verifică protocolul, cheile, conținutul, versiunile, imaginile, accesul la fișierele interne, antetele și jurnalul, inclusiv atacurile: cod PHP trimis ca conținut, imagini cu cod ascuns, ../ în adrese, lanț de jurnal modificat de mână.
nginx
.htaccess nu se aplică pe nginx. Echivalentul minim:
location ~ ^/(app|sabloane|date)(/|$) { deny all; }
location ~ /\.(?!well-known/) { deny all; }
location ~* \.(zip|tar|gz|tgz|7z|rar|sql|bak|old|orig|swp)$ { deny all; }
location ~* ^/media/.+\.(php[0-9]?|phtml|phar|pht|shtml|cgi|pl|py|sh)$ { deny all; }
location = /mcp { rewrite ^ /mcp.php last; }
location / { try_files $uri /index.php$is_args$args; }Limitări cunoscute
post_max_sizeal găzduirii limitează mărimea imaginilor urcate (base64 adaugă ~33%).Căutarea și listele citesc toate fișierele JSON la fiecare cerere: potrivit pentru zeci sau sute de elemente, nu pentru zeci de mii.
Licență
MIT — vezi LICENSE. Poți folosi, modifica și distribui codul, inclusiv comercial, cu condiția să păstrezi mențiunea de copyright.
Available Tools
26 toolscautaCaută în conținutARead-onlyIdempotent
Caută un text în titlul, descrierea și conținutul paginilor și articolelor (inclusiv ciorne). Întoarce și fragmentul găsit.
Inputs: text (required), tip.
citesteCitește o pagină sau un articolARead-onlyIdempotent
Tot elementul, cu conținutul HTML, exact cum e salvat.
Inputs: tip (required), slug (required).
citeste_jurnalCitește jurnalulARead-onlyIdempotent
Ultimele intrări din jurnal (cine, când, de unde, ce comandă, ce rezultat) și verificarea lanțului: "intact" = niciun rând modificat sau scos.
Inputs: ultimele, doar_probleme.
despre_siteDespre site și regulile luiARead-onlyIdempotent
Numele, descrierea și adresa site-ului, câte pagini și articole are, ce HTML e permis, cum se formează adresele și ce drepturi are cheia folosită. Cheam-o prima.
Inputs: no named parameters.
exportaExportă tot conținutulARead-onlyIdempotent
Tot conținutul, pentru o copie de siguranță: identitatea site-ului, paginile și articolele întregi (și ciornele), redirecționările și lista imaginilor, cu amprentele lor. Imaginile se descarcă separat, de la adresele lor.
Inputs: no named parameters.
link_urcareLink de urcare a pozelor, pentru omA
Un link temporar (implicit 30 de minute) la care omul urcă poze de pe telefon sau de pe calculator, fără cheie și fără nimic de completat: deschide linkul, alege poza, gata. Folosește-l ori de câte ori omul vrea să pună o poză pe site și poza e la el (în telefon, sau atașată în chat — o poză din chat NU o poți trimite tu mai departe). După ce spune că a urcat-o, cheamă listeaza_imagini (cele mai noi sunt primele) și folosește adresa /media/... unde trebuie.
Inputs: minute.
listeazaListează paginile și articoleleARead-onlyIdempotent
Lista paginilor și/sau articolelor, fără conținut: slug, titlu, stare (ciorna/publicat), adresă, date.
Inputs: tip, stare.
listeaza_conexiuniListează conexiunile aprobateARead-onlyIdempotent
Aplicațiile legate de site prin OAuth (ex. conectorul din claude.ai): nume, unde întorc, dacă au acces acum și cu ce drepturi. Legătura prin cheie în antet (Claude Code) nu apare aici.
Inputs: no named parameters.
listeaza_fisiereListează documenteleARead-onlyIdempotent
Documentele PDF urcate, cu adresele lor /fisiere/..., cele mai noi primele.
Inputs: no named parameters.
listeaza_imaginiListează imaginileARead-onlyIdempotent
Imaginile urcate în /media/, cele mai noi primele.
Inputs: no named parameters.
listeaza_redirectionariListează redirecționărileARead-onlyIdempotent
Adresele vechi care trimit (301) spre adrese noi de pe site.
Inputs: no named parameters.
listeaza_versiuniVersiunile unui elementARead-onlyIdempotent
Versiunile salvate automat înainte de fiecare modificare, publicare, retragere sau ștergere. Cele mai noi primele.
Inputs: tip (required), slug (required).
pagini_de_pornirePaginile de pornire ale unui site nouARead-onlyIdempotent
Scheletele paginilor acasă, despre, servicii, contact și confidențialitate, făcute din blocurile comune, cu locuri [[COMPLETEAZĂ: …]]. Nu creează nimic: le completezi cu ce afli de la om, le salvezi ca ciorne cu salveaza, apoi omul le aprobă. Pagina de confidențialitate descrie ce face tehnic acest site și ce e pornit acum pe el (GA4, Cloudflare, video).
Inputs: no named parameters.
previzualizeazaLink de previzualizareARead-only
Un link temporar la care omul vede o ciornă (sau un element programat) exact cum va arăta pe site, înainte de "publica". Linkul expiră după "minute" (implicit 60) și nu e indexat.
Inputs: tip (required), slug (required), minute.
publicaPublicăAIdempotent
Face elementul vizibil pe site. Publică doar după ce omul a aprobat conținutul (vezi previzualizeaza). Cu "la" în viitor, elementul e programat: apare singur la ora aceea.
Inputs: tip (required), slug (required), la.
redirectioneazaRedirecționează o adresă vecheAIdempotent
Trimite vizitatorii de la o adresă veche (ex. după schimbarea unui slug, sau de pe un site vechi mutat aici) spre una nouă, de pe acest site, cu 301. Se aplică doar când la adresa veche nu mai e nimic. Cu "la" gol, scoate redirecționarea.
Inputs: de (required), la (required).
restaureazaRestaurează o versiuneA
Aduce înapoi o versiune (și un element șters). Revine ca ciornă, ca să fie verificată înainte de publicare; versiunea curentă se păstrează.
Inputs: tip (required), slug (required), versiune (required).
retrageRetrage de pe siteAIdempotent
Trece elementul înapoi în ciornă: dispare de pe site, rămâne salvat.
Inputs: tip (required), slug (required).
retrage_conexiuneRetrage accesul unei conexiuniADestructive
Anulează accesul unei aplicații legate prin OAuth (client_id din listeaza_conexiuni): token-urile ei nu mai merg, iar ca să se lege din nou trebuie aprobată iar, cu cheia. Doar la cererea omului.
Inputs: client_id (required).
salveazaCreează sau modifică o pagină ori un articolAIdempotent
Creează elementul (ca ciornă) sau îl modifică. La modificare trimite doar câmpurile care se schimbă; restul rămân. Dacă elementul e publicat, modificarea apare imediat pe site. Versiunea anterioară se salvează automat. HTML-ul e filtrat; "curatari" din răspuns spune ce s-a scos.
Inputs: tip (required), slug (required), autor, meniu, +8 more.
seteaza_siteSetează numele și descrierea site-uluiAIdempotent
Schimbă identitatea site-ului: numele (antet, titluri, feed), descrierea (Google, feed, llms.txt), autorul implicit al articolelor, limba, culoarea de accent, tema (aspectul), legăturile și textul din subsol, mențiunea despre cine a făcut site-ul, cum se numesc articolele pe site și dacă li se vede data. Trimite doar câmpurile care se schimbă. Schimbarea apare imediat pe tot site-ul; valorile anterioare se păstrează ca versiune și apar în răspuns.
Inputs: ga4, logo, nume, tema, +11 more.
stergeȘterge (reversibil)ADestructive
Scoate elementul de pe site și din listă, mutându-l între versiuni. Se poate reface cu "restaureaza".
Inputs: tip (required), slug (required).
sterge_fisierȘterge un document (reversibil)ADestructive
Mută documentul între versiuni: adresa lui nu mai răspunde. Refuză dacă o pagină sau un articol are link spre el, afară de cazul forteaza=true.
Inputs: nume (required), forteaza.
sterge_imagineȘterge o imagine (reversibil)ADestructive
Mută imaginea între versiuni. Refuză dacă e folosită undeva, afară de cazul forteaza=true.
Inputs: nume (required), forteaza.
urca_fisierUrcă un document PDFAIdempotent
Urcă un document PDF (cel mult 25 MB) și întoarce adresa /fisiere/.pdf, de pus într-un link în conținut (ex. Descarcă raportul (PDF)). Numele îl dai tu și rămâne adresa documentului. Trimite FIE "url" (adresa https a unui PDF public: serverul îl descarcă singur, adresele interne sunt refuzate; așa merg și documentele mari), FIE "continut_base64" (cel mult ~6 MB). Doar PDF: conținutul se verifică, nu numele. Dacă numele există deja cu alt conținut, înlocuirea cere inlocuieste=true: adresa rămâne, versiunea veche se păstrează.
Inputs: url, nume, inlocuieste, continut_base64.
urca_imagineUrcă o imagineAIdempotent
Urcă o imagine JPEG/PNG/GIF/WebP (cel mult 5 MB) și întoarce adresa /media/... de folosit în conținut sau drept copertă. Trimite FIE "url" (adresa https a unei imagini publice: serverul o descarcă singur, adresele interne sunt refuzate), FIE "continut_base64" (doar pentru imagini mici). Când poza e la om (telefon, calculator, atașată în chat), nu o coda: cheamă link_urcare și dă-i omului linkul.
Inputs: url, nume, continut_base64.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 26 tools
Most tools are clearly separated by resource and action, and the descriptions are specific enough to guide an agent. The main risk is the delete/unpublish family (sterge, retrage, sterge_imagine, sterge_fisier), which can look similar at a glance but is differentiated in the descriptions.
All names are lowercase snake_case, which helps readability, but they mix conventions: many are bare verbs (listeaza, citeste, sterge), others are verb_noun (sterge_imagine, urca_fisier), and a few are noun phrases (despre_site, pagini_de_pornire, link_urcare). This is still understandable but not a consistent predictable pattern.
At 26 tools, the server sits above the 25+ threshold and is heavy even for a mini-CMS with media, files, redirects, and connection management. The number of choices increases the chance of mis-selection and would benefit from consolidation.
The set covers the full lifecycle for the main content resources: save, read, list, search, publish, retract, delete, restore, preview, versions, redirects, media, files, export, and connection management. There are no evident dead ends in the described domain.
Related MCP Connectors
A blog CMS that AI agents write into over MCP: Markdown drafts, versions, media, human approval.
WordPress MCP server: publish posts, AI images, SEO and full site management, self-hosted
Publish websites with a small backend (KV, SQLite, files). MCP for AI agents.
Build, edit, host, and publish websites from AI assistants. Setup: https://mcp.orivox.org/
Related MCP Servers
- AlicenseBqualityBmaintenanceLightweight content management system for websites, built for the AI era12935MIT
- AlicenseBqualityCmaintenanceOpen-source MCP server that turns any CMS backend into an AI-agent-ready content management system. It provides tools for content CRUD, idea management, and publication tracking, with safety features requiring human approval for publishing.52MIT
- AlicenseNot gradedqualityDmaintenanceAn MCP-native CMS that lets you create and edit content by chatting, with typed schemas and seamless publishing.4MIT
- AlicenseNot gradedqualityCmaintenanceMCP server for WordPress content management via REST API, supporting posts, pages, media, comments, and terms through natural language interfaces like Cursor, ChatGPT, Codex, and Claude.MIT