Connect Claude to your Zoey store (MCP Server)
Overview
The Zoey MCP Server lets Claude, and other AI assistants that support the Model Context Protocol (MCP), work directly with your store. Once connected, you can ask Claude in plain language to look up orders, invoices, customers, company accounts and inventory, and to make changes you ask for, such as adding tracking to a shipment or updating stock.
Every store has its own MCP Server built in, so there is nothing to install. An admin connects it once and approves it, and Claude can only do what that admin's API permissions allow. You can see and disconnect connected apps at any time in Settings > MCP Server.
Connect Claude
You need a Zoey admin login and a Claude account that can add custom connectors. Connecting takes about a minute.
- In your Zoey admin, go to Settings > MCP Server and click Copy next to the Connector URL. It looks like
https://yourstore.com/mcp. - In Claude, add a custom connector and paste the Connector URL.
- Click Connect. Claude opens your Zoey admin login in a new window.
- Sign in. You'll see "Claude (auto-registered) requests access to your account."
- Review the request and click Authorize. You're returned to Claude, and the connector shows as connected.
- Ask Claude something about your store, for example: "Show me the 5 most recent orders."
The app now appears under Connected apps in Settings > MCP Server, with the date it connected and when it was last used.
Only click Authorize if you started the connection yourself. The consent screen tells you which site you'll be returned to.
What Claude can do
Claude works through the Zoey REST API, so it can do the same things as an API integration, within the permissions of the admin who connected it.
| Area | What Claude can do | Example request |
|---|---|---|
| Orders | Find orders by number or customer email; view items, addresses and comments; add comments; set order attributes; change the order's customer; cancel orders; manage custom order statuses | "Show the last 10 orders from [email protected] and which haven't shipped." |
| Invoices | Create invoices; look up and list invoices; add comments; email or print them | "Invoice everything on order 100000180 and email the customer." |
| Shipments | Create shipments with tracking; add tracking to a shipment; list carriers; add comments; email or print | "Ship order 100000346 with UPS tracking 1Z999AA10123456784." |
| Credit memos | Create credit memos (refunds); list them; add comments | "Refund 2 units of item 311 on order 100000180." |
| Bills | Send, view, email or print bills | "Email the bill for order 1500000063 again." |
| Quotes | List and open quotes; create a quote; set its customer, products, addresses, shipping and payment; check totals; add comments; submit it; convert it to an order | "Create a quote for Acme with 50 units of SKU ABC-1 and submit it." |
| Placing orders | Build a cart for a customer, with custom prices if needed; set addresses, shipping and payment; check totals; place the order; create, email or remove draft orders | "Place an order for customer 42: 10 of SKU ABC-1, ship flat rate, pay by PO 8675." |
| Customers | Find, create and update customers and their addresses; manage net terms and customer groups; send account invites; see a customer's ordered items | "Which customers are pending approval?" |
| Company accounts | List, create and update accounts; view roles and location addresses; see an account's ordered items | "What has Acme ordered in the last 3 months?" |
| Products and categories | Find products by ID or SKU; create, update, bulk-update or delete products; manage product categories, images and related products; view and edit the category tree | "Change the price of SKU ABC-1 to $24.99." |
| Inventory | View and update stock, one product or in bulk; manage inventory locations | "Set stock to 0 for these 12 SKUs." |
| Attributes and settings | View, create and update custom attributes; view payment method settings | "What custom attributes do we have on orders?" |
Claude finds the right API call for your request on its own. For a change, it shows you what it's about to do before it does it.
What Claude can't do yet
The MCP Server covers what the Zoey REST API covers. These areas aren't available through it yet:
- Promotions and catalog price rules
- CMS pages, blog, theme and design
- Store settings, other than viewing payment methods
- Email templates, team and admin users, integrations, data mappers and imports
- Uploading files, other than product images
Claude can summarize data it reads, but it reads in pages, so large analyses across thousands of records aren't reliable. For totals and trends, use Reports in the Zoey admin.
Security and permissions
Claude only gets access after an admin signs in and approves it, and it never sees your password.
- Admin approval. Anyone can start a connection, but nothing is shared until a store admin signs in and clicks Authorize.
- Your permissions, not more. Claude acts as the admin who approved it, limited by that admin's REST API role. To give Claude less access, connect it with an admin whose role allows less.
- Changes need confirmation. Lookups are marked read-only. Creates and updates are marked as changes, and deletes and cancellations are marked destructive, so Claude asks before running them. You can set Claude to always ask before using a connector's tools.
- Disconnect any time. In Settings > MCP Server, click Disconnect next to an app. Its access ends immediately.
- Sessions. Claude's access refreshes automatically while you use it. If a connection goes unused for 2 weeks, reconnect it from Claude.
- Activity. Settings > MCP Server shows when each connected app was last used.
Settings reference
Find these in Settings > MCP Server. Click Save Settings after changing them.
| Setting | Default | What it does |
|---|---|---|
| Allow AI apps to connect | Yes | Lets apps such as Claude register themselves with your store. Each one still needs admin approval. Turning it off stops new connections but does not disconnect existing apps. |
| Allow desktop and command-line apps | Yes | Allows apps that run on your own computer, such as Claude Code, to finish signing in on your computer (localhost). |
| Allowed redirect URLs | Claude's sign-in URLs | Advanced. The exact https URLs a self-registered app may return you to after you approve it, one per line. Only add URLs for AI apps you trust. |
The page also shows your Connector URL and the list of Connected apps, with each app's name, the site it returns to, when it connected, when it was last used, its status, and a Disconnect button.
Troubleshooting and FAQ
Claude says it can't connect, or the connection fails right away. Check that "Allow AI apps to connect" is set to Yes in Settings > MCP Server, and that you copied the Connector URL exactly, including /mcp.
Claude connects, but a request fails with "Access denied" (403). The admin who approved the connection doesn't have API permission for that area. Update that admin's REST role, or disconnect and reconnect with an admin who has the access.
Claude asks me to reconnect. The connection went unused for 2 weeks, or it was disconnected in Settings > MCP Server. Click Connect in Claude and approve it again.
I see an app under Connected apps that I don't recognize. Click Disconnect. An app can't access anything until an admin approves it, but if you didn't start the connection, remove it.
Can I connect more than one AI app? Yes. Each one appears separately under Connected apps and can be disconnected on its own.
Does Claude see all my data? Claude only reads what you ask for, and only what the approving admin's API role allows.
Can I stop AI apps from connecting at all? Yes. Set "Allow AI apps to connect" to No and disconnect any apps already listed.
Updated about 3 hours ago