LaunchMyStore

npx add-mcp 'https://api.launchmystore.io/mcp'

Servidor MCP

Usa asistentes de IA para gestionar tu tienda LaunchMyStore mediante el Protocolo de Contexto de Modelo

Integración del Protocolo de Contexto de Modelo (MCP)

LaunchMyStore incluye un servidor MCP integrado para que los asistentes de IA — Claude Desktop, Claude Code, Cursor, OpenAI Codex y cualquier otro cliente compatible con MCP — puedan gestionar tu tienda mediante lenguaje natural.

El servidor soporta ambos transportes MCP en el mismo hostname:

• HTTP+SSE heredado (especificación MCP 2024-11-05) en /mcp/sse — Claude Desktop, Claude Code, Cursor.
• HTTP transmisible (especificación MCP 2025-03-26) en /mcp — OpenAI Codex y otros clientes más nuevos basados en SDK.

Elige el transporte que coincida con tu cliente; ambos exponen exactamente las mismas herramientas, recursos y autenticación.

Nota

¿Usas Claude en la web o móvil (claude.ai)? Los conectores personalizados se autentican con OAuth en lugar de un token pegado — consulta Conector personalizado de Claude.ai.

Nota

Nova AI y MCP comparten las mismas herramientas. Ambas interfaces usan las mismas definiciones de herramientas, por lo que cualquier capacidad disponible en Nova AI también está disponible a través de MCP. Este documento cubre la configuración de MCP — para detalles de herramientas, consulta Herramientas de Nova AI.

¿Qué es MCP?

El Protocolo de Contexto de Modelo es un estándar abierto que permite a los asistentes de IA llamar herramientas externas y leer recursos externos. Con MCP conectado a tu tienda, puedes:

• Pedir a la IA que actualice precios de productos o inventario
• Crear y gestionar códigos de descuento mediante conversación
• Obtener análisis de ventas y paneles
• Gestionar pedidos y cumplimientos
• Actualizar configuración de tienda, contenido y temas

Inicio rápido

1. Genera un token MCP

1. Abre el panel de administración de LaunchMyStore.
2. Navega a Configuración → Conector de IA (MCP).
3. Haz clic en Generar token.
4. Copia el token mostrado — es una cadena opaca larga válida por 1 año.

Advertencia

Trata el token MCP como una contraseña. Cualquiera que lo tenga puede llamar al servidor MCP como tú. Nunca lo pegues en un repositorio público, captura de pantalla o chat.

Para revocar un token, cambia la contraseña de tu cuenta — cada token MCP emitido antes del cambio de contraseña deja de funcionar inmediatamente. Aún no exponemos revocación por token; esto está en la hoja de ruta.

2. Añade el servidor a tu cliente MCP

Elige el fragmento que coincida con tu cliente. La página de administración (Configuración → Conector de IA (MCP)) genera cada uno preconfigurado con tu token — haz clic en el botón Copiar en la pestaña correspondiente.

Claude Desktop / Claude Code / Cursor (SSE)

Claude Desktop, Claude Code y Cursor usan el transporte SSE heredado, por lo que todos comparten el mismo fragmento JSON que apunta a /mcp/sse:

{
  "mcpServers": {
    "launchmystore": {
      "type": "sse",
      "url": "https://api.launchmystore.io/mcp/sse",
      "headers": {
        "Authorization": "Bearer YOUR_MCP_TOKEN"
      }
    }
  }
}

Claude Desktop — edita claude_desktop_config.json:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json

Pega el fragmento, guarda y reinicia Claude Desktop.

Claude Code — crea un .mcp.json en la raíz de tu proyecto (o añade a ~/.claude.json para ámbito de usuario), pega el fragmento y ejecuta /mcp dentro de Claude Code para confirmar la conexión.

Cursor — abre la configuración de Cursor (Cmd+, / Ctrl+,), busca MCP y pega el fragmento en tu configuración de servidores MCP.

OpenAI Codex (HTTP transmisible)

Codex habla el transporte HTTP transmisible más nuevo, por lo que apunta a /mcp (no /mcp/sse) y usa TOML en lugar de JSON. El token se carga desde una variable de entorno en lugar de estar incrustado.

1. Edita ~/.codex/config.toml y añade:

[mcp_servers.launchmystore]
url = "https://api.launchmystore.io/mcp"
bearer_token_env_var = "LAUNCHMYSTORE_MCP_TOKEN"
startup_timeout_sec = 30

2. Exporta el token en el shell donde lanzas Codex:

export LAUNCHMYSTORE_MCP_TOKEN="YOUR_MCP_TOKEN"

3. Reinicia Codex.

Advertencia

No apuntes Codex a /mcp/sse — ese es el handshake SSE heredado de dos endpoints y Codex fallará con Deserialize error: data did not match any variant of untagged enum JsonRpcMessage. Codex debe usar /mcp.

3. Prueba algunos comandos

• "Muéstrame mis productos más vendidos este mes"
• "Crea un código de descuento del 20% para nuevos clientes"
• "Actualiza el precio de 'Camiseta Clásica' a $29.99"
• "¿Qué pedidos necesitan cumplimiento hoy?"

Herramientas disponibles

El servidor MCP expone las mismas herramientas que Nova AI, organizadas por categoría:

Listar, crear, actualizar y eliminar productos y variantes Ver pedidos, crear pedidos manuales, actualizar estado, reembolsos Organizar productos con categorías Ver y gestionar datos de clientes Informes de ventas, datos de tráfico, análisis de productos Crear y gestionar códigos de descuento Gestión de contenido para blogs y páginas personalizadas Configuración de temas, secciones y bloques Gestión de menús de navegación Envío, pago y configuración de tienda

Para una lista completa de herramientas con parámetros, consulta la Referencia de herramientas.

Endpoints

Método	Ruta	Propósito
GET	/mcp/info	Descubrimiento público. Devuelve información del servidor, capacidades y el mapa de endpoints.
POST	/mcp/token	Emite un token MCP de 1 año para el comerciante autenticado.
GET	/mcp/config	Devuelve un fragmento de configuración listo para pegar (?client=claude|claudeCode|cursor|codex). Si no se proporciona una consulta token, emite uno nuevo.
GET	/mcp/sse	Transporte SSE heredado. Abre el flujo de eventos MCP. El primer evento entregado es endpoint, cuyos datos son la URL de mensajes a la que el cliente debe hacer POST.
POST	/mcp/sse/message?sessionId=…	Transporte SSE heredado. Envía una solicitud JSON-RPC vinculada a una sesión SSE abierta. Devuelve 202 Aceptado; la respuesta se envía de vuelta a través del flujo SSE como un event: message.
POST	/mcp	Transporte HTTP transmisible. JSON-RPC sobre HTTP. Las solicitudes devuelven 200 con application/json. Las notificaciones devuelven 202 Aceptado sin cuerpo. Soporta matrices por lotes.
GET	/mcp	Transporte HTTP transmisible. Usado por clientes que quieren un flujo iniciado por el servidor. LaunchMyStore no tiene estado y no envía nada, por lo que devuelve 405 (permitido por la especificación).
DELETE	/mcp	Transporte HTTP transmisible. Gancho de terminación de sesión. LaunchMyStore no emite Mcp-Session-Id, por lo que es una operación nula que siempre devuelve 200.
GET	/mcp/tools	Lista cada herramienta que la IA puede llamar.
GET	/mcp/resources	Lista recursos de solo lectura.
GET	/mcp/docs	Devuelve el catálogo completo de herramientas como markdown.

Verificación del servidor

curl https://api.launchmystore.io/mcp/info

Respuesta:

{
  "name": "launchmystore-mcp",
  "version": "1.0.0",
  "protocolVersion": "2025-03-26",
  "serverUrl": "https://api.launchmystore.io",
  "capabilities": {
    "tools": { "listChanged": false },
    "resources": { "subscribe": false, "listChanged": false },
    "prompts": { "listChanged": false },
    "logging": {}
  },
  "endpoints": {
    "jsonrpc": "/mcp",
    "sse": "/mcp/sse",
    "token": "/mcp/token",
    "config": "/mcp/config"
  },
  "documentation": "https://docs.launchmystore.io/mcp/overview"
}

Detalles del transporte

HTTP+SSE heredado (Claude Desktop, Claude Code, Cursor)

El transporte SSE sigue la especificación MCP 2024-11-05:

1. El cliente abre GET /mcp/sse con Authorization: Bearer ….
2. El servidor emite inmediatamente event: endpoint\ndata: /mcp/sse/message?sessionId=<id>\n\n.
3. El cliente hace POST de cada solicitud JSON-RPC a esa URL de mensajes con el mismo encabezado Bearer. Cada POST devuelve 202 Aceptado sin cuerpo.
4. El servidor envía la respuesta JSON-RPC correspondiente de vuelta sobre el flujo SSE original como event: message\ndata: <json>\n\n.
5. Los latidos (: heartbeat <ts>) evitan que los proxies dejen la conexión inactiva.

HTTP transmisible (OpenAI Codex)

Codex (y cualquier otro cliente que implemente el transporte HTTP transmisible MCP 2025-03-26) habla con el único endpoint /mcp:

1. El cliente hace POST de solicitudes JSON-RPC a /mcp con Authorization: Bearer …. Las solicitudes que tienen un id reciben una respuesta 200 con Content-Type: application/json que contiene la respuesta JSON-RPC. Se soportan matrices por lotes.
2. Notificaciones (mensajes JSON-RPC sin id, como notifications/initialized) reciben 202 Aceptado sin cuerpo — según la especificación JSON-RPC 2.0, el servidor NO DEBE responder a una notificación.
3. initialize negocia la versión del protocolo: el servidor repite la versión solicitada por el cliente cuando es una de 2024-11-05, 2025-03-26 o 2025-06-18, de lo contrario vuelve a su valor predeterminado.
4. GET /mcp devuelve 405 (no tenemos estado y no enviamos mensajes iniciados por el servidor — explícitamente permitido por la especificación).
5. DELETE /mcp devuelve 200 (no emitimos Mcp-Session-Id, por lo que no hay nada que liberar).

Puedes acceder a cualquiera de los dos transportes con curl. Solicitud/respuesta simple con el endpoint HTTP transmisible:

curl -X POST https://api.launchmystore.io/mcp \
  -H "Authorization: Bearer YOUR_MCP_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "id": "1",
    "method": "tools/list",
    "params": {}
  }'

Seguridad

• Los tokens están limitados a una sola cuenta de comerciante y heredan el rol y los permisos de esa cuenta.
• Las llamadas a herramientas respetan el mismo modelo de autorización que las API REST subyacentes — si un rol no puede eliminar productos en el panel de administración, la IA tampoco puede eliminarlos.
• Cambiar la contraseña de la cuenta invalida cada token MCP emitido en un solo paso.
• Todas las llamadas a herramientas MCP quedan registradas en tu registro de auditoría con source: "mcp".

Solución de problemas

El cliente muestra "Conectando…" para siempre (Claude Desktop / Claude Code / Cursor)

Asegúrate de que tu fragmento incluya "type": "sse" y apunte a /mcp/sse (no /mcp). El endpoint /mcp de HTTP transmisible no abrirá un flujo de eventos para estos clientes — esperan el handshake SSE heredado de dos endpoints.

Codex: Deserialize error: data did not match any variant of untagged enum JsonRpcMessage

Apuntaste Codex a /mcp/sse. El handshake SSE heredado envía un marco event: endpoint como su primer mensaje, que el analizador de HTTP transmisible de Codex no puede interpretar. Cambia url en ~/.codex/config.toml de https://api.launchmystore.io/mcp/sse a https://api.launchmystore.io/mcp.

Codex: Transport channel closed, when send initialized notification

Tu backend está en una versión anterior que devuelve una respuesta JSON-RPC a las notificaciones. El endpoint /mcp ahora devuelve 202 Aceptado sin cuerpo para cualquier carga útil sin un id, que es lo que Codex espera. Si te autoalojas, obtén el backend más reciente.

"No autorizado" / 401

Tu token no es válido o ha caducado. Genera uno nuevo desde Configuración → Conector de IA (MCP).

Las herramientas no aparecen

1. Confirma que la conexión está abierta en tu cliente (Claude Code: /mcp).
2. Prueba curl https://api.launchmystore.io/mcp/info para verificar que el servidor es accesible.
3. Asegúrate de que tu rol tenga acceso a las herramientas que esperas.

Permiso denegado en una herramienta específica

El rol vinculado a tu token MCP no tiene permiso para esa operación. Usa una cuenta de administrador u otorga el permiso correspondiente.