MerchantFlowMerchantFlow Docs
IntegrationsMCP Server

Connect MerchantFlow to ChatGPT

Add MerchantFlow from ChatGPT's plugin directory, or as a custom connector, so you can ask about your profit, products and orders without leaving the chat.

Connect MerchantFlow to ChatGPT

MerchantFlow is listed in ChatGPT's plugin directory, so you can connect your Shopify or WooCommerce store to ChatGPT without copying a server URL. Once connected you can ask about profit, products, ad performance and orders in plain language and get answers from your real numbers.

The connection is read-only. ChatGPT can never change anything in MerchantFlow, your store or your ad accounts.

There are two ways to connect. Use the plugin directory unless you have a reason not to.

Option 1: Add MerchantFlow from the plugin directory

  1. Open the MerchantFlow listing in ChatGPT and connect it. The same link is on Settings > Developer > MCP in your dashboard, behind Open MerchantFlow in ChatGPT.
  2. ChatGPT opens a MerchantFlow page in your browser showing which permissions it is asking for. Sign in if asked, then click Allow access. If you do not have a MerchantFlow account yet, you can start a trial from that page and you are brought back to finish connecting.
  3. Ask something. Try one of these:
    • "What was my net profit last month?"
    • "Which five products made the most net profit last month?"
    • "Compare Meta and Google ad performance over the last 90 days."

On Business, Enterprise and Edu workspaces an admin controls which plugins members can connect. If MerchantFlow is not available to you, ask your workspace admin to allow it.

Option 2: Add MerchantFlow as a custom connector

Use this if your workspace allows custom connectors but not the MerchantFlow plugin, or if you prefer to manage the connection by URL.

Step 1: Copy your server URL

In MerchantFlow go to Settings > Developer > MCP and copy the server URL:

https://merchantflow.ai/api/mcp

Use that address exactly. In particular do not add www. in front of it: that address redirects, and the redirect drops the authorization header, so ChatGPT ends up unable to sign in with nothing on screen explaining why.

Step 2: Add the connector in ChatGPT

In ChatGPT open Settings, then Apps & Connectors, then Create. On Business, Enterprise and Edu workspaces an admin has to allow custom connectors before the option appears.

Paste the server URL and choose OAuth for authentication. ChatGPT registers itself with MerchantFlow automatically, so there is no client ID or secret to enter.

Step 3: Approve access

ChatGPT opens a MerchantFlow page in your browser. Click Allow access.

If you are not signed in to MerchantFlow at that moment you are asked to sign in first and then taken straight back to the approval page. You do not need to start again.

What ChatGPT can see

This depends on how you connected.

From the plugin directory, ChatGPT uses MerchantFlow's tools for P&L summaries, product profitability, ad spend and ROAS across Meta, Google, TikTok and Snapchat, cohorts and LTV, inventory, valuation and more. P&L answers can also include an interactive profit waterfall drawn inside the chat.

As a custom connector, ChatGPT uses two tools: search and fetch. That is OpenAI's design for custom connectors, not a MerchantFlow limit. Those two cover your products and orders: names, SKUs, prices, order totals, COGS, contribution margin, payment and fulfilment status. Turning on developer mode in ChatGPT exposes the full tool set to a custom connector. Developer mode is a beta feature on Business, Enterprise and Edu plans and is enabled by an admin.

Customer names, email addresses and shipping addresses are never included in search or fetch results.

Troubleshooting

It connects but only finds products and orders

You added MerchantFlow as a custom connector, which is limited to search and fetch. Remove the custom connector and add MerchantFlow from the plugin directory instead, or turn on developer mode in ChatGPT.

The custom connector will not save, or reports that the server does not implement the specification

  • Check the URL is exactly https://merchantflow.ai/api/mcp, with no /sse or other suffix.
  • Confirm custom connectors are allowed on your workspace. On Business, Enterprise and Edu this is an admin setting.

Sign-in fails or reports an OAuth configuration problem

  • If you added a custom connector, confirm you did not use www.merchantflow.ai (see Option 2, step 1).
  • Try removing MerchantFlow from ChatGPT and adding it again. That clears a stale registration from an earlier attempt.

Last updated on

On this page