Skip to main content
Nubea expone dos formas de hacer desde afuera lo mismo que hacés en el panel:

Conectar un asistente (MCP)

Claude, Claude Code, Codex, Cursor o cualquier cliente MCP. Le preguntás por tu tienda y actúa con tus datos reales.

Usar la API REST

Para tu propia integración, un script o una herramienta interna. Base https://api.nubea.com.ar/v1.
Las dos usan la misma clave y el mismo catálogo de operaciones: campañas, automatizaciones, contactos, inbox, widgets, reseñas, integraciones, equipo y suscripción. La referencia de rutas las lista todas.

​
Crear una clave

1

Abrí Configuración → API y MCP

Cualquier integrante de la tienda puede crear claves con su cuenta de Nubea. Si entraste por Tiendanube, también.
2

Elegí nombre, vencimiento y permisos

Poné un nombre que diga dónde la vas a usar («Claude Code de Juan»). El vencimiento va de 30 días a 1 año. Dale solo los permisos que necesite.
3

Copiá la clave

Se muestra una sola vez. Si la perdés, revocala y creá otra. Guardala como variable de entorno NUBEA_API_KEY, nunca en el código.
Podés tener hasta 20 claves activas por tienda. Revocar una corta el acceso al instante; las solicitudes que ya empezaron pueden terminar.

​
Permisos

Los cuatro permisos adicionales requieren también Escritura. Una lectura que dispara trabajo, como una exportación, cuenta como Escritura.
La clave actúa con tu rol en la tienda. Los cambios de suscripción (billing:write) solo los puede hacer la clave de un propietario, aunque un integrante haya elegido ese permiso al crearla. Un agente del inbox que crea una clave con permiso de Equipo no puede, por esa clave, gestionar el equipo: la API aplica el rol actual de quien la creó en cada solicitud, además de los permisos elegidos. Si dejás de ser parte de la tienda, tus claves dejan de funcionar.

​
Alcance y límites

  • Cada clave pertenece a una tienda. No hay forma de cambiar de tienda con un parámetro.
  • 120 solicitudes por minuto por tienda, sumando todas sus claves, y 300 por minuto por IP. Ante un 429, respetá Retry-After.
  • Las restricciones del plan son las del panel: una función que tu plan no incluye tampoco está disponible por API.
  • Las credenciales de las integraciones (tokens de Tiendanube, WhatsApp, Perfit) nunca aparecen en las respuestas.
  • Las rutas de administración, crons, webhooks, acceso a cuentas y emisión de claves no están expuestas.