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 cliente | Estado |
|---|---|
| Clientes MCP remotos compatibles con OAuth | Compatible |
| Conectores de Claude Desktop o Claude.ai | Compatible cuando MCP remoto y OAuth están habilitados en el cliente |
| Cursor, Antigravity, VS Code e IDEs de agentes | Compatible cuando el cliente acepta URL de servidores MCP remotos |
| Aplicación nativa de ChatGPT | Requiere 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.
| Área | Ejemplos |
|---|---|
| Analítica | Métricas de ingresos, pedidos, clientes y productos |
| Productos | Listado de productos, detalles de productos, flujos de trabajo de catálogo, verificaciones de SKU |
| Pedidos | Búsqueda de pedidos, estado de pedidos, historial de pedidos, contexto de cumplimiento |
| Clientes | Búsqueda de clientes y contexto de comportamiento de pedidos |
| Inventario | Verificaciones de stock, estado de inventario, contexto de stock bajo |
| Pagos | Búsqueda de pagos, estado de pagos, contexto de enlaces de pago |
| Categorías | Categorías de tienda y clasificación de productos |
| Promociones y Anuncios | Contexto de promociones y campañas |
| Reseñas | Contexto de reseñas de tienda y productos |
| Operaciones de Tienda | Perfil 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"
}