Logotipo de SAL 91
SAL 91
Prueba 15 días

Especificación MCP (Model Context Protocol)

Servidores MCP Oficiales de PhoenixCartWMS

Conecta asistentes como Claude, ChatGPT, Cursor o flujos autónomos en n8n directamente a los datos y operaciones de tu negocio mediante el estándar abierto Model Context Protocol.

🌐

1. MCP Público de Tienda

Sin llave API. Los clientes agregan tu tienda a su asistente personal para buscar por significado con embeddings y consultar saldo con código OTP de 8 dígitos.

/api/v1/mcp/publico/:id
🏢

2. MCP Privado por Llave

Para tu equipo interno y automatizaciones con n8n. Cada llave tiene su propia URL dedicada para registrar múltiples conectores en Claude sin colisiones.

/api/v1/mcp/:key_id
⚡

3. MCP de Plataforma

Para superadministradores del SaaS: permite crear empresas, asignar planes, verificar estados de servidor y gestionar altas con comandos de lenguaje natural.

tipo: platform_mcp

Modalidad 1: Servidor MCP Público de Tienda

Cada tienda virtual en /sistema/sdk-web cuenta con su propio servidor público MCP sin requerir llave API. Los clientes conectan Claude o ChatGPT y usan 10 herramientas públicas de consulta:

Herramientas de Catálogo

  • get_store_info — Nombre, giro y políticas de la tienda.
  • search_store_products — Búsqueda por significado (IA) y texto.
  • get_store_product — Ficha completa con precios y existencias.
  • list_store_categories — Árbol de categorías activas.
  • list_store_promotions — Ofertas vigentes y cupones.
  • search_store_faqs — Preguntas frecuentes y garantías.

Herramientas de Cuenta Segura

  • start_customer_login — Entrega el enlace /p/:slug/asistente.
  • verify_login_code — Canjea el código de 8 dígitos por token de 7 días.
  • get_my_account — Saldo a favor, apartados y pedidos web.
  • end_customer_session — Cierre de sesión inmediato.

Flujo de Autenticación sin Contraseñas

  1. El asistente da a la persona el enlace /p/<slug>/asistente.
  2. Con la sesión iniciada en la tienda, el cliente ve un código OTP de 8 caracteres (válido 10 minutos).
  3. El cliente dicta el código al asistente, y este lo canjea por un token firmado de 7 días.

Modalidad 2: Configuración en Claude Desktop & Cursor

Para conectar Claude Desktop en tu computadora a tu servidor MCP privado, agrega la siguiente configuración en tu archivo claude_desktop_config.json: 

{
  "mcpServers": {
    "phoenix_cart_wms": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://tu-dominio.com/api/v1/mcp/tu_id_de_llave_aqui",
        "--header",
        "Authorization: Bearer tu_llave_secreta_aqui"
      ]
    }
  }
}
⚠️ Regla de URL propia: Cada llave generada en /sistema/api-integraciones tiene su propia URL con /api/v1/mcp/:id. Esto permite agregar en Claude múltiples empresas o puestos sin que Claude rechace el conector por duplicidad de URL.

Integración con n8n y Agentes Autónomos

PhoenixCartWMS incluye plantillas listas para importar en n8n utilizando el nodo nativo MCP Tool:

  • Transporte: HTTP Server-Sent Events / JSON-RPC 2.0.
  • Autenticación: Bearer Token en cabecera HTTP.
  • Descubrimiento automático: n8n consulta el manifiesto en /api/v1/mcp/:id/manifest y detecta todas las herramientas autorizadas para esa llave.
  • Doble confirmación para escritura: herramientas como stamp_sale_invoice o charge_account requieren el parámetro confirm: true y una frase de confirmación explícita para evitar ejecuciones accidentales.

Explora el resto del sistema

Explora cómo PhoenixCartWMS unifica tecnología, inventario y ventas en una sola suite.

Conecta tus agentes inteligentes y automatiza tu empresa hoy

Crea tu cuenta de prueba de 15 días y obtén tu primera llave MCP para Claude Desktop o n8n en 2 minutos.

También puedes revisar accesibilidad y control por voz con ia y comunicación inclusiva y ventas con ia.

Crear cuenta gratis Iniciar sesión