Conectar por MCP

Qué resuelve

MCP es el enchufe estándar entre un asistente de IA y las herramientas de un sistema. Con esta integración, un asistente que ya usás —Claude Desktop, Claude Code, Cursor— ve las herramientas de tu comercio con tus datos reales: buscar en tu catálogo, cotizar un envío, ver las opciones de entrega a una provincia, consultar el estado de un pedido, validar un DNI, y registrar un pedido a nombre de un cliente.

Es la misma caja de herramientas que usa el agente de ventas de Smarty, con la misma política adelante: lo que está apagado para el agente está apagado por acá también.

Cómo se configura

1. En el panel, entrá a Ajustes → Integraciones → Conectar por MCP.
2. Tocá Crear credencial y ponele un nombre (por ejemplo, «Claude Desktop de Luan»).
3. Copiá la credencial — se muestra una sola vez. Guardamos sólo una huella, no la clave: si la perdés, revocá esa y creá otra.
4. Tocá Copiar configuración y pegala en el archivo de tu cliente.

📸 Falta captura

Pantalla Conectar por MCP con el modal «Tu credencial — copiala ahora» abierto.

Abrir Conectar por MCP en mi panel

Dónde va la configuración

La pantalla ya te arma el bloque con la credencial adentro. Es este, para claude_desktop_config.json (Claude → Configuración → Desarrollador):

{
  "mcpServers": {
    "smarty-comercio": {
      "type": "http",
      "url": "https://<tu-proyecto>.supabase.co/functions/v1/mcp-comercio",
      "headers": { "Authorization": "Bearer smk_…" }
    }
  }
}

Reiniciá el cliente y las herramientas de tu comercio aparecen en la lista.

Qué puede hacer un cliente conectado

Herramienta	Qué hace
search_products	Busca en tu catálogo, con precios reales.
quote_shipping	Cotiza un envío a un destino: reparto o agencia, y el adelanto si corresponde.
opciones_de_entrega	Las agencias disponibles en una provincia.
get_order_status	El estado de un pedido, por su número.
lookup_dni	Nombres y apellidos a partir de un DNI.
create_cod_order	Registra un pedido contra entrega en nombre de un cliente.

Registrar un pedido desde tu asistente

create_cod_order pide lo mínimo para que el pedido quede a nombre de alguien: el WhatsApp del cliente (en formato internacional, +51…), sus nombres, los productos por id de tu catálogo (los ids los da search_products) y el destino: departamento, provincia, distrito y una dirección (reparto) o una agencia (recojo).

Lo que no pide, a propósito: precios. El precio, el envío y el adelanto los calcula tu comercio con tu política, igual que cuando vende el agente. Un asistente no puede registrar un pedido a un precio que no existe.

Tres reglas que el asistente ve al listar la herramienta:

• La misma llamada repetida es un solo pedido. Si el asistente reintenta, no se duplica.
• Un pedido por cliente cada 24 horas. El segundo para el mismo WhatsApp vuelve con el número del pedido que ya está y pide que lo registre una persona desde el panel.
• Si el pedido está apagado desde operación, no sale — la misma llave que frena al agente de ventas.

En Operaciones, el pedido aparece con origen «Asistente MCP» y una nota [MCP], para que se distinga de los que entran por WhatsApp o por la tienda.

Las demás acciones que cambian pedidos o cobran (mandar datos de pago, verificar un comprobante, editar un pedido) no están habilitadas por esta vía: pedirlas por su nombre devuelve un error y no ejecuta nada.

Cada llamada deja rastro

Toda llamada que hace un cliente conectado —consulta o pedido— queda anotada con la credencial que la hizo, la herramienta, el cliente al que se refería, si salió bien y cuánto tardó. Sin los datos personales que pasaron por ahí: ni DNI ni dirección.

Revocar

Cada credencial se revoca desde la misma pantalla, con un clic. El cliente que la usaba deja de entrar en ese instante. La fila queda en la lista como historia, con su fecha.

Seguridad, dicho en simple

• La clave nunca se guarda: se guarda su huella. Ni quien tenga la base la puede leer.
• Cada credencial es de un comercio. No sirve para entrar a otro.
• Si una credencial se filtra, revocala: es un clic y no hay que cambiar nada más.