Skip to content

MCP Connector

ShopSynch exposes a public Model Context Protocol server for AI assistants, agent builders, and developer tools.

The connector lets approved AI clients help merchants work with their ShopSynch store through a secure, permission-based connection. Typical use cases include store insights, product workflows, order support, customer context, inventory checks, and operational reporting.

Official Connector Profile

Use this profile when configuring a compatible MCP client or preparing a ShopSynch connector submission.

json
{
  "name": "shopsynch",
  "displayName": "ShopSynch",
  "description": "Connect AI assistants to ShopSynch so merchants can work with products, orders, customers, inventory, payments, and store analytics.",
  "mcpUrl": "https://api.shopsynch.com/mcp",
  "transport": "streamable-http",
  "authentication": {
    "type": "oauth2",
    "authorizationServerMetadataUrl": "https://api.shopsynch.com/.well-known/oauth-authorization-server",
    "protectedResourceMetadataUrl": "https://api.shopsynch.com/.well-known/oauth-protected-resource",
    "pkce": true,
    "defaultScope": "mcp:store"
  },
  "privacyPolicyUrl": "https://www.shopsynch.com/privacy",
  "termsOfServiceUrl": "https://www.shopsynch.com/terms",
  "supportUrl": "https://www.shopsynch.com/contact"
}

Compatibility

ShopSynch works with MCP clients that support remote MCP over Streamable HTTP.

Client typeStatus
OAuth-aware remote MCP clientsSupported
Claude Desktop or Claude.ai connectorsSupported when remote MCP and OAuth are enabled in the client
Cursor, Antigravity, VS Code, and agent IDEsSupported when the client accepts remote MCP server URLs
ChatGPT native appRequires a ChatGPT app package and marketplace review

Native marketplace installation is separate from MCP compatibility. A client may support the ShopSynch MCP server directly before it appears as a one-click installable marketplace app.

Authentication

ShopSynch MCP uses OAuth for third-party AI apps and official connector flows.

Merchants sign in to ShopSynch, review the requested access, and approve the connection before an AI client can access store data. OAuth access does not bypass ShopSynch account permissions, tenant scoping, or per-tool permission checks.

ShopSynch does not recommend sharing private API keys directly with third-party AI tools.

Available Tool Areas

ShopSynch MCP tools are exposed by capability area. Exact tool availability may vary by account, permission, environment, and client support.

AreaExamples
AnalyticsRevenue, order, customer, and product metrics
ProductsProduct listing, product details, catalog workflows, SKU checks
OrdersOrder lookup, order status, order history, fulfillment context
CustomersCustomer lookup and order behavior context
InventoryStock checks, inventory status, low-stock context
PaymentsPayment lookup, payment status, payment link context
CategoriesStore categories and product classification
Promotions and AdsPromotion and campaign context
ReviewsStore and product review context
Store OperationsStore profile, warehouses, delivery zones, and operating context

Safety Rules

When using ShopSynch with an AI assistant:

  • Review what the assistant wants to do before approving changes.
  • Do not share private API keys, passwords, or dashboard credentials in chat.
  • Only connect clients you trust.
  • Revoke access from your ShopSynch account settings when a client is no longer needed.
  • Treat store, customer, order, and payment data as confidential.

Build with joy