{"Status":true,"Message":"","Response":{"post":{"postuid":"a19f3448-66a3-41ce-a2e1-dcc001551152","tenantuid":"d8b744fc-2e70-4089-bb80-dd1d08f6c7b2","projectuid":"fc6490ac-7527-4f49-b06e-46f701280e85","title":"Add Claude as an MCP Connector","slug":"article/adding-helpguides-to-claude-as-an-mcp-connector","html":"\u003Cimg class=\u0022lazy-load\u0022 data-width=\u0022300\u0022 data-height=\u0022129\u0022 data-src=\u0022https://graffiti-auf7e6dwhxhcbwek.z03.azurefd.net/d8b744fc-2e70-4089-bb80-dd1d08f6c7b2/fc6490ac-7527-4f49-b06e-46f701280e85/ebce113f-f07b-4328-a2b2-1857dd934e01.png?v=611785691\u0022 style=\u0022\u0022 alt=\u0022Claude logo\u0022/\u003E\u003Cp\u003EHelpGuides natively supports \u003Ca href=\u0022/article/model-context-protocol\u0022\u003EModel Context Protocol (MCP)\u003C/a\u003E, which means you can connect your documentation directly to Claude as a custom connector. Once connected, Claude can search, retrieve, and reference your documentation in real time \u2014 without crawling or indexing.\u003C/p\u003E\u003Ch2 id=\u0022what_youll_need\u0022\u003EWhat you\u0027ll need\u003C/h2\u003E\u003Cul\u003E\u003Cli\u003EA HelpGuides project with \u003Cb\u003EEnable Model Context Protocol\u003C/b\u003E turned on\u003C/li\u003E\u003Cli\u003EYour project\u0027s MCP URL\u003C/li\u003E\u003Cli\u003EA Claude account. Custom connectors work on Free, Pro, Max, Team and Enterprise plans. Free plans are limited to one custom connector, so remove any other one before adding HelpGuides.\u003C/li\u003E\u003C/ul\u003E\u003Ch2 id=\u0022finding_your_mcp_url\u0022\u003EFinding your MCP URL\u003C/h2\u003E\u003Cp\u003EYour MCP URL is unique to your HelpGuides project. It\u0027s your site\u0027s domain followed by \u003Ccode\u003E/mcp\u003C/code\u003E:\u003C/p\u003E\u003Cdiv class=\u0022code_wrapper\u0022\u003E\u003Cdiv class=\u0022code\u0022 data-language=\u0022text\u0022\u003Ehttps://YOUR-DOMAIN/mcp\u003C/div\u003E\u003C/div\u003E\u003Cp\u003ETo copy your exact URL, open your project, click \u003Cb\u003EAI Settings\u003C/b\u003E and look on the \u003Cb\u003EModel Context Protocol\u003C/b\u003E tab. See \u003Ca href=\u0022/article/ai-settings\u0022\u003EAI Settings\u003C/a\u003E.\u003C/p\u003E\u003Ch2 id=\u0022add_a_custom_connector_to_claude\u0022\u003EAdd a custom connector to Claude\u003C/h2\u003E\u003Col\u003E\u003Cli\u003ESign in to \u003Ca href=\u0022https://claude.ai\u0022 target=\u0022_blank\u0022\u003Eclaude.ai\u003C/a\u003E.\u003C/li\u003E\u003Cli\u003EGo to \u003Cb\u003ECustomize\u003C/b\u003E, then \u003Cb\u003EConnectors\u003C/b\u003E.\u003C/li\u003E\u003Cli\u003EClick \u003Cb\u003E\u002B\u003C/b\u003E, then \u003Cb\u003EAdd custom connector\u003C/b\u003E.\u003C/li\u003E\u003C/ol\u003E\u003Cimg class=\u0022lazy-load\u0022 data-width=\u0022538\u0022 data-height=\u0022436\u0022 data-src=\u0022https://graffiti-auf7e6dwhxhcbwek.z03.azurefd.net/d8b744fc-2e70-4089-bb80-dd1d08f6c7b2/fc6490ac-7527-4f49-b06e-46f701280e85/120c5a98-4570-42a3-93a6-d0f36eae42a6.png?v=1047201253\u0022 style=\u0022\u0022 alt=\u0022The Add custom connector dialog in Claude with name and remote MCP server URL fields\u0022/\u003E\u003Col start=\u00224\u0022\u003E\u003Cli\u003EEnter a descriptive name (e.g. \u003Ci\u003EMy Documentation\u003C/i\u003E).\u003C/li\u003E\u003C/ol\u003E\u003Ccite class=\u0022recommended\u0022\u003E\u003Cspan class=\u0022title\u0022\u003ERecommended\u003C/span\u003E\u003Cp\u003EFor example, if your project is called \u0022ACME Documentation\u0022 name the connector \u0022ACME Documentation\u0022. This is especially useful if you have more than one project connected to Claude.\u003C/p\u003E\u003C/cite\u003E\u003Col start=\u00225\u0022\u003E\u003Cli\u003EPaste your MCP URL into the remote MCP server URL field.\u003C/li\u003E\u003Cli\u003EClick \u003Cb\u003EAdd\u003C/b\u003E.\u003C/li\u003E\u003Cli\u003EClick \u003Cb\u003EConnect\u003C/b\u003E next to your new connector. Sign in to HelpGuides if asked, then click \u003Cb\u003EApprove\u003C/b\u003E to give Claude access.\u003C/li\u003E\u003C/ol\u003E\u003Cimg class=\u0022lazy-load\u0022 data-width=\u0022487\u0022 data-height=\u0022385\u0022 data-src=\u0022https://graffiti-auf7e6dwhxhcbwek.z03.azurefd.net/d8b744fc-2e70-4089-bb80-dd1d08f6c7b2/fc6490ac-7527-4f49-b06e-46f701280e85/b4a08fa4-b16d-4d35-831c-17692fca7042.png?v=1236615068\u0022 style=\u0022\u0022 alt=\u0022The HelpGuides custom connector in Claude\u0027s connector settings\u0022/\u003E\u003Cp\u003EOnce connected, Claude can query your documentation directly from any conversation.\u003C/p\u003E\u003Cp\u003E\u003Cb\u003ETeam and Enterprise plans:\u003C/b\u003E An owner adds the connector for the organization first. In \u003Cb\u003EOrganization settings\u003C/b\u003E, then \u003Cb\u003EConnectors\u003C/b\u003E, they click \u003Cb\u003EAdd\u003C/b\u003E, hover over \u003Cb\u003ECustom\u003C/b\u003E, select \u003Cb\u003EWeb\u003C/b\u003E, enter the MCP URL and click \u003Cb\u003EAdd\u003C/b\u003E. Each member then finds it in \u003Cb\u003ECustomize\u003C/b\u003E, then \u003Cb\u003EConnectors\u003C/b\u003E, and clicks \u003Cb\u003EConnect\u003C/b\u003E.\u003C/p\u003E\u003Ch2 id=\u0022adding_helpguides_to_claude_code\u0022\u003EAdding HelpGuides to Claude Code\u003C/h2\u003E\u003Cp\u003EIf you use \u003Ca href=\u0022https://claude.ai/code\u0022 target=\u0022_blank\u0022\u003EClaude Code\u003C/a\u003E, MCP servers are configured via the CLI rather than the connector UI. Run the following command in your terminal:\u003C/p\u003E\u003Cdiv class=\u0022code_wrapper\u0022\u003E\u003Cdiv class=\u0022code\u0022 data-language=\u0022sh\u0022\u003Eclaude mcp add --transport http helpguides https://YOUR-DOMAIN/mcp\u003C/div\u003E\u003C/div\u003E\u003Cp\u003EThen open a Claude Code session and run \u003Ccode\u003E/mcp\u003C/code\u003E to trigger the OAuth authentication flow. Once authenticated, your HelpGuides documentation tools will be available in all Claude Code sessions.\u003C/p\u003E\u003Cp\u003ETo verify the server was added successfully:\u003C/p\u003E\u003Cdiv class=\u0022code_wrapper\u0022\u003E\u003Cdiv class=\u0022code\u0022 data-language=\u0022sh\u0022\u003Eclaude mcp list\u003C/div\u003E\u003C/div\u003E\u003Cp\u003EBy default, the server is only available in the current project directory. Add \u003Ccode\u003E--scope user\u003C/code\u003E to make it available in all your projects:\u003C/p\u003E\u003Cdiv class=\u0022code_wrapper\u0022\u003E\u003Cdiv class=\u0022code\u0022 data-language=\u0022sh\u0022\u003Eclaude mcp add --transport http --scope user helpguides https://YOUR-DOMAIN/mcp\u003C/div\u003E\u003C/div\u003E\u003Ch2 id=\u0022adding_helpguides_to_claude_desktop\u0022\u003EAdding HelpGuides to Claude Desktop\u003C/h2\u003E\u003Cp\u003EClaude Desktop uses the connectors on your Claude account. Add HelpGuides as a custom connector using the steps above and it\u0027s available in Claude Desktop too, with nothing else to configure.\u003C/p\u003E\u003Cp\u003EThe \u003Ccode\u003Eclaude_desktop_config.json\u003C/code\u003E file is for local MCP servers, and Claude Desktop won\u0027t connect to a remote URL placed in it directly. If you do need to configure HelpGuides in the file, run it through the \u003Ccode\u003Emcp-remote\u003C/code\u003E bridge, which needs Node.js and signs you in with OAuth on first use:\u003C/p\u003E\u003Cdiv class=\u0022code_wrapper\u0022\u003E\u003Cdiv class=\u0022code\u0022 data-language=\u0022json\u0022\u003E{\n  \u0026quot;mcpServers\u0026quot;: {\n    \u0026quot;helpguides\u0026quot;: {\n      \u0026quot;command\u0026quot;: \u0026quot;npx\u0026quot;,\n      \u0026quot;args\u0026quot;: [\u0026quot;-y\u0026quot;, \u0026quot;mcp-remote\u0026quot;, \u0026quot;https://YOUR-DOMAIN/mcp\u0026quot;]\n    }\n  }\n}\u003C/div\u003E\u003C/div\u003E\u003Cp\u003EThe config file is located at:\u003C/p\u003E\u003Cul\u003E\u003Cli\u003E\u003Cb\u003EmacOS:\u003C/b\u003E \u003Ccode\u003E~/Library/Application Support/Claude/claude_desktop_config.json\u003C/code\u003E\u003C/li\u003E\u003Cli\u003E\u003Cb\u003EWindows:\u003C/b\u003E \u003Ccode\u003E%APPDATA%\\Claude\\claude_desktop_config.json\u003C/code\u003E\u003C/li\u003E\u003C/ul\u003E\u003Cp\u003ESave the file and restart Claude Desktop.\u003C/p\u003E\u003Ch2 id=\u0022enabling_the_connector_in_a_conversation\u0022\u003EEnabling the connector in a conversation\u003C/h2\u003E\u003Col\u003E\u003Cli\u003EOpen a new conversation in Claude\u003C/li\u003E\u003Cli\u003EClick the \u003Cb\u003E\u002B\u003C/b\u003E button in the lower-left of the chat interface\u003C/li\u003E\u003Cli\u003EHover over \u003Cb\u003EConnectors\u003C/b\u003E\u003C/li\u003E\u003Cli\u003EToggle on your HelpGuides connector\u003C/li\u003E\u003C/ol\u003E\u003Cp\u003EClaude will now have access to your documentation for the duration of that conversation.\u003C/p\u003E\u003Ch2 id=\u0022what_claude_can_do_with_your_documentation\u0022\u003EWhat Claude can do with your documentation\u003C/h2\u003E\u003Cp\u003EOnce connected, Claude can use every \u003Ca href=\u0022/model-context-protocol-endpoints\u0022\u003EMCP tool\u003C/a\u003E your HelpGuides project exposes, including:\u003C/p\u003E\u003Cul\u003E\u003Cli\u003E\u003Cb\u003Esearch\u003C/b\u003E and \u003Cb\u003Eget_article\u003C/b\u003E: find and read your articles\u003C/li\u003E\u003Cli\u003E\u003Cb\u003Ecreate_article\u003C/b\u003E: draft new articles\u003C/li\u003E\u003Cli\u003E\u003Cb\u003Eupdate_article\u003C/b\u003E and \u003Cb\u003Eupdate_article_blocks\u003C/b\u003E: edit articles, saved as a working copy for you to review\u003C/li\u003E\u003Cli\u003E\u003Cb\u003Epublish_article\u003C/b\u003E: publish or schedule an article\u003C/li\u003E\u003Cli\u003E\u003Cb\u003Eget_categories\u003C/b\u003E, \u003Cb\u003Eset_category\u003C/b\u003E, \u003Cb\u003Ecreate_category\u003C/b\u003E and \u003Cb\u003Eupdate_category\u003C/b\u003E: organize articles\u003C/li\u003E\u003Cli\u003E\u003Cb\u003Ecreate_image_upload\u003C/b\u003E, \u003Cb\u003Efinish_image_upload\u003C/b\u003E and \u003Cb\u003Eadd_image_to_article\u003C/b\u003E: add screenshots and other images\u003C/li\u003E\u003Cli\u003E\u003Cb\u003Ebuild_links\u003C/b\u003E: link related published articles to an article\u003C/li\u003E\u003Cli\u003E\u003Cb\u003Elist_agent_comments\u003C/b\u003E, \u003Cb\u003Eget_comments\u003C/b\u003E and \u003Cb\u003Eresolve_comment\u003C/b\u003E: act on \u003Ca href=\u0022/article/review-comments-and-ai-agents\u0022\u003Ereview comments\u003C/a\u003E left in the editor\u003C/li\u003E\u003Cli\u003E\u003Cb\u003Eget_stale_articles\u003C/b\u003E: find articles that are due for review\u003C/li\u003E\u003C/ul\u003E\u003Cp\u003EThis lets you search for existing coverage, draft new articles and update content without leaving your conversation. For every tool and its parameters, see \u003Ca href=\u0022/model-context-protocol-endpoints\u0022\u003EModel Context Protocol Endpoints\u003C/a\u003E.\u003C/p\u003E\u003Ch2 id=\u0022try_these_prompts\u0022\u003ETry these prompts\u003C/h2\u003E\u003Cp\u003EOnce your connector is enabled, here are some prompts to get started:\u003C/p\u003E\u003Cul\u003E\u003Cli\u003E\u003Ci\u003E\u0022Search my documentation for articles about [topic]\u0022\u003C/i\u003E \u2014 find existing coverage before writing anything new\u003C/li\u003E\u003Cli\u003E\u003Ci\u003E\u0022Create a draft article about [topic] and link to related articles\u0022\u003C/i\u003E \u2014 generate a new article with internal links\u003C/li\u003E\u003Cli\u003E\u003Ci\u003E\u0022Review this article URL and suggest improvements\u0022\u003C/i\u003E \u2014 get feedback on existing content\u003C/li\u003E\u003Cli\u003E\u003Ci\u003E\u0022Update the article at [URL] to include [new information]\u0022\u003C/i\u003E \u2014 edit an article by passing its URL directly\u003C/li\u003E\u003C/ul\u003E\u003Cp\u003EClaude will search your docs, draft content, and push updates as drafts for your review \u2014 you always have the final say before anything is published.\u003C/p\u003E\u003Ch2 id=\u0022revoking_access\u0022\u003ERevoking access\u003C/h2\u003E\u003Cp\u003ETo disconnect HelpGuides from Claude at any time:\u003C/p\u003E\u003Cul\u003E\u003Cli\u003E\u003Cb\u003Eclaude.ai and Claude Desktop:\u003C/b\u003E Go to \u003Cb\u003ECustomize\u003C/b\u003E, then \u003Cb\u003EConnectors\u003C/b\u003E, open the menu next to your HelpGuides connector and remove it.\u003C/li\u003E\u003Cli\u003E\u003Cb\u003EClaude Code:\u003C/b\u003E Run \u003Ccode\u003Eclaude mcp remove helpguides\u003C/code\u003E in your terminal.\u003C/li\u003E\u003Cli\u003E\u003Cb\u003EClaude Desktop with mcp-remote:\u003C/b\u003E Remove the \u003Ccode\u003Ehelpguides\u003C/code\u003E entry from \u003Ccode\u003Eclaude_desktop_config.json\u003C/code\u003E and restart Claude Desktop.\u003C/li\u003E\u003C/ul\u003E\u003Cp\u003EYou can reconnect at any time by following the setup steps above. To cut off every AI assistant at once, turn off \u003Cb\u003EEnable Model Context Protocol\u003C/b\u003E in \u003Ca href=\u0022/article/ai-settings\u0022\u003EAI Settings\u003C/a\u003E.\u003C/p\u003E\u003Ch2 id=\u0022troubleshooting\u0022\u003ETroubleshooting\u003C/h2\u003E\u003Ch3 id=\u0022the_connector_shows_as_disconnected\u0022\u003EThe connector shows as disconnected\u003C/h3\u003E\u003Cp\u003ERe-authenticate by clicking \u003Cb\u003EConnect\u003C/b\u003E next to the connector in \u003Cb\u003ECustomize\u003C/b\u003E, then \u003Cb\u003EConnectors\u003C/b\u003E, or run \u003Ccode\u003E/mcp\u003C/code\u003E in Claude Code to start the OAuth flow again.\u003C/p\u003E\u003Ch3 id=\u0022the_connector_was_added_midsession_and_isnt_showing_tools\u0022\u003EThe connector was added mid-session and isn\u0027t showing tools\u003C/h3\u003E\u003Cp\u003EMCP connectors are loaded at session start. Start a new conversation and enable the connector from the \u003Cb\u003E\u002B\u003C/b\u003E menu.\u003C/p\u003E\u003Ch3 id=\u0022oauth_errors_during_authentication\u0022\u003EOAuth errors during authentication\u003C/h3\u003E\u003Cp\u003EMake sure \u003Cb\u003EEnable Model Context Protocol\u003C/b\u003E is on in \u003Ca href=\u0022/article/ai-settings\u0022\u003EAI Settings\u003C/a\u003E; when it\u0027s off, the MCP URL doesn\u0027t respond. Sign in to HelpGuides with an account that has access to the project, and click \u003Cb\u003EApprove\u003C/b\u003E. If Claude reports that the token isn\u0027t authorized for this project, you approved access with a different HelpGuides account: remove the connector and connect again with the right one. Contact support if the problem continues.\u003C/p\u003E\u003Cp\u003EFor more on how HelpGuides implements MCP, see \u003Ca href=\u0022/article/model-context-protocol\u0022\u003EModel Context Protocol\u003C/a\u003E and \u003Ca href=\u0022/article/using-llmstxt\u0022\u003EUsing LLMS.txt\u003C/a\u003E.\u003C/p\u003E","publish_status":0,"post_type":"Article","authoruid":"3dde8c16-763a-4a2b-ae0b-1d8c50c62e3d","author":{"authoruid":"3dde8c16-763a-4a2b-ae0b-1d8c50c62e3d"},"featured_image_updating":false,"meta_description":"Connect HelpGuides to Claude using Model Context Protocol (MCP) for real-time documentation search, workflow guidance, and AI-assisted article editing.","display_toc":true,"has_workingcopy":false,"allow_indexing":true,"total_views":159,"date_published":"2026-03-16T15:41:00","date_updated":"2026-10-04T21:48:12.737","date_created":"2026-03-16T15:29:09.283"}}}