Guía para asistentes
Consultá el catálogo público, las descripciones y la disponibilidad publicada sin iniciar sesión. Los datos particulares de cada comprador requieren su autorización.
Para conectar un asistente, usá el servidor MCP del portal. Ingresá con tu cuenta del portal y aprobá solo los permisos que necesites mediante OAuth.
Permisos disponibles: catalogo:leer (catálogo), cuenta:leer (cuenta), pedidos:leer (pedidos) y pedidos:crear (crear pedidos con tu confirmación).
Antes de enviar un pedido, el asistente prepara un borrador y te pide confirmación explícita.
Límites de solicitudes de la API: catálogo público, 300 por minuto; comprador, 600 por minuto; MCP, 120 por minuto por conexión. Consultá los encabezados RateLimit-Policy y RateLimit; si recibís 429, esperá el tiempo indicado por Retry-After.
Cómo conectar tu asistente
Dirección MCP: https://www.amsa.com.uy/mcp
Claude
- Elegí Agregar y después Agregar conector personalizado.
- Escribí un nombre y pegá la dirección de conexión.
- Elegí Agregar y después Conectar.
- Entrá con tu cuenta del portal y aprobá los permisos.
En el plan gratuito de Claude entra un solo conector personalizado.
Si usás Claude con una cuenta de empresa, lo tiene que agregar un administrador.
ChatGPT
- Activá el modo desarrollador en Configuración > Aplicaciones > Opciones avanzadas.
- Creá una aplicación y pegá la dirección de conexión.
- Entrá con tu cuenta del portal y aprobá los permisos.
Según tu plan de ChatGPT, puede que no permita enviar pedidos.
Herramientas disponibles
- buscar_productos: Buscá productos por nombre, categoría o marca y revisá tus precios.
- ver_producto: Consultá un producto y el precio que corresponde a tu cuenta.
- ver_alternativas: Revisá alternativas de un producto.
- consultar_disponibilidad: Verificá si las cantidades que necesitás están disponibles.
- mi_cuenta: Revisá tu cuenta y sus condiciones comerciales.
- productos_habituales: Consultá los productos que comprás habitualmente.
- mis_pedidos: Revisá tus propios pedidos.
- ver_pedido: Consultá el detalle de uno de tus pedidos.
- opciones_de_entrega: Consultá las formas de envío y sucursales disponibles.
- preparar_pedido: Prepará un borrador con precios y disponibilidad, sin crear un pedido. Si pide vendedor o sucursal, consultá opciones_de_entrega y preparalo de nuevo con esos datos.
- confirmar_pedido: Confirmá el borrador solo después de recibir la confirmación explícita del comprador.
- cancelar_pedido: Cancelá un pedido propio que todavía admite cancelación, solo con confirmación explícita del comprador.
- aceptar_cotizacion: Aceptá una cotización propia ya respondida para convertirla en pedido, solo con confirmación explícita del comprador.
- factura_pdf: Consultá un comprobante con sus datos y código de seguridad. Si no hay enlace de descarga, descargalo desde el portal.
- promociones: Consultá las promociones vigentes del portal.
- categorias: Explorá las categorías disponibles y sus productos.
- marcas: Explorá las marcas disponibles en el catálogo.
- variantes: Consultá las variantes de un producto y tus precios.
- similares: Consultá productos similares; verificá sus especificaciones antes de elegir.
- recomendados: Revisá productos recomendados para tu cuenta.
- busqueda_inteligente: Buscá productos con una descripción y consultá tus precios.
- buscar_codigos: Consultá varios códigos de productos a la vez, separados por comas.
- informacion_del_portal: Consultá la información pública, preguntas frecuentes y modalidades del portal.
- presentacion_del_portal: Consultá la presentación pública de la empresa.
- perfil_del_portal: Consultá el perfil público y los datos de contacto del portal.
- catalogo_publico: Recorré el catálogo público por páginas; para tus precios usá buscar_productos o ver_producto.
- asistentes_conectados: Revisá los asistentes conectados a tu cuenta.
- desconectar_asistente: Desconectá un asistente de tu cuenta solo con confirmación explícita del comprador. Desconectar esta conexión impide seguir usándola.
- enviar_consulta: Enviá un mensaje al portal solo con confirmación explícita del comprador. Consultá informacion_del_portal para saber qué formularios están disponibles.