Ir al contenido principal

Asistente de IA de Astroselling: conectá tu cuenta a Claude y otras IAs

Cómo conectar tu cuenta a Claude, ChatGPT y otras IAs, y todo lo que le podés pedir.

Con el asistente de IA de Astroselling podés consultar y manejar tu cuenta hablándole a una IA como Claude, en lenguaje natural. Sin entrar al panel ni buscar números de ID.

Algunos ejemplos de lo que le podés pedir:

  • “¿Cuántos productos activos tengo en cada canal?”

  • “Pasame en Excel las ventas de octubre.”

  • “¿Qué enlaces tienen error y por qué?”

  • “Publicá estos 10 SKUs de mi TiendaNube en Mercado Libre.”

  • “¿Cómo va mi publicación del lote 120?”

  • “Bajame las etiquetas de envío de ayer de Mercado Libre.”

  • “Facturá en mi Bsale las ventas de octubre que tienen error de facturación.”

La IA consulta tu cuenta en el momento y sólo ve los canales de tu cuenta: los que tienen en su panel de Astroselling vos y las demás personas de tu cuenta.

Antes de empezar

  • Pedile a soporte que te habilite el asistente. Se activa por usuario: cada persona de tu cuenta que quiera usarlo tiene que tenerlo habilitado.

  • Tu cuenta tiene que tener una suscripción activa o estar en el período de prueba.

  • Necesitás una cuenta en alguna de estas IAs: Claude, ChatGPT, Cursor, VS Code (GitHub Copilot), Gemini CLI o Codex.

Cómo conectarlo en Claude

  1. En Claude, entrá a Configuración → Conectores.

  2. Tocá Agregar conector personalizado.

  3. En Nombre, escribí Astroselling. En URL, pegá https://nova.astroselling.com/api/v2/mcp

  4. Tocá Conectar. Se abre la página de Astroselling: ingresá con tu usuario y tocá Autorizar.

  5. Listo. En una conversación nueva, activá el conector Astroselling desde el menú de herramientas y empezá a preguntar.

💡 Si usás Claude en un plan Team o Enterprise: sólo el administrador (Owner) de tu organización puede agregar conectores personalizados. Una vez agregado, cada persona se conecta con su propio usuario de Astroselling.

Cómo conectarlo en otras IAs

Cómo es el inicio de sesión

Es igual en todas las IAs. Nunca te vamos a pedir que pegues tu contraseña en la IA: el ingreso siempre se hace en la página de Astroselling.

  1. La IA abre tu navegador en la página de ingreso de Astroselling.

  2. Ingresá con tu email y contraseña de Astroselling, los mismos del panel.

  3. En la pantalla Autorizar, fijate que la app que pide acceso sea la IA que estás conectando y tocá Autorizar.

  4. Volvés a la IA, que ya queda conectada.

La conexión se renueva sola mientras la uses. Si pasás 30 días sin usarla, la IA te pide que vuelvas a ingresar.

ChatGPT

Necesitás un plan pago de ChatGPT.

  1. En ChatGPT, entrá a Configuración → Apps y conectores → Configuración avanzada y activá el Modo desarrollador.

  2. Volvé a Apps y conectores y tocá Crear.

  3. En Nombre, escribí Astroselling. En URL, pegá https://nova.astroselling.com/api/v2/mcp. En Autenticación, elegí OAuth. Después tocá Crear.

  4. Se abre la página de Astroselling: ingresá y tocá Autorizar.

  5. En un chat nuevo, tocá + → Modo desarrollador y activá Astroselling.

Cursor

Vas a usar este código:

{ "mcpServers": { "astroselling": { "url": "https://nova.astroselling.com/api/v2/mcp" } } }
  1. Entrá a Cursor Settings → Tools & MCP → New MCP Server, pegá el código de arriba y guardá.

  2. Al lado de Astroselling, tocá Needs login.

  3. Ingresá en la página de Astroselling y tocá Autorizar. Si el navegador te pregunta si querés abrir Cursor, aceptá.

VS Code (GitHub Copilot)

  1. Apretá Ctrl + Shift + P (Cmd + Shift + P en Mac) y elegí MCP: Add Server → HTTP.

  2. Pegá https://nova.astroselling.com/api/v2/mcp y ponele de nombre astroselling.

  3. Cuando VS Code te pida autenticarte, tocá Permitir. Después ingresá en la página de Astroselling y tocá Autorizar.

  4. Usalo desde el chat de Copilot, en modo Agente.

Gemini CLI

Vas a usar este código:

{ "mcpServers": { "astroselling": { "httpUrl": "https://nova.astroselling.com/api/v2/mcp" } } }
  1. Agregá el código de arriba en el archivo ~/.gemini/settings.json.

  2. Abrí gemini y escribí /mcp auth astroselling.

  3. Ingresá en la página de Astroselling y tocá Autorizar. Después podés cerrar el navegador.

Codex

Vas a usar estos comandos:

codex mcp add astroselling --url https://nova.astroselling.com/api/v2/mcp codex mcp login astroselling
  1. Escribí los comandos de arriba en la terminal.

  2. Ingresá en la página de Astroselling y tocá Autorizar.

Si no podés conectarte

Mensaje que ves

Qué hacer

“Tu usuario no tiene habilitado el asistente de IA de Astroselling”

Tu usuario todavía no tiene el asistente habilitado. Pedile a soporte que te lo habilite.

“Tu cuenta de Astroselling no tiene una suscripción activa”

Tu cuenta no tiene una suscripción activa ni está en prueba. Reactivá tu suscripción desde Mi cuenta.

“El asistente de IA se usa conectándolo desde Claude, no con una API key”

Intentaste conectarte con una API key. Conectalo con los pasos de arriba, ingresando con tu usuario.

Cómo usarlo

  • Hablale como a una persona: “mis productos sin stock en Falabella”, “las ventas de ayer”. No hace falta saber IDs.

  • Para mucho volumen, pedí un Excel. Si querés todas las ventas de un mes o todo tu catálogo, pedí “exportame en Excel…”. Te devuelve un link de descarga que vence en 1 hora; si vence, pedile uno nuevo.

  • Decile tu zona horaria cuando pidas ventas por fecha, por ejemplo “hora de Chile”. Así los días se cortan bien.

  • Las tareas largas siguen solas. Publicar, cambiar o ejecutar enlaces y facturar corren en segundo plano. Cuando publicás o facturás, la IA te da un número de lote y después le podés preguntar “¿cómo va el lote 120?”. Con los enlaces, preguntale más tarde cómo quedaron.

Antes de cambiar algo, la IA te pregunta

Cuando le pedís algo que cambia tu cuenta (publicar, enlazar, cambiar, quitar o ejecutar enlaces, facturar, o volver a traer los productos de un canal), la IA:

  1. Hace una prueba sin cambiar nada.

  2. Te muestra qué va a pasar y entre qué canales, con sus nombres.

  3. Espera tu confirmación.

⚠️ Revisá bien los nombres de los canales antes de decir que sí: publicar en un marketplace no se puede deshacer, y facturar tampoco.

Créditos

  • Publicar cuesta 1 crédito por variación (1 crédito si el producto no tiene variaciones).

  • Antes de publicar, la IA te dice cuánto cuesta y cuántos créditos tenés disponibles.

  • Sólo se descuenta lo que se publica bien. Lo que falla se devuelve.

  • Si no te alcanzan los créditos, no se publica. Podés preguntarle “¿cuántos créditos tengo?” en cualquier momento.

Para tener en cuenta

Publicar y enlazar

  • Publicar no enlaza. Después de publicar, cuando los productos ya aparecen en el canal destino, pedile “enlazá las publicaciones” para que se sincronicen el precio y el stock.

  • Se publican hasta 500 productos por vez, y siempre el producto entero, con todas sus variaciones.

  • Se puede publicar en Mercado Libre, Falabella, Walmart, Ripley, Paris y TiendaNube.

  • Enlazar usa el sincronizador masivo del panel: necesitás tenerlo habilitado. Volver a enlazar hacia un mismo canal tiene una espera de 22 horas, compartida con el panel.

  • Quitar un enlace no borra la publicación: queda con el último precio y stock que recibió. Si sólo querés frenar la sincronización por un tiempo, pedile que pause el enlace.

  • Ejecutar enlaces puede hacerse para un canal entero o sólo para algunos productos (por SKU, por ejemplo). En un canal grande puede tardar varias horas.

Facturar

  • Facturar no se deshace: emite los comprobantes en tu sistema de facturación. Antes, la IA te muestra cuántas ventas se facturarían y cuáles se descartan (por ejemplo, porque ya están facturadas), con el motivo.

  • Se facturan hasta 500 ventas por vez, en el sistema de facturación que elijas, igual que “Facturar masivamente” en Ventas.

  • Si pedís por fechas que incluyen hoy, entre la prueba y la factura pueden entrar ventas nuevas. Para facturar exactamente lo que mostró la prueba, pedile “facturá las ventas de la prueba”.

Excel, etiquetas y estados

  • Los Excel tienen un tiempo de espera. En ventas, entre un export y el siguiente hay una espera (en general, de 3 horas). En productos, se pide un export a la vez. Las esperas cuentan también los exports que pedís desde el panel.

  • Etiquetas de envío: sólo de los canales que tenés en tu panel, y de a una descarga por vez (también cuenta si estás bajando etiquetas desde el panel).

  • El estado de las ventas (pagada, enviada, etc.) por ahora sólo está completo en Mercado Libre.

Todo lo que puede hacer

✏️ = cambia algo en tu cuenta (te pide confirmación antes). 💳 = usa créditos.

Tus canales

Herramienta

Qué hace

list_channels

Lista tus canales y su tipo (marketplace, tienda propia o ERP), y te avisa si alguno está desconectado. Podés buscar un canal por su nombre.

get_channel

Muestra el detalle de un canal.

refresh_channel_products ✏️

Vuelve a traer los productos de un canal, como el botón “Sincronizar productos” del panel. Todos los canales se actualizan solos cada noche; esto lo adelanta. Puede tardar hasta una hora.

Tus productos

Herramienta

Qué hace

products_summary

Cuántos productos tenés por canal y por estado.

list_products

Busca productos por canal, estado, stock, título o SKU.

get_product, list_variations, get_variation

Muestran el detalle de un producto y de sus variaciones.

find_products_by_sku

Te dice cuáles de una lista de SKUs existen en un canal, cuáles faltan y cuáles están repetidos.

export_products, get_products_export

Excel de tu catálogo (SKU, nombre, EAN, descripción, precios y canal). No incluye stock ni estado.

Enlaces (sincronización de precio y stock)

Herramienta

Qué hace

syncs_summary

Resumen de tus enlaces: activos, en pausa, con error y en riesgo de quedarte sin stock.

list_syncs

Lista tus enlaces con su configuración y lo último que pasó con cada uno.

link_existing_publications ✏️

Enlaza productos que ya están publicados en los dos canales, por SKU.

update_syncs ✏️

Cambia la configuración de los enlaces: qué sincronizan, markup, stock mínimo y máximo, o pausarlos y reactivarlos.

unlink_syncs ✏️

Quita enlaces.

execute_syncs ✏️

Vuelve a ejecutar los enlaces de un canal, todos o sólo algunos (por SKU o por enlace), como “Sincronizar productos” en Enlaces.

Publicar

Herramienta

Qué hace

list_channel_categories

Muestra las categorías de un canal, para elegir dónde publicar.

get_category_attributes

Muestra los datos que pide un canal para publicar en una categoría.

publish_products ✏️ 💳

Publica productos de un canal en otro, por SKU.

list_publish_batches

Lista tus publicaciones (lotes), de la más nueva a la más vieja.

get_publish_batch_status

Muestra cómo va una publicación, producto por producto, con el link o el motivo del error.

retry_publish_batch_items ✏️ 💳

Reintenta los productos que fallaron en una publicación.

get_account_credits

Tus créditos: saldo, reservados y disponibles.

Ventas

Herramienta

Qué hace

list_orders

Lista tus ventas por canal y fecha. También busca por número de orden o de factura exacto.

get_order

Muestra el detalle de una venta.

export_orders, get_orders_export

Excel de tus ventas de un rango de fechas (el mismo del panel de Ventas).

download_shipping_labels

ZIP con las etiquetas de envío de un canal de tu panel en un rango de fechas, de a 80, para imprimirlas juntas. Se baja una descarga por vez, contando también las del panel.

invoice_orders ✏️

Factura tus ventas en lote en tu sistema de facturación, como “Facturar masivamente” en Ventas. No se deshace.

get_invoice_batch_status

Muestra cómo terminó cada venta de una facturación: facturada (con el número), en curso, con error (con el motivo) o pendiente.

Preguntas frecuentes

¿La IA puede ver cuentas de otros?

No. Sólo ve los canales que vos y las personas de tu cuenta tienen en el panel.

¿Puede publicar o cambiar algo sin que yo lo sepa?

No. Todo cambio pasa primero por una prueba y espera tu confirmación.

¿La IA conoce mi contraseña?

No. Siempre ingresás en la página de Astroselling, nunca en la IA. La IA sólo recibe el permiso que vos autorizás.

¿Cómo desconecto el asistente?

En Claude: Configuración → Conectores → Astroselling → Desconectar. En las otras IAs, quitá el servidor Astroselling desde su configuración de conectores o de MCP.

¿Tiene algún límite de uso?

Sí: hasta 60 consultas por minuto. En el uso normal no se nota.

¿Ha quedado contestada tu pregunta?