How to create a knowledge-base article with MCP Hub in Blesta
MCP Hub can create a KB article from an assistant’s approved copy, but the create operation is not automatically an unpublished draft. Decide the audience, category and finished body before authorising it.
Prepare the target and copy
Use a dedicated content connection with a Write ceiling, the required content area and staff permissions. The separate read-only override must permit the intended write. The company needs an active Support Manager plugin, and the bound active staff member’s group needs its Knowledge Base permission. A connection limited to selected clients cannot operate on the shared knowledge base.
Ask the assistant to list the categories and identify the intended category IDs. Search existing article titles and read likely matches before creating another page for the same task. Draft and review the title, full body, links and language separately from the instruction to publish.
State the audience explicitly
Choose access: private for signed-in clients, public for everyone or staff for staff-only material. Hidden is reachable by link and is not a staff-only draft. Keep the article’s audience explicit even when its category already has an access setting.
Confirm the active company and intended language. The create tool accepts HTML by default and also offers content_type: text for plain text. Use the format that matches the body; do not submit literal HTML tags as plain text and expect them to render as headings.
Create and read back
- Give the assistant the approved title and complete body.
- Specify the exact existing categories and the required access setting.
- Explicitly authorise Add a knowledge base article for that content and destination.
- If the connection requires approval, review the pending operation before letting the assistant resume it.
- Read the returned article ID with Read a knowledge base article.
Compare the saved title, full body, categories and access with what you authorised. Use ordinary headings, paragraphs, lists and links, then inspect the native article view for formatting and link behaviour. A saved HTML body is not proof that every rich embed or interactive element will render as intended.
Handle an uncertain result
If the create request times out or the assistant loses its result, search the category and matching title before trying again. A retry can create a duplicate. Verify the body and category of any returned ID instead of assuming it belongs to the intended request.
Keep the final ID and the publication or review location in your own content record. For a later revision, update that article rather than creating a replacement unless you intend a separate page.
See the PD MCP Hub Blesta guide for related tasks, or explore PD MCP Hub.