Conecta Ciro con Claude, ChatGPT y otros agentes de IA

El conector de Ciro permite que un asistente de IA responda preguntas con el sell-out de tu organización: ventas, stock, quiebres, sugerido de compra, dashboards guardados y qué tan al día están los datos de cada cadena. Preguntas en lenguaje natural, el asistente usa las herramientas de Ciro y la respuesta trae los mismos números que ves en Ciro.

Cuando un reporte te sirve, pídele al asistente que lo guarde como dashboard en Ciro. También puede agregarle o quitarle exploraciones después, con los mismos permisos que tienes en Ciro. Fuera de los dashboards, no puede cambiar nada: ni datos, ni configuraciones, ni usuarios.

Antes de conectar

Una cuenta de Ciro con acceso a una organización. Si no la tienes, pídele una invitación al administrador de tu organización.
Ventas o stock de al menos una cadena en esa organización.

Conectar desde Claude

En Claude web, de escritorio o móvil:

Abre Customize → Connectors y busca Ciro en el directorio. También puedes elegir Add → Add custom connector e ingresar https://api.heyciro.com/mcp.
Selecciona Connect, inicia sesión en Ciro y aprueba el acceso para tu organización.
Haz una pregunta en un chat, por ejemplo: "¿Cuánto vendí por cadena el mes pasado?"

En Claude Code, agrega el servidor e inicia sesión desde el menú /mcp:

claude mcp add --transport http ciro https://api.heyciro.com/mcp

Conectar desde ChatGPT

Abre Plugins en ChatGPT, busca Ciro y selecciona Connect. Si tu plan o tu workspace permite agregar servidores MCP propios, también puedes elegir Add → Create custom MCP server e ingresar https://api.heyciro.com/mcp.
Inicia sesión en Ciro y aprueba el acceso para tu organización.
Pregunta por tus datos, por ejemplo: "Usa Ciro para mostrarme mis ventas por cadena del mes pasado".

Conectar desde otros clientes MCP

Cualquier cliente compatible con servidores MCP remotos por Streamable HTTP con OAuth puede conectarse a https://api.heyciro.com/mcp. El cliente se registra solo, te lleva a Ciro para que inicies sesión y apruebes el acceso, y recibe un token para la organización que aprobaste.

Qué puedes preguntar

"¿Cuánto vendí y cuántas unidades por cadena el mes pasado, comparado con el año anterior?"
"Muéstrame mis ventas semanales de los últimos tres meses."
"¿Qué productos tienen más tiendas sin stock?"
"¿Cuántas unidades debo enviar a cada cadena para llegar a mis días de inventario objetivo?"
"Resume mi dashboard de ventas del mes pasado."
"¿Mis datos están al día en todas las cadenas?"
"Guarda este reporte como un dashboard en Ciro."
"Agrégale al dashboard una exploración con los quiebres por producto."

Herramientas

El conector tiene seis herramientas que solo leen datos:

get_data_catalog: lista las medidas y dimensiones por las que puedes preguntar, con sus unidades y definiciones, y la moneda de tu organización.
query_data: calcula medidas de ventas, stock y reposición, desglosadas por cadena, formato, marca, categoría, producto, tienda, región o tiempo, con filtros, orden, paginación y un total general opcional.
list_dimension_values: busca el nombre exacto de cadenas, marcas, categorías, productos o tiendas, con una búsqueda de texto opcional.
list_dashboards: lista los dashboards guardados que puedes ver en Ciro y sus exploraciones.
run_dashboard: devuelve los datos de cada exploración de un dashboard guardado, con su propio rango de fechas o con otro.
get_data_status: muestra, para cada cadena, el último día con ventas, el último reporte de stock, y el estado y la última sincronización exitosa de cada integración.

Y tres que cambian dashboards, solo cuando se lo pides. Tu asistente te pide aprobarlas antes de usarlas:

create_dashboard: guarda un dashboard nuevo con las exploraciones que pidas (KPIs, gráficos y tablas). Queda en Mi espacio, salvo que pidas compartirlo con la organización.
add_dashboard_tiles: agrega exploraciones a un dashboard que puedes editar.
remove_dashboard_tiles: quita exploraciones de un dashboard que puedes editar.

Permisos y tus datos

Solo cambia dashboards. El asistente puede crear dashboards y agregar o quitar sus exploraciones; ninguna herramienta puede cambiar ventas, stock, productos, tiendas, configuraciones ni usuarios en Ciro.
Tus mismos permisos. Cualquiera puede guardar dashboards en Mi espacio. Solo los propietarios y administradores de la organización pueden crear o cambiar los dashboards compartidos con la organización.
Una sola organización. Al aprobar la conexión, queda ligada a la organización activa en tu sesión. El asistente puede leer lo que tú puedes leer en esa organización, y nada más.
Se verifica en cada consulta. Si te quitan el acceso a la organización o se desactiva tu cuenta, la conexión deja de funcionar de inmediato.
Qué recibe el asistente. Los resultados de las herramientas que usa: tablas de ventas, stock, nombres del catálogo, datos de dashboards y estado de los datos. El proveedor de tu asistente trata esos resultados según sus propios términos. La Política de privacidad explica cómo Ciro trata tus datos.
Desconecta cuando quieras. Quita Ciro desde la configuración de conectores o plugins de tu asistente. Si quieres que revoquemos todas las conexiones de agentes de tu cuenta, escríbenos a support@heyciro.com.

Bueno saber

Los datos llegan con un día de retraso: el día más reciente con ventas suele ser ayer.
Los montos están en la moneda de tu organización y sin impuestos, salvo el precio promedio por unidad.
Las listas largas llegan por páginas. Pide totales por cadena, marca, categoría o mes para obtener respuestas más rápidas.

Solución de problemas

La aprobación falla con "Tu usuario no tiene acceso activo a una organización de Ciro". Tu cuenta no tiene una organización activa. Pídele al administrador de tu organización que te invite y vuelve a conectar.
El asistente no encuentra una cadena, marca o producto. Los filtros necesitan el nombre exacto. Pídele al asistente que primero busque el nombre.
Los últimos días se ven bajos o vacíos. Pregunta si tus datos están al día: puede que todavía no haya llegado el último reporte de una cadena.

Soporte

Escríbenos a support@heyciro.com o revisa la página de Soporte.