Gradiently para desarrolladores

Crea con Gradiently

Usa la API y el servidor MCP de Gradiently para que tu código, o tu asistente de IA, busque Marks y cree diseños que se abren en el Estudio.

Actualizado el 1 de octubre de 2026

Gradiently te ofrece dos puntos de entrada. El servidor MCP permite que un asistente de IA como Claude Code use las herramientas de Gradiently mientras hablas con él. La API permite que tu propio código llame directamente a los mismos endpoints. Ambos se autentican con una clave de API que pertenece a un espacio de trabajo, y ambos pasan por las mismas comprobaciones que la aplicación: roles del espacio de trabajo, licencias de los Marks, créditos de IA y límites de uso.

Qué puedes hacer

  • Buscar en el Mercado y leer la receta completa de cualquier Mark público.
  • Generar propuestas de marca a partir de un nombre y una descripción, y después adoptar una: un Mark en borrador, una marca y tres diseños iniciales en un solo paso.
  • Crear diseños con el propio Designer de Gradiently, con el motor de maquetación o desde una plantilla, y recibir un enlace que se abre en el Estudio.
  • Editar diseños guardados elemento a elemento, cambiar sus textos, guardar copias en otros tamaños y ponerles un Mark distinto.
  • Renderizar un diseño guardado en PNG o PDF, o publicar un enlace de visualización.
  • Forjar recetas de Marks a partir de una intención, revisar su color y legibilidad, y conservar versiones de tus borradores.

MCP o la API

Servidor MCP

  • Para asistentes de IA compatibles con servidores MCP remotos.
  • Una sola dirección: https://gradiently.design/api/mcp.
  • Las herramientas encuentran tu marca, guardan diseños y te devuelven enlaces al Estudio.
  • Ideal cuando quieres pedir trabajo con palabras sencillas.

API

  • Para scripts, backends y automatizaciones.
  • JSON sobre HTTPS en https://gradiently.design/api.
  • Tú eliges la marca, envías el documento del diseño y gestionas cada respuesta.
  • Ideal cuando necesitas un control exacto y repetible.

Las herramientas MCP están construidas sobre la API. Una llamada a una herramienta hace las mismas peticiones que haría tu código, con la misma clave, así que cuenta para los mismos límites y falla con los mismos mensajes.

Inicio rápido

  1. 1

    Crea una clave

    En Gradiently, abre Ajustes › API y agentes, elige el espacio de trabajo, nombra la clave según dónde vayas a usarla, elige qué puede hacer y selecciona Crear clave. Copia la clave cuando aparezca: solo se muestra una vez. Solo los propietarios y administradores pueden crear claves.

  2. 2

    Conecta tu asistente

    En Claude Code, añade Gradiently como servidor MCP remoto con tu clave en la cabecera Authorization (el comando está abajo). Los demás clientes se explican en MCP y asistentes de IA.

  3. 3

    Pide algo

    Prueba «Genera tres direcciones de marca para una pequeña panadería llamada Hearth, tranquila y cálida, y adopta la primera». El asistente llama a generate_brand y adopt_brand, y obtienes en tu espacio de trabajo una marca nueva con su propio Mark en borrador y sus diseños iniciales.

bash
export GRADIENTLY_API_KEY="gr_live_…"

claude mcp add --transport http gradiently https://gradiently.design/api/mcp \
  --header "Authorization: Bearer $GRADIENTLY_API_KEY"
Guarda la clave en una variable de entorno o en un gestor de secretos, nunca en un archivo que subas al repositorio.

Para llamar a la API, envía la misma cabecera con cada petición:

bash
curl https://gradiently.design/api/marks?q=harbour \
  -H "Authorization: Bearer $GRADIENTLY_API_KEY"
Buscar en el Mercado requiere una clave con el permiso Buscar Marks (marks:read).

Cómo actúa una clave

Una clave actúa como la persona que la creó, dentro del único espacio de trabajo para el que se creó. Nunca puede llegar a otro espacio de trabajo, aunque su creador pertenezca a él. Solo funciona mientras su creador siga siendo propietario o administrador de ese espacio de trabajo y su cuenta esté activa; si lo eliminan, le bajan el rol o desactivan su cuenta, la clave deja de funcionar.

  • Los diseños, las marcas y las subidas que crea una clave pertenecen al espacio de trabajo, exactamente como si su creador los hubiera hecho en la aplicación.
  • Los Marks que reserva una clave pasan a su creador, nunca al espacio de trabajo, y cualquier licencia sigue siendo suya.
  • El trabajo del Designer que inicia una clave gasta los créditos de IA del espacio de trabajo, igual que el Designer en el Estudio.
  • Una clave no puede gestionar claves, cambiar la cuenta, acceder a la facturación ni ceder un Mark. Claves de API y permisos enumera lo que nunca puede hacer.

El resto de la documentación

  • MCP y asistentes de IA: cómo conectar Claude Code y otros clientes, cada herramienta con sus entradas y permisos, y peticiones de ejemplo.
  • Referencia de la API: la URL base, la autenticación, cada endpoint al que puede llamar una clave, los errores, los límites de uso y la paginación.
  • Claves de API y permisos: cómo crear, rotar y revocar claves, qué permite cada permiso y cómo mantener seguras las claves.
  • ¿Nuevo en MCP? Qué es MCP lo explica con palabras sencillas, y modelcontextprotocol.io tiene la especificación.

¿Te has atascado o te falta algo? Envíanos una solicitud y te responderá una persona.

¿Necesitas ayuda?

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

Enviar una solicitud