Connect to the Authoring MCP Server

ClickHelp Authoring MCP Server lets you connect your portal to AI assistants so they can work with your documentation the same way a human would — reading, searching, creating, and editing content.

Before you begin, make sure you have your portal Authoring MCP Server endpoint URL. You can find it in your portal settings, AI integrations → MCP server.

Claude Desktop

Claude Desktop lets you add custom MCP connectors through Organization settings.

  1. Open Claude Desktop and go to Organization settings.
  2. Navigate to the Connectors section and click Add → Custom → Web.
  3. Enter your portal's Authoring MCP Server endpoint URL, define a name, and confirm.
  4. You can now ask Claude questions about your documentation directly in the chat.

Claude (Cloud)

Claude lets you add custom MCP connectors through Organization settings as well.

  1. In Claude (Cloud), open Organization settings and go to the Connectors section.
  2. Click Add custom connector and enter your portal's Authoring MCP Server endpoint URL.
  3. In the Connectors list, find the newly added connector and click Connect. Confirm the status shows as connected.
  4. You can now send natural language questions about your documentation in Claude — no special commands needed.

For full details, see Connect to remote MCP Servers - Model Context Protocol.

Gemini CLI

You can connect Gemini CLI to an MCP server using the gemini mcp add command.

  1. Open Gemini CLI.
  2. Run the following command:
    Copy Code
    Code
    gemini mcp add --transport http my-mcp-server https://us.mcp.clickhelp.com/portals/yourportal.clickhelp.co
    where:
    my-mcp-server is your custom server name,
    https://us.mcp.clickhelp.com/portals/yourportal.clickhelp.co is your Authoring MCP Server endpoint URL.
  3. ClickHelp tools will now be available during your sessions.

Alternatively, you can add the connection in the configuration file directly. For details, see the Gemini CLI MCP documentation.

Codex (OpenAI, ChatGPT)

You can configure both Codex Desktop and Codex CLI via config.toml file.

  1. Open ~/.codex/config.toml.
  2. Anywhere in the file, add the following section:
    Copy Code
    Code
    [mcp_servers.clickhelp]
url = "https://<region>.mcp.clickhelp.com/portals/<portalname>.clickhelp.co"
  3. Replace the placeholders:
    1. <region> with either eu, us or au, depending on the region of your server hosting.
    2. <portalname> with your actual portal name. 
  4. Save the file. 
  5. Relaunch the application or the CLI session.
  6. Authenticate in your ClickHelp portal:
    1. For CLI, enter codex mcp login clickhelp.
    2. For Codex Desktop, open Settings → MCP servers and click the Authenticate button.
  7. You can now work with your ClickHelp portal in Codex using natural language.

For full details, see the OpenAI Codex documentation.

Microsoft Copilot

Microsoft Copilot Studio supports MCP servers as tools for your agents.

  1. Open Copilot Studio.
  2. Go to the Tools page for your agent.
  3. Select Model Context Protocol.
  4. Click New tool and enter your portal's Authoring MCP Server endpoint URL.
  5. Your agent can now use ClickHelp documentation as a knowledge source.

For full details, see the Microsoft Copilot Studio documentation.