MercadoExplorarPruébalo
Precios
Iniciar sesiónEmpezar
Desarrolladores

Claves de API y permisos

Una clave de API permite que una herramienta o un asistente de IA trabaje en un espacio de trabajo como la persona que la creó, limitado a los permisos que elijas. Trátala como una contraseña.

Actualizado el 4 de octubre de 2026

Documentación para desarrolladores

  • Visión general
  • MCP y asistentes de IA
  • Referencia de la API
  • Claves de API y permisos

En esta página

Crear una clavePermisosRotar una claveRevocar una claveLo que una clave nunca puede hacerMantén seguras las claves

El servidor acepta tokens de acceso OAuth y claves API del espacio. Ambos usan los mismos permisos, licencias, créditos y límites. Una clave pertenece a un espacio de trabajo, actúa como el propietario o administrador que la creó y solo puede llegar a los endpoints que permiten sus permisos. Las claves tienen la forma gr_live_ seguido de 43 letras, dígitos, guiones y guiones bajos.

Añade un conector personalizado con ChatGPT: https://gradiently.design/api/mcp/chatgpt; Claude: https://gradiently.design/api/mcp y elige el inicio de sesión OAuth. Inicia sesión en Gradiently, elige un espacio y revisa sus permisos. Solo los propietarios y administradores pueden conectar un asistente. Las conexiones caducan tras una hora y se renuevan automáticamente durante un máximo de 30 días. Revoca una conexión en Ajustes › API y agentes para detener su acceso y renovación de inmediato.

Crear una clave

  1. 1

    Abre API y agentes

    En Gradiently, ve a Ajustes › API y agentes y elige el espacio de trabajo para el que es la clave. Solo los propietarios y administradores de ese espacio de trabajo pueden crear claves.

  2. 2

    Ponle nombre

    En Crear una clave, dale un Nombre según dónde vayas a usarla, como Claude Code o Exportación nocturna, para saber cuál revocar más adelante.

  3. 3

    Elige qué puede hacer

    En Qué puede hacer, selecciona los permisos que necesita, al menos uno. La siguiente sección explica cada uno.

  4. 4

    Cópiala una vez

    Selecciona Crear clave. La clave aparece en Copia tu clave ahora, y es la única vez que se muestra. Cópiala en un gestor de contraseñas o en tu almacén de secretos, y selecciona Ya la he guardado.

Quien crea una clave recibe un correo cuando se crea y cuando se revoca, con su nombre, el inicio de la clave y sus permisos. La lista de Ajustes muestra de cada clave activa su nombre, el inicio de la clave, cuándo se usó por última vez y cuántos permisos tiene.

Permisos

Cada scope de la API es un permiso. Una petición necesita todos los permisos que indica su endpoint, y cada herramienta MCP necesita los permisos de todas las peticiones que hace. Concede solo lo que requiere la tarea.

designs:read

En Ajustes

Leer diseños

Qué permite

Leer marcas, diseños, miniaturas y subidas, renderizar diseños y seguir conjuntos del Designer.
designs:write

En Ajustes

Crear y editar diseños

Qué permite

Crear, cambiar, duplicar, compartir y eliminar diseños, subir y eliminar imágenes, y usar el Designer.
marks:read

En Ajustes

Buscar Marks

Qué permite

Buscar en el Mercado, leer Marks y tus borradores, crear y revisar recetas, y leer las versiones de un Mark.
marks:claim

En Ajustes

Reservar Marks

Qué permite

Reservar un Mark disponible, o uno que otro titular ha puesto a la venta, para el creador de la clave.
brand:generate

En Ajustes

Generar marcas

Qué permite

Generar y adoptar marcas, guardar y cambiar Marks en borrador, y gestionar las versiones de un Mark.
workspaces:read

En Ajustes

Leer el espacio de trabajo

Qué permite

Leer el espacio de trabajo, sus miembros y su registro de auditoría. Con designs:read, leer /api/me.
personalities:write

En Ajustes

Editar marcas

Qué permite

Crear, renombrar y eliminar marcas, y cambiar el Mark, el perfil y el estilo de una marca.
members:write

En Ajustes

Invitar miembros

Qué permite

Enviar invitaciones para unirse al espacio de trabajo.
PermisoEn AjustesQué permite
designs:readLeer diseñosLeer marcas, diseños, miniaturas y subidas, renderizar diseños y seguir conjuntos del Designer.
designs:writeCrear y editar diseñosCrear, cambiar, duplicar, compartir y eliminar diseños, subir y eliminar imágenes, y usar el Designer.
marks:readBuscar MarksBuscar en el Mercado, leer Marks y tus borradores, crear y revisar recetas, y leer las versiones de un Mark.
marks:claimReservar MarksReservar un Mark disponible, o uno que otro titular ha puesto a la venta, para el creador de la clave.
brand:generateGenerar marcasGenerar y adoptar marcas, guardar y cambiar Marks en borrador, y gestionar las versiones de un Mark.
workspaces:readLeer el espacio de trabajoLeer el espacio de trabajo, sus miembros y su registro de auditoría. Con designs:read, leer /api/me.
personalities:writeEditar marcasCrear, renombrar y eliminar marcas, y cambiar el Mark, el perfil y el estilo de una marca.
members:writeInvitar miembrosEnviar invitaciones para unirse al espacio de trabajo.

Empieza con los valores predeterminados

Una clave nueva empieza con designs:read, designs:write, marks:read, brand:generate y workspaces:read, que cubren diseñar con un asistente de IA. Añade marks:claim, personalities:write o members:write solo si la clave tiene que reservar Marks, cambiar marcas o invitar a personas.

Las claves nuevas empiezan con Leer diseños, Crear y editar diseños, Buscar Marks, Generar marcas y Leer el espacio de trabajo seleccionados. Reservar Marks está desactivado hasta que lo eliges, porque una reserva te convierte a ti, el creador de la clave, en titular de un Mark.

Rotar una clave

Las claves no caducan, y el nombre y los permisos de una clave no se pueden cambiar después de crearla. Para rotar una clave, o para cambiar lo que puede hacer, sustitúyela:

  1. 1

    Crea la clave nueva

    Crea una clave con los permisos que quieras, con un nombre que la distinga de la antigua.

  2. 2

    Pasa tus herramientas a la nueva

    Pon la clave nueva en todos los sitios donde se usaba la antigua: tu cliente MCP, tu almacén de secretos o la configuración de despliegue.

  3. 3

    Revoca la clave antigua

    Cuando la fecha de usada de la clave antigua deje de cambiar en la lista, revócala.

Revocar una clave

En Ajustes › API y agentes, selecciona Revocar junto a la clave y confirma con Revocar clave. Todo lo que la use deja de funcionar al instante, y no se puede deshacer. Los propietarios y administradores del espacio de trabajo pueden revocar cualquiera de sus claves.

Una clave también deja de funcionar por sí sola cuando su creador sale del espacio de trabajo, baja a un rol inferior a administrador o se desactiva su cuenta. Las claves que creó una persona se revocan cuando se la elimina del espacio de trabajo o se le baja el rol.

Lo que una clave nunca puede hacer

Algunas cosas siempre requieren una persona con la sesión iniciada en Gradiently, sean cuales sean los permisos de la clave:

  • Crear, listar o revocar claves.
  • Cambiar la cuenta: perfil, correo, contraseña, sesiones iniciadas o eliminarla.
  • Acceder a la facturación: planes, pago, cobros, recargas de créditos de IA, Saldo y pagos recibidos. Una reserva o compra que requiere pago se detiene y pide completar el pago en Gradiently.
  • Ceder un Mark: transferirlo a otra persona, liberarlo, ponerlo a la venta, renovarlo o publicarlo.
  • Pasar la titularidad o la licencia de un Mark al espacio de trabajo. Los Marks que reserva una clave pasan a su creador, y cualquier licencia sigue siendo suya.
  • Cambiar quién está en el espacio de trabajo o sus roles, ni renombrar, transferir o eliminar el espacio de trabajo. Con members:write solo puede enviar invitaciones.
  • Llegar a cualquier espacio de trabajo que no sea el suyo, aunque su creador pertenezca a él.
  • Usar la administración de Gradiently.

Mantén seguras las claves

No

  • Subir una clave a un repositorio o pegarla en un archivo de configuración compartido.
  • Poner una clave en una página web, una app móvil o cualquier cosa que se ejecute en el dispositivo de otra persona.
  • Compartir una clave entre personas o herramientas.
  • Enviar una clave por correo o por chat.
  • Dejar Reservar Marks activado en una clave que no reserva.

Sí

  • Crea una clave para cada herramienta o asistente, con su nombre.
  • Concede los menos permisos posibles para la tarea.
  • Guarda las claves en un gestor de contraseñas, un almacén de secretos o una variable de entorno.
  • Revoca una clave en cuanto pueda haberse filtrado, y crea otra nueva.
  • Revisa de vez en cuando las fechas de último uso, y revoca las claves que nadie usa.

Gradiently solo guarda un hash de cada clave y su inicio para mostrarlo, así que una clave perdida no se puede volver a mostrar: revócala y crea otra. Si crees que alguien ha usado mal una clave, revócala y avísanos.

¿Necesitas ayuda?

Envíanos una solicitud con el tema API y MCP, y te responderá una persona.

Enviar una solicitud

Encuentra el look que es solo tuyo.

Cada Mark es un fondo vivo con un único dueño. Prueba uno que siga disponible y reserva el tuyo cuando te convenza.

Empieza a diseñarVer la oferta de lanzamiento

Marks por reservar

50de 1000

950 reservados hasta ahoraEncuentra el tuyo

Comprobar un certificado

Escribe un número de certificado o el código de un Mark para ver de quién es.

Funciona con ChatGPT y Claude

Pídele un diseño a tu IA. Lo crea en tu Mark, listo para editar.

ChatGPTClaude
Cómo conectarlo

Producto

  • Mercado
  • Explorar
  • Precios
  • Packs de lanzamiento
  • Certificados

Aprende

  • Guía práctica
  • Centro de ayuda
  • Novedades

Desarrolladores

  • Introducción
  • ChatGPT y Claude
  • Referencia de la API
  • Claves de API

Empresa

  • Quiénes somos
  • Contacto
  • Iniciar sesión

Legal

  • Términos
  • Privacidad
  • Reembolsos
  • Protección de Marks
  • Cookies
  • Todas las políticas
Recorre las letras. Cada una lleva un Mark real.Toca una letra para ver su Mark.Un nombre. Diez Marks dentro.
© 2026 Gradiently