strapi-plugin-mcp-chat 0.7.1 → 0.7.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (2) hide show
  1. package/README.md +31 -0
  2. package/package.json +1 -1
package/README.md CHANGED
@@ -250,6 +250,37 @@ in place, not recreated) and reducing media/relations to ids.
250
250
 
251
251
  ## Frontend provisioning
252
252
 
253
+ ### Step-by-step (from the admin)
254
+
255
+ > Prerequisites: the plugin installed & enabled, `OPENAI_API_KEY` set, and Strapi
256
+ > running in **`develop`** (schema generation is dev-only). See [Install](#install).
257
+
258
+ 1. **Zip your frontend** and keep the folder at the top of the archive
259
+ (e.g. `frontend/…`). You can include a `strapi.manifest.json` at its root, or let
260
+ the plugin infer one from the code. Exclude `node_modules` (the plugin installs deps
261
+ when it runs the dev server).
262
+ 2. In the admin, open **MCP Chat** in the left menu → **Provision frontend**.
263
+ 3. **Upload the `.zip`** → click **Analyze project**. The plugin extracts it to a sibling
264
+ folder and proposes a `strapi.manifest.json` (existing one, or inferred from the code —
265
+ including data arrays inside components → collection types).
266
+ 4. **Review the manifest** (edit if you want) → click **Provision**.
267
+ 5. Strapi **restarts** and then, automatically: creates the content-types, **seeds** the
268
+ content, opens **public read**, wires the **preview** (admin CSP + `CLIENT_URL`), and
269
+ **wires the frontend to Strapi via live REST fetch**. Don't close the page — it polls
270
+ until done.
271
+ 6. Click the **🖼 Preview** button on the floating chat. The plugin boots your frontend's
272
+ dev server and shows it docked next to the admin — now reading content from Strapi.
273
+ Toggle **📝 Draft / 🌐 Live** to preview unpublished changes.
274
+ 7. Edit with the **chat** ("change the hero title to …") or in the Content Manager → the
275
+ preview reloads and reflects it. Drafts stay drafts until you publish (or turn on
276
+ Auto-publish).
277
+
278
+ > No `strapi.manifest.json` and no `OPENAI_API_KEY`? Provisioning still models the loose
279
+ > UI text as single-types and wires the preview, but it can't infer data collections or
280
+ > rewire components without the key. Add the key for the full "upload → live" flow.
281
+
282
+ ### Under the hood
283
+
253
284
  Bring a "blessed-stack" frontend (Next.js or TanStack Start) carrying a
254
285
  `strapi.manifest.json`. The plugin **never executes code from the upload** — it
255
286
  reads and validates the manifest (Zod) and, from it, provisions the backend:
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "strapi-plugin-mcp-chat",
3
- "version": "0.7.1",
3
+ "version": "0.7.2",
4
4
  "description": "AI chat inside the Strapi 5 admin that reads and edits your content (incl. components & dynamic zones) via MCP, with voice and a side-by-side live preview.",
5
5
  "keywords": [
6
6
  "strapi",