Skip to content

MCP overview

MCP (Model Context Protocol) is an open standard that lets an AI tool you already use (Claude, ChatGPT, Cursor) connect directly to Máximo and act on it, without you switching to the Máximo admin. You add Máximo’s server URL to the tool and sign in with your email. From then on, that tool can ask Máximo questions and make changes on your behalf, inside the conversation you’re already having with it.

Máximo has one MCP server URL, the same for every store:

https://app.getmaximo.ai/mcp

You can also copy it in Máximo, under Settings → MCP Server.

There’s no token to create or paste. Your AI tool signs you in through your browser:

  1. Add the server URL to your AI tool. See Connect Claude or Connect ChatGPT & Cursor.
  2. The tool opens a Máximo sign-in page. Enter the email you use in your Shopify admin.
  3. Máximo emails you a 6-digit code. Enter it on the same page. The code works for 10 minutes, and you can ask for a new one there.
  4. Choose which stores the tool may use, then select Allow access:
    • All my stores (the default) covers every store listed, plus any store you start using Máximo in later.
    • Only the stores I select covers just the stores you tick. To change them later, connect again.
  5. You’re sent back to your AI tool, which is now connected.

The sign-in page shows which app is asking to connect. Only allow a connection you started yourself; if you don’t recognize the app, select Cancel.

A store is included when all of these are true:

  • your email belongs to a staff account in that store’s Shopify admin,
  • you’ve opened Máximo in that store in the last 90 days,
  • Máximo is installed there, and
  • that store’s admins haven’t revoked the connection.

If a store you expect is missing, open Máximo once from that store’s Shopify admin. With All my stores, it’s picked up on the tool’s next request, with no need to reconnect.

One connection can reach many stores, for example an agency’s clients. When it reaches more than one, your AI tool names the store on each request and can list the stores it can use, with your role in each. Ask for a store by name (“In Acme Outdoors, which products stopped syncing?”) and the tool works in that store.

In each store, a connection acts as you, with your role there. A Viewer can look things up, an Editor can also change the catalog, and an Admin or Owner can also change store settings. Whatever your role, a connected tool can never change billing and plans, team and roles, or destination connections.

Within that, your AI tool can look up the same things Ask Máximo can (catalog and sync status, connection health, tracking and conversion quality, performance, and setup progress) and make changes such as editing products in bulk, including or excluding products, starting a sync, or changing which conversion events reach a destination. See Tools reference for everything a connection covers.

Every change takes two steps. The first call changes nothing: Máximo returns a preview of exactly what will change and asks your AI tool to show it to you. Once you approve, the tool calls again to apply it. Máximo applies exactly the change it previewed, once, and only within 10 minutes of the preview. After that, the tool has to ask for a new preview. A change previewed for one store can’t be applied to another.

In each store, Settings → MCP Server lists the apps connected to it. Admins see every staff member’s connections; everyone else sees their own.

Select Revoke next to a connection to end its access to that store right away. It keeps working in any other stores it reaches. To stop using it everywhere, also disconnect Máximo in your AI tool.

A connection stays signed in for up to 90 days, or until it goes 30 days unused. After that, your AI tool asks you to sign in again.

  • Anyone who can use the AI tool you connected can act in your stores with your role. Don’t connect a tool that others share or can use while you’re away.
  • Revoke connections you no longer use.
  • A store’s admins can revoke any staff member’s connection for that store at any time.

Any MCP client that supports remote servers with OAuth sign-in can connect. Give it the server URL and it starts the same browser sign-in. For developers: Streamable HTTP transport, and OAuth 2.1 (authorization code with PKCE, and dynamic client registration).