When an AI tool, such as Claude connected through MCP, changes a published doc, PinkDocs can save the change as a suggested revision instead of publishing it. You review each suggestion and decide whether it goes live.
📷 Image placeholder: a doc in the editor with a notice that an AI-suggested change is waiting for review.
Choose how AI changes are handled
PinkDocs has two access modes for AI tools:
| Mode | Published docs | New docs | Best for |
|---|---|---|---|
| Drafts | Changes are saved as suggested revisions for review | Saved as drafts | Most teams. Nothing goes live without a person checking it. |
| Full access | Changes are published straight away | Can be published directly | Trusted workflows where you review changes in other ways |
Set the mode
Open the MCP settings
Go to PinkDocs → Settings and open the MCP tab.
Choose the access mode
Choose Drafts or Full access.
📷 Image placeholder: the access mode setting in PinkDocs MCP settings.
Save
Click Save Changes.
Find docs with suggestions
Docs with a suggestion waiting show a notice in the Docs list and at the top of the editor. Filter the Docs list to see every doc waiting for review.
Review a suggestion
Open the doc
Open the doc with a waiting suggestion in the block editor.
Compare the changes
Open the suggested revision to compare it with the live version. Changed text is highlighted.
📷 Image placeholder: the revision comparison screen showing removed and added text.
Accept or reject
To accept, restore the suggested revision and click Update. To reject, leave the live version as it is and discard the suggestion.
Make your own edits (optional)
After accepting, edit the doc further if needed, then click Update.
What to check in each suggestion
- Accuracy: settings, menu paths and steps match your product.
- Tone: the text matches the rest of your help centre.
- Links: every link goes to the right doc.
- Blocks: steps, alerts and FAQs display correctly.
Common questions
No. Changes to draft docs are saved directly, because drafts aren't visible to readers.
Any user who can edit and publish docs, such as Editors and Administrators.