Connect to MCP Server

ClickHelp MCP Server lets you connect your portal documentation to AI assistants and query content using natural language. This page describes how to set up the connection in the most common AI tools.

Before you begin, make sure you have your portal 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 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 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 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.

ChatGPT (Codex)

OpenAI Codex CLI supports MCP servers via its config.toml file.

  1. Open ~/.codex/config.toml.
  2. Add your server with a [mcp_servers.<server-name>] table, specifying your endpoint URL as url.
  3. Save the file. The server will be available on your next Codex session.
  4. You can now reference your ClickHelp documentation 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 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.