Skip to main content

Connect PayWhirl for Shopify to ChatGPT or Claude (Beta)

Request beta access and connect your Shopify store’s PayWhirl subscription tools to ChatGPT or Claude.

Written by Ryan P.

The PayWhirl MCP (Model Context Protocol) connects a supported AI assistant to your Shopify store’s PayWhirl tools. You can ask questions in everyday language, review information, and request supported actions from ChatGPT or Claude.


​Our team must enable MCP access for your store before you can connect. Reply to any PayWhirl in-app message or email, or contact team@paywhirl.com to request access, then wait for our team to confirm that MCP is enabled for your store before connecting. Beta features and available tools may change as we learn from merchant feedback.

This guide is for PayWhirl’s Shopify app. BigCommerce and other Multi-Platform V2 users should follow the separate multi-platform MCP guide.

Before you begin

  • Have PayWhirl installed on your Shopify store.

  • Get confirmation from PayWhirl Support that MCP beta access is enabled for that store.

  • Use a ChatGPT or Claude account that allows custom MCP connections. If your account is managed by workspaces, it may require an administrator’s permission.

Shopify MCP server URL:

https://api.shop.paywhirl.com/mcp

Use this exact URL. The Shopify and Multi-Platform apps have separate connections.

1. Request beta access

Reply to any in-app message or email you receive from PayWhirl, or email team@paywhirl.com to request access. Our team will enable MCP for your store and let you know when you can connect.

Wait for that confirmation before trying to connect. Once you are approved, the easiest way is to give the LLM of your choice the server URL and ask it to configure it for you. Example to copy and paste:

Help me connect this AI assistant to PayWhirl for Shopify using https://api.shop.paywhirl.com/mcp with OAuth authentication.
Configure the connection if you can; otherwise, walk me through setup and sign-in, then verify it works without changing any store data.

If you are having issues, you can follow the steps below:

2. Connect PayWhirl to ChatGPT

Interface labels and available options may vary by account or workspace.

1. In ChatGPT, open Settings → Security and login and enable Developer mode. If this option is unavailable, check with your workspace administrator.

ChatGPT Security and login settings with Developer mode enabled

Enable Developer mode in Security and login.

2. Open Plugins, select the + or Add button, then choose Add custom MCP server.

ChatGPT Plugins page with the plus button for adding a connection

Open Plugins to add a custom MCP server.

3. Name the connection PayWhirl for Shopify. For the description, enter “Connect my Shopify store to PayWhirl.”

4. Enter https://api.shop.paywhirl.com/mcp as the server URL and select OAuth for authentication.

ChatGPT custom MCP form with PayWhirl for Shopify, the Shopify server URL, and OAuth

Use the Shopify MCP URL and OAuth authentication.

5. Review the connection warning and check the server URL carefully. Select Create as a plugin and follow the PayWhirl sign-in and authorization prompts for your store.

6. Review the tools ChatGPT discovers and install the plugin if prompted.

7. Start a new conversation, type @, and select PayWhirl for Shopify.

Review the requested access before authorizing the connection. Do not paste your credentials into the conversation.

3. Connect PayWhirl to Claude

Individual accounts

1. Open Customize → Connectors.

2. Select + Add → Add custom connector.

Claude Customize Connectors page with Add custom connector selected

In Customize, open Connectors and choose Add custom connector.

3. Name it PayWhirl for Shopify and enter https://api.shop.paywhirl.com/mcp as the remote MCP server URL.

Claude custom connector form with PayWhirl for Shopify and the Shopify MCP server URL

Enter PayWhirl for Shopify and the Shopify MCP server URL.

4. Select Continue, review the detected authentication settings, and follow the prompts to finish adding the connector and authorize access to your store.

5. In a conversation, open + → Connectors and enable PayWhirl for Shopify.

If Claude asks for authentication details you do not recognize, contact PayWhirl Support before proceeding.

Team and Enterprise accounts

A workspace owner or another administrator with the required connector permissions must add the connector first. Open Organization settings → Connectors → Add → Custom → Web, enter the Shopify MCP URL, and complete the setup prompts.

Each member then opens Customize → Connectors, selects the PayWhirl for Shopify connector, and completes their own connection. Workspace policies may limit which connectors and tools members can use.

4. Start with a read-only request

Begin by checking what the assistant can access:

What PayWhirl for Shopify tools are available in this conversation? Group them into tools that read information and tools that make changes. Do not make any changes.

Then try this prompt, "List my PayWhirl selling plan groups. Retrieve all pages if needed, and tell me if any results could not be retrieved. Do not make any changes."

Available tools may change during the beta. Ask the assistant to explain any limits before relying on a result. If a request needs a capability that is unavailable, use the PayWhirl app or contact Support.

5. Review changes before approving them

Some tools can change store data. Before requesting a change, ask the assistant to identify the exact records and explain what it proposes to do without applying it.

  • Check the store, record IDs, customer details, dates, and amounts.

  • Review any approval prompt carefully. Where tool permissions are available, require approval for actions that make changes.

  • Use test records during the beta whenever possible.

  • Only send a separate instruction to apply a change after the preview is correct.

For example:
Review subscription [ID] and explain which changes the available tools support. Do not change the subscription or trigger a payment.

Troubleshooting

MCP access is not enabled

Reply to any PayWhirl in-app message or email, or contact PayWhirl Support with your store’s myshopify.com domain. If access was already approved, ask us to confirm it is enabled for the store you are connecting.

The assistant cannot connect

  • Check that the server URL is exactly https://api.shop.paywhirl.com/mcp.

  • Confirm PayWhirl has enabled MCP access for your store.

  • Check your AI workspace’s custom-connection permissions. For ChatGPT, also confirm Developer mode is enabled.

  • Complete any pending sign-in or authorization prompts.

  • If tools are missing after an update, refresh the tool list or reconnect, then try a new conversation.

A request fails or returns incomplete results

Ask the assistant which tool and filters it used, whether it checked all result pages, and whether any request failed. An empty result is different from a failed request. Do not treat a partial list as a complete report.

Report beta feedback

Send PayWhirl Support your store domain, the AI assistant you used, your request, the approximate time and time zone, and any error message or relevant screenshot. Remove passwords, payment details, and unnecessary customer information.

Disconnect PayWhirl

In ChatGPT, open the PayWhirl for Shopify plugin’s controls to uninstall it, and disconnect any associated MCP connection separately if it remains listed. In Claude, open Customize → Connectors, choose PayWhirl for Shopify, and use its disconnect or removal controls. Organization-level removal may require an administrator.

Removing a plugin or connector does not necessarily revoke every existing authorization. If you need MCP access disabled for your store, contact PayWhirl Support.

Related guidance

Please let us know if you have any questions.
Team PayWhirl

Did this answer your question?