> ## Documentation Index
> Fetch the complete documentation index at: https://docs.nubea.com.ar/llms.txt
> Use this file to discover all available pages before exploring further.

# API pública y MCP

> Operá tu tienda desde Claude, Codex, Cursor o tu propia integración, con las mismas operaciones y reglas del panel.

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

<CardGroup cols={2}>
  <Card title="Conectar un asistente (MCP)" icon="robot" href="/api/conectar-mcp">
    Claude, Claude Code, Codex, Cursor o cualquier cliente MCP. Le preguntás por
    tu tienda y actúa con tus datos reales.
  </Card>

  <Card title="Usar la API REST" icon="code" href="/api/usar-la-api">
    Para tu propia integración, un script o una herramienta interna. Base
    `https://api.nubea.com.ar/v1`.
  </Card>
</CardGroup>

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](/api/referencia-rutas) las lista todas.

## Crear una clave

<Steps>
  <Step title="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.
  </Step>

  <Step title="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.
  </Step>

  <Step title="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.
  </Step>
</Steps>

Podés tener hasta 20 claves activas por tienda. Revocar una corta el acceso al
instante; las solicitudes que ya empezaron pueden terminar.

## Permisos

| Permiso | En el panel | Qué habilita |
| - | - | - |
| `platform:read` | Lectura | Consultar productos, pedidos, campañas, estadísticas y la configuración de cada widget |
| `platform:write` | Escritura | Crear, editar, publicar, eliminar y pedir exportaciones |
| `messages:send` | Mensajes | Enviar campañas y mensajes del inbox, y gestionar automatizaciones |
| `billing:write` | Facturación | Modificar la suscripción |
| `team:write` | Equipo | Invitar y quitar integrantes |
| `integrations:write` | Integraciones | Conectar y desconectar WhatsApp, Perfit y otras integraciones |

Los cuatro permisos adicionales requieren también Escritura. Una lectura que
dispara trabajo, como una exportación, cuenta como Escritura.

<Warning>
  **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.
</Warning>

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


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.