Connect an MCP Client to HappySupport

You can connect external MCP-compatible tools to HappySupport, giving coding agents and chat apps access to your Help Center, articles, and Glossary. No API key is required; compatible clients discover the login flow automatically through OAuth.

You need to be working in a company organization. Personal organizations cannot be connected to external apps.

Open MCP Settings

1. Go to Settings
   Sign in to HappySupport and open the main product. Click "Settings" in the sidebar.

2. Open the MCP page
   In the Settings side menu, under "Active Organization," click "MCP." This opens the MCP settings page.

Set up a coding agent

3. Select your client
   In the "Coding agents" section, click the tab for the client you use: "Claude Code," "Codex," "GitHub Copilot," or "Other." The selected tab displays setup instructions and a copyable server address.

4. Copy the server address or command
   Click the "Copy" button beside the address or command shown in the tab. The button briefly changes to confirm the copy.

5. Add the server to your client
   Follow the instructions for your specific client:

   • Claude Code: Add the server from your terminal using the displayed command, then start Claude Code. Run /mcp, select happysupport, and choose "Authenticate."
   • Codex: Add the displayed server configuration using Codex CLI or its configuration file, then run the displayed login command.
   • GitHub Copilot: Add the server in .vscode/mcp.json, or use "MCP: Add Server" from the VS Code Command Palette and choose "HTTP." Start the server using the "Start" control above the server entry, or use "MCP: List Servers" → happysupport → "Start," then confirm VS Code's request to authenticate with HappySupport.
   • Other: Add a remote MCP server using streamable HTTP and paste the server address shown in the "Other" tab. This path also applies to clients such as Cursor that support OAuth and MCP authorization discovery.

Set up a chat app

6. Select your chat app
   In the "Chat apps" section, select the relevant tab: "Claude," "ChatGPT," or "Gemini."

7. Add the connector in your app
   Follow the instructions for your specific app:

   • Claude: Open "Settings → Connectors," click "Add custom connector," enter "HappySupport" in the name field, paste the server address into the server URL field, click "Add," then click "Connect" on the new connector. Custom connectors require a paid Claude plan.
   • ChatGPT: Open ChatGPT settings and enable Developer mode if required by your plan or workspace. Add HappySupport as a custom remote MCP server or connector, paste the server address, choose OAuth when prompted, and complete the authorization flow. Depending on your ChatGPT version, these options may appear under Apps, Connectors, or Plugins. Paid plans may be required, and Business or Enterprise users may need a workspace administrator to enable Developer mode.
   • Gemini: Open "Settings & help → Connected Apps," then under "Custom apps for Spark" click "Add a custom app," paste the server address, and click "Next." Custom apps require Gemini Spark access and a personal Google Account.

Authorize the connection

8. Review the authorization request
   When the client opens the HappySupport authorization page, the screen is headed "Connect an app." If you were signed out, you'll sign in first and then return to the authorization request. Review the application name. The name is supplied by the connecting application and is not verified by HappySupport. If you didn't start the connection yourself, click "Deny." Nothing is connected and nothing is shared.

9. Select an organization
   Under the organization-access area, choose the organization from the organization selector. Only eligible company organizations appear. The "Allow" button stays disabled until you select an organization.

10. Choose an access level
    Select an access level using the radio controls:

    • Read and write: Allows the client to browse content and create, change, move, and delete articles and Glossary entries. This is selected by default.
    • Read only: Allows the client to browse Help Center, articles, and Glossary entries but prevents it from changing anything.

11. Allow the connection
    Click "Allow" to approve the connection. The browser returns to the MCP client, which completes authentication and stores its own access token. Your browser session token is not given to the client.

Handle authorization errors

12. Expired or already-used request
    If the authorization request has expired or was already used, the screen says "This request is no longer valid" and shows "Expired or already used." Nothing was connected or shared. Restart the connection from your external client.

13. No eligible organization
    If your account has only a personal organization, the screen says "No organization can be connected." External apps can connect only to a company organization. Create or join a company organization and start again.

The connection stays tied to the organization you selected during consent, even if you later switch organizations in HappySupport. Any writes made through the connection are attributed to your user account. Removing your membership from that organization cuts the connection off immediately.