MCP server

The YouCan MCP server connects AI assistants to a YouCan store. The assistant reads and changes the store through the Store Admin API: products, orders, customers, pages, coupons, shipping and more.

Setup

General

• Server URL: https://mcp.youcan.shop
• Transport: Streamable HTTP.
• Authentication: OAuth. After you add the server, your client opens the YouCan consent screen. Log in, select a store and approve.
• The connection gets full access to the selected store. Your client can ask you to confirm each change before it runs.

Claude

1. Open Settings, then Connectors.
2. Select Add custom connector.
3. Enter a name, for example YouCan, and the URL https://mcp.youcan.shop.
4. Select Connect and approve the connection.

ChatGPT

1. Open Settings, then Apps & Connectors.
2. Turn on developer mode in Advanced settings.
3. Create a connector with the URL https://mcp.youcan.shop and OAuth authentication.
4. Approve the connection.

Claude Code

claude mcp add --transport http youcan https://mcp.youcan.shop

Then run /mcp and select youcan to log in.

Cursor

Add to Cursor, or add the server to ~/.cursor/mcp.json:

{
  "mcpServers": {
    "youcan": {
      "url": "https://mcp.youcan.shop"
    }
  }
}

Visual Studio Code

Add the server to .vscode/mcp.json, then select Start above the server:

{
  "servers": {
    "youcan": {
      "type": "http",
      "url": "https://mcp.youcan.shop"
    }
  }
}

Others

Any client that supports remote MCP servers with OAuth can connect with the server URL. The client registers itself through dynamic client registration or a client ID metadata document. Its redirect URI must be an http loopback address (localhost, 127.0.0.1 or [::1], any port), or an HTTPS URI listed in its client ID metadata document.

Common use cases

Review today's orders

"List today's orders that are not fulfilled yet, with the customer name and the total."

Update prices

"Increase the price of every product in the Summer category by 10%."

Write product content

"Write a description and SEO title for the product Linen shirt, in French."

Launch a promotion

"Create a coupon SUMMER20 for 20% off, valid until the end of the month."

Build a landing page

"Create a landing page for the new collection with a hero banner, three featured products and a FAQ."

FAQ

Who can connect a store?

The store owner. Staff accounts cannot approve a connection.

Can I connect more than one store?

One connection gives access to one store. To use another store, add the server again and select that store on the consent screen.

My client shows "not an allowed redirect uri"

The client uses a redirect URI that the server does not accept. See Others for the accepted redirect URIs.

Tool calls fail with a 429 error

Each connection can make 120 tool calls per minute. Wait a minute and try again.

Tool calls fail after my store closed

A closed store rejects tool calls. Reopen the store from the seller area.