Help

Medusa Claude Connector

In this guide, you'll learn how to connect Claude to the Medusa MCP server and use it to ask questions about your Cloud stores.

Coming soon: The Claude Connector is coming soon to Claude's connectors directory. In the meantime, you can add the Medusa MCP server as a custom connector.

What is the Medusa Claude Connector?#

The Claude Connector connects Claude to the Medusa MCP server, so you can ask Claude questions about your stores' orders, products, customers, and other commerce data.

The Claude Connector is read-only. Claude can retrieve data from your stores, but it can't create, update, or delete data.

Note: The Medusa MCP server is in early access. If it isn't enabled for your organization, you can't connect to your stores, even after you add Medusa to Claude. Refer to the Medusa MCP guide to request access and rebuild your environments.

Prerequisites#

Cloud account in an organization with Medusa MCP access↗Claude account↗

Add Medusa MCP as a Custom Connector in Claude#

Until the Claude Connector is available, you can add the Medusa MCP server to Claude as a custom connector.

To add the Medusa MCP server as a custom connector:

In Claude, go to Settings > Connectors.
Click Add custom connector.
Enter a name, such as Medusa, and the URL https://cloud.medusajs.com/mcp.
Click Add, then click Connect next to the connector.
In the browser window that opens, log in to your Cloud account.
On the consent page, select the environments that Claude can access, then click Approve.

Refer to Claude's documentation for more details on custom connectors.

Note: On Claude Team and Enterprise plans, an owner of the Claude organization may need to add the custom connector before members can connect to it.

Use the Medusa Connector#

Once you add the connector, enable it in a chat from the tools menu in the message input. Then, ask Claude questions about your stores. For example:

"Which Medusa stores do I have connected?"
"Show me the 5 most recent orders in my store, with each order's total and status."
"What products are available to shoppers in my B2B sales channel?"
"How do I add a custom field to products in Medusa?"

Claude shows each tool it calls while answering. Refer to the Medusa MCP guide for the list of tools.

Remove the Medusa Connector#

To remove the Medusa connector from Claude:

In Claude, go to Settings > Connectors.
Find the Medusa connector and click Disconnect.

To change the stores that Claude can access, disconnect the connector and connect it again, then select the environments on the consent page.

Troubleshooting#

Refer to the Medusa MCP troubleshooting section for common errors and how to fix them.

Was this guide helpful?