Gradiently ofrece una API HTTP y un servidor MCP alojado. Conecta un asistente con OAuth o una clave API limitada a un espacio. El servidor acepta tokens de acceso OAuth y claves API del espacio. Ambos usan los mismos permisos, licencias, créditos y límites.
Añade un conector personalizado con ChatGPT: https://; Claude: https:// 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.
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
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
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.
# Paste your key when asked. It stays hidden and out of your shell history.
read -rs GRADIENTLY_API_KEY && export GRADIENTLY_API_KEY
claude mcp add --transport http gradiently https://gradiently.design/api/mcp \
--header "Authorization: Bearer $GRADIENTLY_API_KEY"Para llamar a la API, envía la misma cabecera con cada petición:
curl https://gradiently.design/api/marks?q=harbour \
-H "Authorization: Bearer $GRADIENTLY_API_KEY"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.