# 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

[Abrir configuración](https://claude.ai/new#customize/connectors)

1. Elegí Agregar y después Agregar conector personalizado.
2. Escribí un nombre y pegá la dirección de conexión.
3. Elegí Agregar y después Conectar.
4. 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

[Abrir configuración](https://chatgpt.com/#settings/Connectors)

1. Activá el modo desarrollador en Configuración > Aplicaciones > Opciones avanzadas.
2. Creá una aplicación y pegá la dirección de conexión.
3. Entrá con tu cuenta del portal y aprobá los permisos.

Según tu plan de ChatGPT, puede que no permita enviar pedidos.

[Instalar en Cursor](cursor://anysphere.cursor-deeplink/mcp/install?name=amsa-repuestos&config=eyJ1cmwiOiJodHRwczovL3d3dy5hbXNhLmNvbS51eS9tY3AifQ%3D%3D)

[Instalar en VS Code](vscode:mcp/install?%7B%22name%22%3A%22amsa-repuestos%22%2C%22type%22%3A%22http%22%2C%22url%22%3A%22https%3A%2F%2Fwww.amsa.com.uy%2Fmcp%22%7D)


[Servidor MCP](https://www.amsa.com.uy/mcp)

[Especificación OpenAPI](/openapi.json)

[Catálogo en texto](/llms.txt)

[Índice de servicios](/.well-known/api-catalog)

## 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.

[Ir al portal](/)