The BoldDesk MCP Server can be integrated with popular AI assistants and developer tools. Choose your preferred client below and follow the setup instructions below.

Claude

You can connect BoldDesk to Claude using the built-in connectors feature. Claude supports OAuth 2.0 authentication for the BoldDesk MCP endpoint.

Setup steps

  1. In Claude, click Customize and select Connectors.
  2. Click Add, then select Add custom connector.
  3. Enter a name for the connector, such as BoldDesk MCP.
  4. Enter the BoldDesk MCP endpoint URL in the format https://<your-subdomain>.bolddesk.com/mcp, replacing <your-subdomain> with your BoldDesk account subdomain.
  5. Proceed with the OAuth sign-in flow to authorize access.

Once connected, BoldDesk tools will be available in your Claude conversations.

ChatGPT

You can connect BoldDesk to ChatGPT using a Pro, Plus, Business, Enterprise, or Education account.

ChatGPT supports both OAuth 2.0 and API key authentication methods for the BoldDesk MCP endpoint.

Before proceeding, ensure that Developer mode is enabled in ChatGPT.

To add BoldDesk MCP as a plugin, follow these steps:

  1. Open Settings > Apps > Advanced settings and enable Developer mode.
  2. Go to Plugins > Click the '+' icon.
  3. In the New App dialog, enter the following details:
    • Name: BoldDesk MCP
    • Description: Tools to perform ticket operations
    • MCP Server URL: Your BoldDesk MCP endpoint URL
    • Authentication: Choose OAuth 2.0 or API key based on your use case
    • For API Key: Select Custom Header and use x-api-key as the header name.
    • Click Create.
  4. Sign in when prompted. You will be redirected to the authorization page. After signing in successfully, accept the consent request.
  5. Start a new chat to test the connected MCP Server.

GitHub Copilot

This section describes the supported setup process for the hosted BoldDesk MCP Server in GitHub Copilot for Visual Studio Code.

Before you begin:

  1. Use Visual Studio Code 1.99 or later.
  2. Decide whether you want the BoldDesk MCP Server available only in the current workspace or across all your workspaces.
  3. Choose either OAuth 2.0 or API key authentication based on your use case.

Workspace configuration with API Key

Create a .vscode/mcp.json file in your workspace and configure the hosted endpoint with a secure API key input:

{
     "inputs": [
       {
         "type": "promptString",
         "id": "bolddesk-api-key",
         "description": "BoldDesk API key",
         "password": true
       }
     ],
     "servers": {
       "bolddeskMcp": {
         "type": "http",
         "url": "https://<your-subdomain>.bolddesk.com/mcp",
         "headers": {
           "x-api-key": "${input:bolddesk-api-key}"
         }
       }
     }
   }

Workspace configuration with OAuth 2.0

For OAuth 2.0 authentication in your workspace:

{
     "servers": {
       "bolddeskMcp": {
         "type": "http",
         "url": "https://<your-subdomain>.bolddesk.com/mcp"
       }
     }
   }

Replace with your BoldDesk account subdomain.

Start the server to begin the OAuth flow.

Code Studio

This section describes the supported setup process for the remote BoldDesk MCP Server in Syncfusion Code Studio.

Code Studio includes a built-in MCP Servers UI that lets you add, manage, and configure MCP servers without editing configuration files manually.

Setup steps

  1. In Code Studio, click the Settings icon in the extension panel and select MCP Servers.
  2. Open the Custom Server tab and click Add MCP Server.
  3. Review and accept the terms and conditions.
  4. Select HTTP as the connection type.
  5. Enter the BoldDesk MCP endpoint URL.
  6. Enter a Server ID, which is used to identify the server in Code Studio.
  7. Select the configuration target:
    • Global — Makes the server available across all workspaces.
    • Workspace — Limits the server to the current project only.
  8. Add the appropriate authentication:
    • For OAuth 2.0: No additional configuration is required. Code Studio will automatically initiate the OAuth 2.0 flow when the server is started.
    • For API key: After adding the server, open Edit configuration (JSON) from the MCP Servers UI and add the x-api-key header with your BoldDesk API key.
{
  "servers": {
    "bolddeskMcp": {
      "type": "http",
      "url": "https://<your-subdomain>.bolddesk.com/mcp",
      "headers": {
        "x-api-key": "your-api-key-here"
      }
    }
  }
}

Once configured, the BoldDesk MCP Server is ready to use in the Code Studio chat agent.

Accessing MCP tools

  1. Click the Syncfusion Code Studio icon to open the chat window.
  2. Select Agent mode in the chat window.
  3. Click the Configure Tools button in the chat input field to view and enable BoldDesk MCP tools.

Managing the server

After setup, you can manage the BoldDesk MCP Server from the MCP Servers UI using the Manage option. Available actions include:

  • Start, stop, or restart the server.
  • View real-time server logs via Show output.
  • Edit the configuration directly in JSON via Edit configuration (JSON).
  • Browse available tools and resources.
  • Uninstall the server when no longer needed.