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.
Enable Developer mode in Security and login.
2. Open Plugins, select the + or Add button, then choose Add custom MCP server.
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.
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.
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.
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