Connect your AI assistant to GorgiasUpdated 2 hours ago

The Gorgias Model Context Protocol (MCP) app allows your third-party AI assistant to access your Gorgias data and account, so they can read and analyze your helpdesk tickets, and audit and update your Gorgias settings.

The instructions in this article outline how to connect the Gorgias MCP app to Claude, but you can connect it to any MCP-compatible AI client, including Cursor, ChatGPT, and more. Refer to your AI client's documentation for how to add an HTTP MCP server, then authenticate with Gorgias when prompted.

Requirements

• Available on all Helpdesk plans
• Everyone can install the Gorgias MCP. The actions available to you depend on your Gorgias role.
• An account with an MCP-compatible AI assistant app (for example, Claude, ChatGPT, Cursor, etc.)

How it works

• Model Context Protocol is a standard that lets AI tools connect to external data sources.
• With the Gorgias MCP app, your AI tool can access your Gorgias data and can interact with your helpdesk settings
• This guide provides steps for connecting the Gorgias MCP app to Claude; however, you can connect the Gorgias MCP to the MCP-compatible third-party AI tool of your choosing.

What AI assistants can do with the Gorgias MCP

Once connected, your AI assistant can access your helpdesk data and take actions on your helpdesk and AI Agent settings on your behalf. Use the Gorgias MCP to:

Improve your AI Agent setup. Prompt your AI assistant to audit your AI Agent setup. Use your AI assistant to draft new guidance, update macros, and preview how your AI Agent would respond to a message before turning anything on.

Get voice-of-customer insights. Use plain language to surface frustration patterns, top return reasons, most-requested restocks, and trends from low CSAT surveys right from your tickets. No ticket export or request to your internal data-team required.

Improve your helpdesk setup. Spot gaps in your tag taxonomy, find stale macros, flag users who need permissions adjusted, and fix it all in the same chat.

Beyond these, you can also reply to customers, post internal notes, update ticket status and priority, manage helpdesk rules, and configure support actions directly from your AI tool.

Install the Gorgias MCP on Claude Desktop

On Free, Pro, and Max Claude plans, you can add the Gorgias connector directly from your Claude Desktop settings. On Team and Enterprise plans, connectors are managed at the organization level — an Owner must add the Gorgias connector first, then members can connect individually.

Before you start the installation, make sure you have all of the following:

• Your Gorgias subdomain. Your subdomain is the your-brand part of your account URL (your-brand.gorgias.com).
• The Claude Desktop app downloaded to your computer, and signed into your Claude account.

Connect to Free, Pro, and Max plans

1. Open the Claude desktop app, then select Customize.
2. Click Connectors, then click the + plus icon and select Add custom connector.
3. In the Name field, enter Gorgias connector.
4. In the Remote MCP server URL field, enter the following URL, replacing your-subdomain with your Gorgias subdomain:

   1https://mcp.gorgias.com/mcp?gorgias_subdomain=your-subdomain

5. Click Add.
6. Click Connect. You'll be redirected to the browser.
7. Click Allow Access.
8. Review the data the MCP can access, then click Authorize.
9. Click Open desktop app to return to the Claude desktop app.

Once you've authenticated, your credentials are saved automatically for future sessions. To test out your connection, try asking your AI assistant something like: Audit the handover tickets, guidance, and actions for my account and propose a plan.

Connect to Team and Enterprise plans

On Team and Enterprise plans, an Owner must add the connector to the organization before members can connect it to their Claude accounts.

Owner steps:
An Owner should follow these steps to make the connector available to their team.

1. Open the Claude desktop app, then click your name in the bottom-left corner.
2. Select your organization from the menu, then select Organization settings.
3. Click Connectors.
4. Click Add, hover over Custom, then select Web.
5. In the Name field, enter Gorgias connector.
6. In the Remote MCP server URL field, enter the following URL, replacing your-subdomainwith your Gorgias subdomain:

   1https://mcp.gorgias.com/mcp?gorgias_subdomain=your-subdomain

7. Click Add.
8. Click Connect. You'll be redirected to the browser.
9. Click Allow Access.
10. Review the data the MCP can access, then click Authorize.
11. Click Open desktop app to return to the Claude desktop app.

Member steps:
Once the connector has been added to your organization, follow the steps below to connect it to your account.

1. Open the Claude desktop app, then select Customize.
2. Click Connectors.
3. Find the Gorgias connector in the list and click Connect. You'll be redirected to the browser.
4. Sign-in with your Gorgias credentials to complete the authorization.
5. Click Open desktop app to return to the Claude desktop app.

Install the Gorgias MCP on Claude Code

If you prefer to use Claude Code in your terminal app, follow the instructions below to install the Gorgias MCP app:

1. Open a terminal app on your computer.
2. Type claude and press Enter to open Claude Code in your terminal.
3. In your terminal, run the following command, replacing your-subdomainwith your Gorgias subdomain:

   1claude mcp add --transport http gorgias https://mcp.gorgias.com/mcp?gorgias_subdomain=your-subdomain

4. Press Enter, then quit and relaunch Claude Code.
5. In the new session, run /mcp and select gorgias.
6. Select Authenticate to open a browser window, then sign in with your Gorgias credentials and approve access.

Set up with another AI client

Gorgias MCP works with any MCP-compatible AI client. The setup process varies by client, but the connection URL is the same:

1https://mcp.gorgias.com/mcp?gorgias_subdomain=your-subdomain

Refer to your AI client's documentation for how to add an HTTP MCP server, then complete the Gorgias authentication step when prompted:

• ChatGPT
• Codex
• Cursor
• VSCode Copilot

FAQ