ShopSynch

Conecta asistentes de IA a ShopSynch para que los comerciantes puedan trabajar con productos, pedidos, clientes, inventario, pagos y análisis de la tienda.

Documentación

Conector MCP

ShopSynch expone un servidor público de Model Context Protocol para asistentes de IA, creadores de agentes y herramientas de desarrollo.

El conector permite que clientes de IA aprobados ayuden a los comerciantes a trabajar con su tienda ShopSynch a través de una conexión segura basada en permisos. Los casos de uso típicos incluyen información de la tienda, flujos de trabajo de productos, soporte de pedidos, contexto de clientes, verificaciones de inventario e informes operativos.

Perfil Oficial del Conector

Utilice este perfil al configurar un cliente MCP compatible o al preparar un envío del conector ShopSynch.

{
  "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"
}

Compatibilidad

ShopSynch funciona con clientes MCP que admiten MCP remoto sobre Streamable HTTP.

Tipo de clienteEstado
Clientes MCP remotos compatibles con OAuthCompatible
Conectores de Claude Desktop o Claude.aiCompatible cuando MCP remoto y OAuth están habilitados en el cliente
Cursor, Antigravity, VS Code e IDEs de agentesCompatible cuando el cliente acepta URL de servidores MCP remotos
Aplicación nativa de ChatGPTRequiere un paquete de aplicación ChatGPT y revisión del marketplace

La instalación nativa en el marketplace es independiente de la compatibilidad con MCP. Un cliente puede admitir el servidor MCP de ShopSynch directamente antes de aparecer como una aplicación instalable con un clic en el marketplace.

Autenticación

ShopSynch MCP utiliza OAuth para aplicaciones de IA de terceros y flujos oficiales de conectores.

Los comerciantes inician sesión en ShopSynch, revisan el acceso solicitado y aprueban la conexión antes de que un cliente de IA pueda acceder a los datos de la tienda. El acceso OAuth no elude los permisos de la cuenta ShopSynch, el alcance del inquilino ni las verificaciones de permisos por herramienta.

ShopSynch no recomienda compartir claves API privadas directamente con herramientas de IA de terceros.

Áreas de Herramientas Disponibles

Las herramientas MCP de ShopSynch se exponen por área de capacidad. La disponibilidad exacta de herramientas puede variar según la cuenta, los permisos, el entorno y la compatibilidad del cliente.

ÁreaEjemplos
AnalíticaMétricas de ingresos, pedidos, clientes y productos
ProductosListado de productos, detalles de productos, flujos de trabajo de catálogo, verificaciones de SKU
PedidosBúsqueda de pedidos, estado de pedidos, historial de pedidos, contexto de cumplimiento
ClientesBúsqueda de clientes y contexto de comportamiento de pedidos
InventarioVerificaciones de stock, estado de inventario, contexto de stock bajo
PagosBúsqueda de pagos, estado de pagos, contexto de enlaces de pago
CategoríasCategorías de tienda y clasificación de productos
Promociones y AnunciosContexto de promociones y campañas
ReseñasContexto de reseñas de tienda y productos
Operaciones de TiendaPerfil de tienda, almacenes, zonas de entrega y contexto operativo

Reglas de Seguridad

Al usar ShopSynch con un asistente de IA:

  • Revise lo que el asistente quiere hacer antes de aprobar cambios.
  • No comparta claves API privadas, contraseñas ni credenciales del panel en el chat.
  • Solo conecte clientes en los que confíe.
  • Revoque el acceso desde la configuración de su cuenta ShopSynch cuando ya no necesite un cliente.
  • Trate los datos de tienda, clientes, pedidos y pagos como confidenciales.

Inicio Rápido

Utilice las configuraciones a continuación para conectar ShopSynch directamente a su herramienta de IA. El servidor MCP utiliza OAuth por defecto: su herramienta abrirá una ventana del navegador para autorizar el acceso a su tienda la primera vez que se conecte.

Claude Desktop

Edite ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) o %APPDATA%\Claude\claude_desktop_config.json (Windows):

{
  "mcpServers": {
    "shopsynch": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://api.shopsynch.com/mcp"]
    }
  }
}

Reinicie Claude Desktop después de guardar. ShopSynch aparecerá en la lista de herramientas.

Cursor

Cree o edite .cursor/mcp.json en la raíz de su proyecto (o ~/.cursor/mcp.json globalmente):

{
  "mcpServers": {
    "shopsynch": {
      "url": "https://api.shopsynch.com/mcp"
    }
  }
}

Cursor le pedirá que se autentique con ShopSynch en el primer uso.

Antigravity / VS Code (MCP Remoto)

Cualquier cliente MCP que acepte una URL de servidor remoto puede conectarse directamente:

https://api.shopsynch.com/mcp

Transporte: streamable-http. No se requiere proceso local.

Claude Code (CLI)

claude mcp add --transport http shopsynch https://api.shopsynch.com/mcp

Autenticación con Clave API (Sin OAuth)

Si su herramienta o script no admite OAuth, puede usar un encabezado de clave API en su lugar:

X-MerchantApiKey: pk_live_<your-key>

Las claves API están disponibles en su panel de comerciante ShopSynch. Esto omite el flujo de consentimiento OAuth y autentica directamente la tienda propietaria de la clave.


Descubrimiento Legible por Máquina

Los hosts de agentes de IA y los indexadores MCP pueden descubrir automáticamente ShopSynch obteniendo:

GET https://api.shopsynch.com/.well-known/mcp.json

Esto devuelve un documento JSON con la URL del endpoint MCP, el tipo de transporte, los punteros de metadatos OAuth y las opciones de autenticación, sin necesidad de credenciales.

{
  "name": "shopsynch",
  "displayName": "ShopSynch",
  "description": "Connect AI assistants to ShopSynch...",
  "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",
    "alternativeHeader": "X-MerchantApiKey"
  },
  "documentationUrl": "https://docs.shopsynch.com/mcp"
}

Guías Relacionadas