How to create a knowledge-base article with MCP Hub in Blesta

Skip to main content
Print

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

  1. Give the assistant the approved title and complete body.
  2. Specify the exact existing categories and the required access setting.
  3. Explicitly authorise Add a knowledge base article for that content and destination.
  4. If the connection requires approval, review the pending operation before letting the assistant resume it.
  5. 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.

Table of Contents

Get your website online with PD Hosting

UK hosting, domains and support from a real team. From a first site to a full server.

Terms and Conditions  ·  Privacy Policy

PD Hosting is the trading name of Projektif Digital Ltd, registered in England and Wales, company number 12482555.

PD Hosting
Privacy Overview

This website uses cookies so that we can provide you with the best user experience possible. Cookie information is stored in your browser and performs functions such as recognising you when you return to our website and helping our team to understand which sections of the website you find most interesting and useful.