Centro de ayuda

Un agente de inteligencia artificial es un programa que, además de responder texto, puede hacer acciones concretas: consultar información, crear registros, ejecutar pasos — como si fuera una persona operando el sistema, pero automatizado. Claude (el asistente de Anthropic) es un ejemplo, pero hay otros compatibles con el mismo estándar.

Para que un agente pueda usar tu cuenta de Ozom necesita dos cosas: una forma de "hablar" con tu sistema, y permiso para hacerlo. MCP (Model Context Protocol) resuelve la primera parte: es un lenguaje común que le permite a un agente usar tu catálogo, tus clientes, tus cotizaciones, tus pedidos y tus conversaciones de WhatsApp como herramientas — el agente "aprende" que existen esas herramientas y las usa cuando tú se lo pides en lenguaje normal. La API key del artículo anterior es la segunda parte: el permiso.

Ejemplo: en vez de entrar tú mismo al panel a revisar cuántos pedidos llevas esta semana, le puedes pedir a Claude, ya conectado por MCP, "dime cuántos pedidos tengo pendientes de esta semana", y el agente consulta tu cuenta directamente y te contesta.

Conectar en un solo paso (recomendado)

1. 1Paso 1: Ve a Admin → API keys, y busca la sección "Conectar por MCP".
2. 2Paso 2: Haz clic en el botón "Generar API key y conectar".
3. 3Paso 3: El sistema crea automáticamente una API key nueva llamada "MCP", con un conjunto de permisos ya pensado para este uso: leer el catálogo; leer y modificar clientes, cotizaciones y pedidos (incluyendo cancelar los pedidos que el propio agente creó); solo leer pagos; leer y responder conversaciones; y leer notificaciones. No incluye reembolsos, exportar pagos, ni nada de administración (invitar gente, gestionar otras API keys, etc.) — eso es intencional, para que un agente conectado así no pueda hacer nada delicado por error.
4. 4Paso 4: Aparece un aviso igual de importante que el de las keys normales: "Copia el secreto de aquí abajo: no se vuelve a mostrar". El secreto ya viene insertado en el comando que necesitas, así que no tienes que copiarlo aparte.
5. 5Paso 5: Elige la pestaña según qué agente vas a usar: "Claude Code" (una herramienta de línea de comandos), "Claude Desktop" (la aplicación de escritorio de Claude), u "Otro agente" (cualquier otro programa compatible con MCP).
6. 6Paso 6: Copia el comando o bloque que aparece — ya trae tu secreto insertado, no tienes que editarlo.
7. 7Paso 7: Pégalo donde corresponda: en Claude Code, en una terminal; en Claude Desktop, en su archivo de configuración; en otro agente, donde ese programa te pida sus variables de entorno.
8. 8Paso 8: Haz clic en "Ya la instalé" para cerrar el aviso.

Un ejemplo de cómo se ve el comando para Claude Code, solo para que sepas qué esperar (el tuyo trae tu propio secreto, no este):

claude mcp add easysell --env COMMERCE_API_KEY=npk_tu_secreto_aqui -- npx @cgalaviz/ozom-mcp

No necesitas entender esa línea para usarla — solo copiarla y pegarla donde el asistente te lo pida. "easysell" es simplemente el nombre técnico interno del conector; no cambia el nombre de tu negocio ni de Ozom en ningún lado que vean tus clientes. El nombre largo `@cgalaviz/ozom-mcp` es el paquete en npm (bajo el scope del publicador); el comando funciona igual usando solo el bin (`npx ozom-mcp`) si lo tenés instalado global, pero usar el nombre completo evita depender de lo que tengas en el PATH local.