Connect your AI assistant to the Gorgias MCPUpdated 4 days 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 review handovers, draft new guidance, 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. Once you've authenticated, your credentials are saved automatically for future sessions.

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: https://mcp.gorgias.com/mcp
5. Click Add.
6. Click Connect. You'll be redirected to the browser.
7. Enter your Gorgias subdomain, then click Continue.
8. Click Allow Access.
9. Sign into Gorgias to complete the authentication. If you already have an active Gorgias session in your browser, you won't be prompted to sign in.
10. Review the data the MCP can access, then click Authorize.
11. Click Open desktop app to return to the Claude desktop app.

That's it! You're now connected and you can start prompting.

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: https://mcp.gorgias.com/mcp
7. Click Add.
8. Click Connect. You'll be redirected to the browser.
9. Enter your Gorgias subdomain, then click Continue.
10. Click Allow Access.
11. Sign into Gorgias to complete the authentication. If you already have an active Gorgias session in your browser, you won't be prompted to sign in.
12. Review the data the MCP can access, then click Authorize.
13. 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-subdomain with your Gorgias subdomain: claude mcp add --transport http gorgias https://mcp.gorgias.com/mcp
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 enter your Gorgias subdomain.
7. Click Allow access.
8. Sign into Gorgias to complete the authentication, then return to Claude code. If you already have an active Gorgias session in your browser, you won't be prompted to sign in.

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:

https://mcp.gorgias.com/mcp

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

Try it out

Now that you've connected the Gorgias MCP to your AI assistant, you're ready to start prompting. Below, we've listed a few examples of things you can ask your AI Assistant to do, but feel free to get creative!

AI Agent setup and improvement

• "Audit my AI Agent setup and flag any handover conditions that seem too broad or likely to cause unnecessary escalations."
• "Review my AI Agent guidance and draft improvements."
• "Simulate how my AI Agent would respond to this message before I enable it: [paste a sample customer message]."
• "Are there any topics my customers are asking about that my AI Agent isn't currently configured to handle?" -"In ticket #[number] AI Agent is not responding how it should, help me fix this"

Voice-of-customer insights

• "What are the top reasons customers are contacting us this month? Group them by theme."
• "Summarize the most common complaints from low-CSAT tickets in the past 30 days."
• "What products are customers asking us to restock most often?"
• "Find patterns in tickets tagged as returns and tell me what reasons customers are giving."
• "Are there any recurring frustrations in tickets that aren't being captured by our current tags?"

Helpdesk setup and maintenance

• "Review my tag taxonomy and flag any tags that are redundant, inconsistently named, or rarely used."
• "Find macros that haven't been used in the last 90 days and suggest which ones we should update or retire."
• "Check if any agents have permissions that don't match their current role."
• "Are there any gaps in my helpdesk rules that could be causing tickets to fall through the cracks?"

Ticket actions and day-to-day work

• "Find all open tickets tagged 'damaged-item' and summarize what customers are asking for."
• "Post an internal note on ticket #[number] flagging it for the fulfillment team."
• "Update all tickets from the last 24 hours that mention [specific issue] to priority: urgent."
• "Reply to ticket #[number] with a message letting the customer know their order has shipped and we'll follow up once it's delivered."

FAQ