Connect your store to an AI in three steps.

Two parts: first you'll register Claude as an OAuth client in your Magento admin and copy two values, then you'll paste them into Claude's connector setup. After that, signing in works through your normal Magento login.

Part 1 — Register Claude in your Magento admin

1. Open OAuth Clients

   Sign in to your Magento admin. In the top menu, go to System → MCP → OAuth Clients. Click Add New Client.

   

2. Pick "Claude Web" from the Preset dropdown

   On the new client form, open the Preset dropdown and select Claude Web. This autofills the Name and Redirect URIs with the right values — you can leave them as-is.

   

3. Choose which tools Claude can use

   Click the Allowed Tools tab. Nothing is ticked by default — either click Allow All to grant Claude access to every tool, or tick the categories and individual tools you want. You'll also get a second chance to narrow this when you click Connect later.

   

4. Save and copy the Client ID + Secret

   Click Save Client (top right). You'll be taken to a confirmation page that shows the Client ID and Client Secret. Copy both — the secret is only shown once.

   Lost the secret? There's no in-place regenerate — delete the OAuth client and create a new one. The old credentials stop working immediately.

Part 2 — Add the connector in Claude

1. Open Claude's connectors page

   Go to claude.ai/customize/connectors and sign in if you haven't already. (Same page is reachable from the Claude menu → Customize → Connectors.)

2. Click the + icon, then "Add custom connector"

   

3. Fill in the connector details

   Name: anything you'll recognise (e.g. My Store).

   Remote MCP server URL: https://<your-store>/mcp

   Expand Advanced settings and paste the two values you copied from Magento:

   • OAuth Client ID — paste from Part 1.
   • OAuth Client Secret — paste from Part 1.

   Click Add.

   

4. Click Connect

   You'll land on a page that says You are not connected to Magento MCP yet. Click Connect.

   

5. Approve access in your Magento store

   You'll be sent to your Magento store. If you're not already signed in to the admin, sign in. The Authorize MCP access page shows the categories of tools Claude is asking for — untick anything you don't want Claude to have, then click Approve selected.

   

6. You're done

   You'll be sent back to Claude and the connector appears in your list. Start a new chat and try the example below.

Try it out

Open a new chat and ask:

Show me my store's recent orders.

Claude Code runs on your machine, so it can talk to your store directly — including local development stores (mystore.docker, mystore.local). The simplest setup is a connection token.

Part 1 — Create a connection token

1. Open MCP Connections in your Magento admin

   Sign in to your Magento admin. In the top menu, go to System → MCP → Connections. Click New Connection.

   

2. Fill in the Token Info tab

   Pick your Admin User, give the token a Name (e.g. Claude Code, laptop), and set Allow Write Tools to Yes if you want Claude Code to make changes. Save.

   

3. Copy the token

   The next screen shows the token once. Copy it now.

Part 2 — Add the connection in Claude Code

1. Register the server with the token

   In any terminal, run:

   Copy

   claude mcp add --transport http magento \
     https://<your-store>/mcp \
     --header "Authorization: Bearer <your-token>"

   By default this stores the server in local scope (current folder, just you). Add --scope user if you want the server available in every folder on your machine, or --scope project if you want it committed to .mcp.json and shared with everyone on the project.

2. Check it's connected

   Copy

   claude mcp list

   You should see magento with a connected status. Inside a Claude Code session you can also run /mcp to inspect server details and tool counts.

Try it out

Start a Claude Code session and ask:

Use the magento server to show me my store's recent orders.

bin/magento magebit:mcp:token:create \
  --admin-user <username> \
  --name "Claude Code, laptop" \
  [--allow-writes]

claude mcp add --transport http magento \
  https://<your-store>/mcp \
  --client-id <client-id> \
  --client-secret <client-secret> \
  --callback-port 33418

Cursor doesn't have a browser sign-in flow, so you'll create a small connection token in your Magento admin and paste it into Cursor's settings.

Part 1 — Create a connection token

1. Open MCP Connections in your Magento admin

   Sign in to your Magento admin. In the top menu, go to System → MCP → Connections. Click New Connection.

   

2. Fill in the Token Info tab

   On the new connection form, the Token Info tab is open by default. Fill it in:

   • Admin User — pick your own admin account (the token inherits its permissions).
   • Name — something you'll recognise (e.g. Cursor on my laptop).
   • Expires At (UTC) — leave blank for a token that doesn't expire, or pick a date.
   • Allow Write Tools — set to Yes if you want Cursor to make changes (create products, edit pages, etc.).

   

3. (Optional) Narrow the Resource Access

   Click the Resource Access tab. Leave it on All for full access, or switch to Custom to tick only the specific tools you want Cursor to use.

   

4. Save and copy the token

   Click Save (top right). The next screen shows the token once. Copy it now — it can't be shown again.

   Lost it? No problem — just delete that connection and create a new one. The old token stops working immediately.

bin/magento magebit:mcp:token:create \
  --admin-user <username> \
  --name "Cursor on my laptop" \
  [--allow-writes]

Part 2 — Tell Cursor about your store

1. Open Cursor's MCP settings

   In Cursor, open Settings → Tools & MCPs. Click + New MCP Server — Cursor opens ~/.cursor/mcp.json in an editor tab (or creates it if it doesn't exist yet). For a per-project connection instead, create .cursor/mcp.json in the project root.

   

2. Paste this in (replacing the angle brackets)

   Copy

   {
     "mcpServers": {
       "magento": {
         "name": "magento",
         "url": "https://<your-store>/mcp",
         "headers": {
           "Authorization": "Bearer <your-token>"
         }
       }
     }
   }

   Save the file. Cursor picks up the change immediately — no reload needed.

3. Check the server's connected

   Back on Settings → Tools & MCPs, your magento server appears under Installed MCP Servers with a green status dot and a tool count. Toggle it on if it isn't already.

Try it out

Open Cursor's chat sidepanel (Cmd+L on Mac, Ctrl+L on Windows/Linux), switch to Agent mode at the bottom of the chat (MCP tools only work in Agent mode, not Ask), and ask:

Show me my store's recent orders.

ChatGPT generates a unique Callback URL for each app, so the order matters: you'll start in ChatGPT to grab that URL, then create the matching OAuth client in your Magento admin, then come back to ChatGPT to finish. OAuth is the only auth ChatGPT accepts for custom apps — no API keys.

Part 1 — Enable Developer mode in ChatGPT

1. Open Settings → Apps

   Go to chatgpt.com and sign in. Open Settings → Apps. On a workspace plan (Business / Enterprise / Edu), an admin may need to enable Developer mode for the workspace first.

   

2. Click Advanced settings → toggle Developer mode on

   Under Advanced settings, switch on Developer mode. (It's marked Elevated risk because dev-mode apps aren't reviewed by OpenAI — that's expected.) A Create app button appears at the top of the Advanced settings panel once it's on.

   

Part 2 — Grab ChatGPT's Callback URL

1. Click Create app

   From the Apps page, click Create app. The New App dialog opens.

2. Fill in the basics

   In the dialog:

   • Name: anything you'll recognise (e.g. Magento MCP).
   • MCP Server URL: https://<your-store>/mcp
   • Authentication: OAuth.

3. Open Advanced OAuth settings and copy the Callback URL

   Expand Advanced OAuth settings. Under Client registration, the Registration method defaults to User-Defined OAuth Client — leave it there (DCR and CIMD show as unavailable, which is expected). ChatGPT displays a Callback URL like https://chatgpt.com/connector/oauth/<random-id> — the random ID is unique to this app. Click Click to copy to grab it. Keep this dialog open; you'll need it in Part 4.

   

Part 3 — Register the OAuth client in your Magento admin

1. Open OAuth Clients

   In a new tab, sign in to your Magento admin. In the top menu, go to System → MCP → OAuth Clients. Click Add New Client.

   

2. Fill in the form with the Custom preset

   On the new client form, open the Preset dropdown and select Custom. ChatGPT generates a different Callback URL for every app, so a static preset wouldn't help anyway — you'll paste the per-app URL by hand.

   • Name: e.g. ChatGPT.
   • Redirect URIs: paste the Callback URL you copied from ChatGPT in Part 2 (e.g. https://chatgpt.com/connector/oauth/<random-id>).

3. Choose which tools ChatGPT can use

   Click the Allowed Tools tab. Nothing is ticked by default — click Allow All for full access, or tick the categories and tools you want.

   

4. Save and copy the Client ID + Secret

   Click Save Client. You'll see the Client ID and Client Secret. Copy both — the secret is only shown once.

Part 4 — Finish creating the app in ChatGPT

1. Paste the Client ID (and Secret if you want it)

   Back in the ChatGPT New App dialog, paste your Magento OAuth Client ID. The OAuth Client Secret field is optional — leave it blank to use PKCE without a secret, or paste the Magento secret in for client-secret auth.

2. Acknowledge the risk and click Create

   Tick I understand and want to continue on the risk notice, then click Create.

3. Connect and approve access in Magento

   ChatGPT opens your Magento login page — sign in if needed. On the Authorize MCP access page, untick anything you don't want ChatGPT to have, then click Approve selected.

   

4. Switch it on in your chat

   Open a new chat. Click the + in the message composer → hover More, and pick your app from the submenu. Without this step, ChatGPT won't use your store's tools. Once enabled, your app appears as a chip next to the + button — that's how you know it's active for the current chat.

   

Try it out

Show me my store's recent orders.

Any MCP-compatible client can connect to your store. You'll need two things — your store's MCP address and a way for the client to prove who it is. Pick whichever method your client supports:

• OAuth 2.1 — the client signs in through your Magento admin. Best for hosted/web clients and any client that supports it.
• Bearer token — you mint a token in Magento and paste it into the client. Simpler, works with anything.

Your store's MCP address

MCP server URL

https://<your-store>/mcp

Option A — OAuth 2.1

Use this if your client lets you paste an OAuth Client ID and Secret (or supports automatic OAuth discovery).

1. Register the client in Magento admin

   Sign in to your Magento admin. Go to System → MCP → OAuth Clients and click Add New Client.

   

2. Fill in Name and Redirect URI

   Open the Preset dropdown — if your client is in the list, pick it and skip ahead. If it isn't, fill the fields manually:

   • Name: anything you'll recognise (e.g. the client name).
   • Redirect URIs: the OAuth callback URL from your client's documentation. Must match exactly — no trailing slash.

3. Choose which tools the client can use

   Click the Allowed Tools tab. Nothing is ticked by default — click Allow All for full access, or tick the categories and tools you want.

4. Save and copy the Client ID + Secret

   Click Save Client. You'll see a Client ID and a Client Secret. Copy both — the secret is only shown once.

5. Configure your client

   In your MCP client, add a new server with the URL above and paste the Client ID and Secret into the OAuth fields. When you connect, your Magento admin login page opens — sign in and click Approve selected.

https://<your-store>/.well-known/oauth-authorization-server
https://<your-store>/.well-known/oauth-protected-resource

Option B — Bearer token

Use this if your client lets you paste an API key or an Authorization header. Simplest path — no consent screen, no client registration.

1. Create a token in Magento admin

   Sign in to your Magento admin. Go to System → MCP → Connections and click New Connection.

   

   On the Token Info tab, pick your Admin User, give the token a Name, and set Allow Write Tools to Yes if the client should be able to make changes. Then click Save.

   

2. Copy the token

   The next screen shows the token once. Copy it — if you lose it, just delete that connection and create a new one.

3. Configure your client

   Point your client at the URL above. Send the token as an Authorization header:

   Copy

   Authorization: Bearer <your-token>

   Most MCP clients have either a header field in their server config, or a way to call the server through the mcp-remote stdio bridge — that bridge takes a --header flag:

   Copy

   npx -y mcp-remote https://<your-store>/mcp \
     --header "Authorization: Bearer <your-token>"

bin/magento magebit:mcp:token:create \
  --admin-user <username> \
  --name "<label>" \
  [--allow-writes]

Try it out

Once connected, try this prompt in your MCP client:

Show me my store's recent orders.