{"Status":true,"Message":"","Response":{"post":{"postuid":"a19f3448-66a3-41ce-a2e1-dcc001551152","tenantuid":"d8b744fc-2e70-4089-bb80-dd1d08f6c7b2","projectuid":"fc6490ac-7527-4f49-b06e-46f701280e85","title":"Adding HelpGuides to Claude as an MCP Connector","slug":"article/adding-helpguides-to-claude-as-an-mcp-connector","html":"\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 published HelpGuides project with MCP enabled\u003C/li\u003E\u003Cli\u003EYour project\u0027s MCP URL (found in your project settings)\u003C/li\u003E\u003Cli\u003EA Claude account on a Pro, Max, Team, or Enterprise plan\u003C/li\u003E\u003Cli\u003ENote: Free plan users are limited to one custom connector. If you already have one connected, you will need to remove it 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 follows this format: \u003Ccode\u003Ehttps://[your-subdomain].helpguides.io/mcp\u003C/code\u003E\u003C/p\u003E\u003Cp\u003EYou can find your exact MCP URL in your project settings under the \u003Cb\u003EIntegrations\u003C/b\u003E section. See \u003Ca href=\u0022/article/model-context-protocol\u0022\u003EModel Context Protocol\u003C/a\u003E for a full reference of available endpoints and capabilities.\u003C/p\u003E\u003Ch2 id=\u0022adding_helpguides_to_claude_claudeai\u0022\u003EAdding HelpGuides to Claude (claude.ai)\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\u003EClick your username in the bottom-left corner and select \u003Cb\u003ESettings\u003C/b\u003E\u003C/li\u003E\u003Cli\u003EClick \u003Cb\u003EConnectors\u003C/b\u003E in the left sidebar\u003C/li\u003E\u003Cli\u003EScroll to the bottom and click \u003Cb\u003EAdd custom connector\u003C/b\u003E\u003C/li\u003E\u003C/ol\u003E\u003Cimg class=\u0022lazy-load\u0022 data-width=\u002260\u0022 data-height=\u002224\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=\u0022\u0022/\u003E\u003Col\u003E\u003Cli\u003EEnter a descriptive name (e.g. \u003Ci\u003EMy Documentation\u003C/i\u003E)\u003C/li\u003E\u003Cli\u003EPaste your MCP URL into the \u003Cb\u003ERemote MCP server URL\u003C/b\u003E 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 and complete the OAuth authentication flow\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=\u0022\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 org admin must first add the connector at the organization level under Organization Settings \u2192 Connectors before individual users can authenticate. Individual users follow the same steps above once the connector has been enabled org-wide.\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\u003Ccode\u003Eclaude mcp add --transport http helpguides https://[your-subdomain].helpguides.io/mcp\u003C/code\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\u003Ccode\u003Eclaude mcp list\u003C/code\u003E\u003Cp\u003EBy default, the server is scoped to the current project. Add \u003Ccode\u003E--scope user\u003C/code\u003E to make it available across all your projects.\u003C/p\u003E\u003Ch2 id=\u0022adding_helpguides_to_claude_desktop\u0022\u003EAdding HelpGuides to Claude Desktop\u003C/h2\u003E\u003Cp\u003EClaude Desktop uses a JSON configuration file to manage MCP servers. Add the following to your \u003Ccode\u003Eclaude_desktop_config.json\u003C/code\u003E file:\u003C/p\u003E\u003Ccode\u003E{\n  \u0022mcpServers\u0022: {\n    \u0022helpguides\u0022: {\n      \u0022command\u0022: \u0022npx\u0022,\n      \u0022args\u0022: [\u0022-y\u0022, \u0022mcp-remote\u0022, \u0022https://[your-subdomain].helpguides.io/mcp\u0022]\n    }\n  }\n}\u003C/code\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. Your HelpGuides connector will be available on next launch.\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 has access to the \u003Ca href=\u0022/article/model-context-protocol-endpoints\u0022\u003EMCP tools\u003C/a\u003E exposed by your HelpGuides project, which currently include:\u003C/p\u003E\u003Cul\u003E\u003Cli\u003E\u003Cb\u003Esearch\u003C/b\u003E \u2014 search your documentation by keyword or topic\u003C/li\u003E\u003Cli\u003E\u003Cb\u003Eget_instructions\u003C/b\u003E \u2014 retrieve workflow guidance for working with your docs\u003C/li\u003E\u003Cli\u003E\u003Cb\u003Ecreate_article\u003C/b\u003E \u2014 draft new articles directly from a conversation\u003C/li\u003E\u003Cli\u003E\u003Cb\u003Eupdate_article\u003C/b\u003E \u2014 edit existing articles by post ID or URL\u003C/li\u003E\u003C/ul\u003E\u003Cp\u003EThis enables AI-assisted documentation workflows \u2014 searching for existing coverage, drafting new articles, and updating content without leaving your conversation. For a full list of supported endpoints, see \u003Ca href=\u0022/article/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:\u003C/b\u003E Go to Settings \u2192 Connectors, click the three-dot menu next to your HelpGuides connector, and select \u003Cb\u003ERemove\u003C/b\u003E\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:\u003C/b\u003E Remove the helpguides entry from your \u003Ccode\u003Eclaude_desktop_config.json\u003C/code\u003E and restart Claude Desktop\u003C/li\u003E\u003C/ul\u003E\u003Cp\u003EThis immediately revokes Claude\u0027s access to your documentation. You can reconnect at any time by following the setup steps above.\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 Settings \u2192 Connectors, or run \u003Ccode\u003E/mcp\u003C/code\u003E in Claude Code to re-trigger the OAuth flow.\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\u003EEnsure your HelpGuides project has MCP and OAuth enabled in your project settings. Contact support if the issue persists.\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":75,"date_published":"2026-03-16T15:41:38.1","date_updated":"2026-03-16T15:54:12.013","date_created":"2026-03-16T15:29:09.283"}}}