Table of Contents
Overview of HelpDocs MCP
HelpDocs MCP lets AI assistants search, read & draft articles in your Knowledge Base. Connect via URL, authorize, then ask your assistant to apply actions to your docs π
Table of Contents
The HelpDocs MCP (Model Context Protocol) server lets AI assistants like Claude & OpenAI connect directly to your Knowledge Base. Once connected, your assistant can search, read, and even draft articles for you, without leaving the comfort of your AI assistant's interface.
MCP Capabilities
After connecting, your AI assistant will be able to:
- Search your articles and categories
- Read the full content of any article
- Create, update, delete articles and categories (including drafts)
- Pull analytics and account details
Connecting to MCP
First, enable MCP in HelpDocs:
- Head to Settings > AI
- Ensure Enable AI Tools is checked
- Select MCP Access in the Choose features dropdown
- Hit Save Changes
The exact steps vary depending on which AI client you're using, but the setup process is similar across platforms. You'll need to provide your client with a name:
HelpDocs
and an MCP URL:
https://β’β’β’β’β’β’β’β’β’β’β’β’β’β’β’β’β’β’β’β’β’β’β’β’β’β’
Once added, we'll walk you through the steps to Authorize MCP usage.
Connecting Without a Browser
The authorization flow above needs someone to click Authorize in a browser. If your client runs headlessβa CI pipeline, a scheduled script, a self-hosted agentβthere's nobody there to do that.
In that case you can authenticate with an API key instead, using a key you create in Settings > API.
Confirming It Works
Once connected, ask your assistant something like "Search my HelpDocs articles for billing". If it returns a list of your articles, you're all set β
Not seeing any results? Try this π
- Double-check the URL is correct and hasn't been revoked by heading to Settings > API
- Make sure the host and path were entered exactly, with no trailing spaces
- Reconnect the client to refresh the authorization
That's it! Your AI assistant is now wired straight into your Knowledge Base π
What did you think of this doc?
Connect HelpDocs to ChatGPT
