Home → API Manual → MCP Server → Connecting Claude Code to the HelpSpot MCP Server

7.4. Connecting Claude Code to the HelpSpot MCP Server

Updated: Jun 8 2026, 03:48 PM

This guide walks you through connecting Claude Code to the HelpSpot MCP server.

Before You Begin

• You have access to the HelpSpot admin area.
• MCP is enabled in your HelpSpot instance.
• Claude Code is installed and you can run the claude command in your terminal.

Step 1: Get Your HelpSpot MCP Server URL

1. Log in to your HelpSpot admin area.
2. Go to Settings.
3. Select MCP.
4. Enable the MCP server if it is not already enabled.
5. Copy the MCP Server URL.

Step 2: Add the MCP Server to Claude Code

1. Open your terminal.
2. Run claude mcp add --transport http helpspot <YOUR_HELPSPOT_MCP_URL>, replacing the placeholder with the URL you copied.
3. By default the server is added at the local (current project) scope. To make it available across all of your projects, add --scope user.

Step 3: Authenticate the Connection

1. Start Claude Code and run the /mcp command.
2. Select the HelpSpot server and choose to authenticate.
3. Complete the authorization prompt in your browser and approve the request.
4. Claude Code stores the access token securely in your system keychain.

Step 4: Configure MCP Tool Permissions

Use the /mcp command to review the HelpSpot tools and enable or disable them as needed. Claude Code prompts for confirmation before running a tool unless you choose to always allow it.

Step 5: Start Using HelpSpot in Claude Code

Once connected, you can ask Claude Code questions about your HelpSpot instance, including ticket lookups, customer conversations, and other HelpSpot data available through MCP.

Troubleshooting

The MCP option does not appear in HelpSpot

Make sure your HelpSpot installation supports MCP and that the feature is enabled.

Tools do not appear after adding the server

• Run /mcp to reconnect to the server.
• Run claude mcp get helpspot to check the server status.

Authentication fails

• Confirm the MCP Server URL is correct.
• Make sure your browser allows the authorization window.
• If authentication loops, remove the server with claude mcp remove helpspot and add it again.