Conecta tu tienda Shopify a Claude y ChatGPT.

Un servidor MCP remoto, uno por tienda. Cada tienda que conectas a BoostEcom recibe su propio endpoint, que habla Model Context Protocol sobre HTTP en streaming. Cualquier cliente que hable MCP (Claude, ChatGPT, Claude Code, Cursor o uno que hayas escrito tú) puede descubrirlo, autorizarse y llamar a sus herramientas.

Tus credenciales de Shopify nunca salen de nuestros servidores. El cliente guarda un token de BoostEcom; el token de Shopify de corta duración que delega la app BoostEcom se queda con nosotros, cifrado en reposo. Revoca el token de BoostEcom y el cliente queda fuera, sin haber visto nunca un secreto de Shopify.

• MCP, desde tu cliente de IAClaude, ChatGPT, Claude Code y Cursor leen la tienda en directo, con OAuth o con una clave estática. Solo lectura.
• El panel, con @AtlasEl único lugar donde se escribe, siempre después de tu aprobación. La misma tienda, la misma app BoostEcom.
• Intelligence, desde tu cliente o tu códigoEl grafo de tiendas Shopify tiene su propio servidor MCP y una API REST de solo lectura con una clave bei_. Datos de mercado, nunca los de tu tienda.
• Un perfil UCP públicoCuando BoostEcom lee el catálogo público de otra tienda, presenta este perfil: solo búsqueda y consulta del catálogo, sin carrito, sin checkout, sin secretos.

https://www.boostecom.app/api/mcp/v1/<STORE_ID>

https://www.boostecom.app/api/mcp/intelligence

https://www.boostecom.app/.well-known/ucp-agent

Instalas la app BoostEcom desde tu admin de Shopify y eliges en la app a qué puede acceder. Tu autorización es el techo: no añadimos ningún acceso propio.

• OAuth 2.1 con PKCE, sin secreto de cliente que guardar
• Cada token abre una sola tienda y se almacena como hash
• Una clave estática para la CI y las ejecuciones sin navegador

https://www.boostecom.app/api/mcp/v1/<STORE_ID>

GET https://www.boostecom.app/.well-known/oauth-authorization-server
GET https://www.boostecom.app/.well-known/oauth-protected-resource/api/mcp/v1/<STORE_ID>
GET https://www.boostecom.app/api/mcp/<STORE_ID>/.well-known/oauth-protected-resource

1. 1

   Tu cliente llama al endpoint sin token y recibe un 401 cuya cabecera WWW-Authenticate apunta a nuestros documentos de descubrimiento (RFC 9728).

2. 2

   Lee el documento del recurso protegido, que designa este origen como servidor de autorización.

3. 3

   Lee los metadatos del servidor de autorización (RFC 8414) para encontrar los endpoints de registro, autorización, token y revocación.

4. 4

   Se identifica con un Client ID Metadata Document, una URL https que descargamos y verificamos, o con registro dinámico (RFC 7591). No se emite ningún secreto y PKCE S256 es obligatorio.

5. 5

   Apruebas una pantalla de consentimiento que nombra los permisos en lenguaje claro y solo muestra los que pueden cubrir los accesos de la app BoostEcom.

6. 6

   El cliente cambia su código de un solo uso por un token de acceso que caduca a los 60 minutos y un token de actualización que rota en cada uso.

7. 7

   Una herramienta fuera de la autorización responde 403 con el scope exacto que hay que pedir: el cliente se vuelve a autorizar solo para ese scope y reintenta.

8. 8

   Desconecta el cliente y llama al endpoint de revocación (RFC 7009): el token muere también de nuestro lado, no solo en la memoria del cliente.

Cada token abre una sola tienda: un token emitido para la tienda A se rechaza en la tienda B, y la pertenencia a la organización se vuelve a comprobar en cada llamada. Los tokens se guardan como hashes SHA-256, nunca en una forma que podamos volver a leer.

HTTP/1.1 401 Unauthorized
WWW-Authenticate: Bearer realm="BoostEcom MCP",
  resource_metadata="https://www.boostecom.app/.well-known/oauth-protected-resource/api/mcp/v1/<STORE_ID>",
  scope="boostecom:store.read boostecom:catalog.read …"

{
  "access_token": "<ACCESS_TOKEN>",
  "token_type": "Bearer",
  "expires_in": 3600,
  "refresh_token": "<REFRESH_TOKEN>",
  "scope": "boostecom:store.read boostecom:catalog.read"
}

HTTP/1.1 403 Forbidden
WWW-Authenticate: Bearer error="insufficient_scope",
  scope="boostecom:orders.read",
  resource_metadata="https://www.boostecom.app/.well-known/oauth-protected-resource/api/mcp/v1/<STORE_ID>"

• Escrituras rechazadas antes de llegar a Shopify
• Cada intento de escritura queda en tu registro de auditoría
• Los cambios pasan por la aprobación del panel

tools/call shopifyAdminGraphQL

mutation {
  productUpdate(product: { id: "gid://shopify/Product/1", title: "New title" }) {
    product { id }
  }
}

{
  "isError": true,
  "content": [
    {
      "type": "text",
      "text": "Refused: this mutation is classified destructive (product/price updates, discounts, inventory, …). This connector is read-only: every write requires human approval. Run it from the BoostEcom dashboard chat, where the approval flow lives."
    }
  ]
}

• El estado de la tiendaUna sola llamada a runAudit devuelve la tienda, sus temas y una muestra de productos, para que el modelo razone sobre el conjunto en vez de coser cuatro peticiones.
• Preguntas de catálogoQué productos siguen en borrador, qué está agotado, qué handles chocan: respondido con datos en directo, no con una exportación vieja pegada en un chat.
• Todo lo que lee la Admin APIMetacampos, mercados, traducciones, inventario: una sola herramienta puente, con las cifras de coste de Shopify devueltas para que el modelo regule su ritmo.
• Informes donde trabajasResume los pedidos de la semana en el cliente que ya tienes abierto, sin exportar antes los datos de clientes a una hoja de cálculo.

• Los scopes que concediste a la app BoostEcom deciden qué pasa, y Shopify los aplica en cada consulta
• Las cifras de coste y de límite de Shopify vuelven con los datos, para que el modelo regule su ritmo
• Una mutación enviada por ella se rechaza como cualquier otra escritura

tools/call shopifyAdminGraphQL

query {
  markets(first: 5) { nodes { name handle } }
  shop { metafields(first: 5) { nodes { key value } } }
}

{
  "data": { "markets": { … }, "shop": { … } },
  "cost": { "requestedQueryCost": <n>, "actualQueryCost": <n> },
  "throttleStatus": {
    "maximumAvailable": <n>,
    "currentlyAvailable": <n>,
    "restoreRate": <n>
  }
}

1. 1

   Conectar la tienda

   Crea tu cuenta e instala la app BoostEcom desde tu admin de Shopify, en un clic. Los accesos que elijas en la app ponen el techo a todo lo demás.

   Permisos de Shopify que abren herramientas

   • read_products
   • read_orders
   • read_content
   • read_themes
   • read_analytics
   • read_reports
2. 2

   Pegar la URL en tu cliente

   Claude y ChatGPT la aceptan como conector personalizado. Claude Code y Cursor la leen en su configuración y después abren la misma pantalla de consentimiento.

   La URL que debes pegarurl

   https://www.boostecom.app/api/mcp/v1/<STORE_ID>

   Copiar
3. 3

   Aprobar los scopes

   La pantalla de consentimiento describe cada permiso con palabras claras y solo ofrece lo que concediste a la app BoostEcom.

   Lo que pide tu clientehttp

   GET https://www.boostecom.app/oauth/authorize
     ?response_type=code&client_id=<CLIENT_ID>
     &resource=https://www.boostecom.app/api/mcp/v1/<STORE_ID>
     &scope=boostecom:store.read boostecom:catalog.read
     &code_challenge=<S256>&code_challenge_method=S256

   Copiar
4. 4

   Consultar tu tienda

   Tu cliente muestra las herramientas que ha abierto tu autorización y las llama cada vez que una pregunta necesita datos en tiempo real.

   Lo que tu cliente puede ver

   • getStoreContext
   • getShopInfo
   • runAudit
   • listProducts
   • getProduct
   • listOrders
   • listPages
   • getMetafields
   • listMetaobjectDefinitions
   • listMetaobjects
   • listThemes
   • getTheme
   • runShopifyQL
   • introspectSchema
   • shopifyAdminGraphQL
   • getStudioSection
   • getStudioProduction
   • listStudioGenerations
   • getStudioPricing
   • getStoreIntelligence
   • listThemeUpdates
   • getUpdateJob
   • listBackups
   • getUptime
   • getAppEmbedStatus
   • getDomainHealth
   • getActionRequest
   • searchDocs
   • getDoc
   • helmListModels
   • helmPlanSection

Los tokens emitidos antes de este catálogo llevan la antigua autorización mcp. Conserva las herramientas de lectura de Shopify que ya tenía y nunca abre un sistema de BoostEcom: Studio, la ficha de Intelligence y las herramientas de documentación necesitan un scope aprobado en la pantalla de consentimiento.

• Sin cuenta ni clave: 60 llamadas por minuto y por IP
• Una clave bei_ lo sube a 6000 por minuto, por organización
• Solo fichas públicas

{
  "mcpServers": {
    "boostecom-intelligence": {
      "url": "https://www.boostecom.app/api/mcp/intelligence"
    }
  }
}

curl -s https://www.boostecom.app/api/mcp/intelligence/manifest

Ver qué lee Intelligence

Medido en una tienda conectada mediante la Custom App de un comerciante: una tienda que concede menos scopes obtiene menos. Con la app BoostEcom, el techo es lo que concedes a la app.

Los planes Custom no tienen límite. Una llamada rechazada indica el plan, el límite alcanzado y qué hacer a continuación.

• No escribe. Toda escritura se rechaza y queda registrada. Un cambio en tu tienda pasa por el panel, donde lo apruebas tú.
• No sale de lo que concediste a la app. Una herramienta que tu permiso de Shopify no puede cubrir nunca se registra, así que tu cliente nunca llega a verla.
• Una clave estática se queda en 15 herramientas. Una clave identifica una tienda, nunca a una persona. Studio, la ficha de Intelligence de la tienda, los registros de la app BoostEcom y las herramientas de documentación necesitan un inicio de sesión OAuth.
• Una petición, 30 segundos. Una llamada a herramienta más larga se corta. El trabajo largo va en un workflow del panel, no en una llamada a herramienta.
• Sin API ni SDK propios. Las superficies admitidas son este endpoint, el servidor MCP de Intelligence y la API REST de Intelligence. El GraphQL al que llegas es el de Shopify, a través del puente.