El servidor acepta tokens de acceso OAuth y claves API del espacio. Ambos usan los mismos permisos, licencias, créditos y límites. El Model Context Protocol es un estándar abierto para dar herramientas a los asistentes de IA. Gradiently tiene un servidor MCP alojado. ChatGPT se conecta a https://, y Claude y otros clientes a https://. Conéctalo una vez con una clave de API y tu asistente podrá llamar a las herramientas de Gradiently mientras hablas con él. Cada herramienta hace las mismas peticiones a la API que haría tu propio código, así que tiene los mismos permisos, licencias, créditos y límites.
Antes de conectar
- Crea una clave en Ajustes › API y agentes (consulta Claves de API y permisos). La clave decide en qué espacio de trabajo trabaja el asistente y qué herramientas funcionarán.
- Un cliente con clave API envía
Authorization: Bearer gr_live_…. ChatGPT y Claude envían el token OAuth después de iniciar sesión. - El servidor usa Streamable HTTP, sin estado, con respuestas JSON. No necesita sesión ni tiene un flujo de eventos aparte que abrir.
- El servidor acepta tokens de acceso OAuth y claves API del espacio. Ambos usan los mismos permisos, licencias, créditos y límites.
Conectar ChatGPT y Claude
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.
Una conexión personalizada y una entrada en el directorio público son distintas. La publicación en el directorio requiere la revisión y aprobación de OpenAI o Anthropic.
Conectar Claude Code
Añade Gradiently como servidor remoto por HTTP, con tu clave en la cabecera. Guarda la clave en una variable de entorno para que nunca acabe en el historial de tu terminal ni en un archivo del repositorio.
# 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"Abre una sesión nueva de Claude Code y pídele que enumere las herramientas de Gradiently para comprobar la conexión. Si indica un error de autenticación, la clave se escribió mal, se revocó o su creador ya no es propietario ni administrador del espacio de trabajo.
Otros clientes
Cualquier cliente que pueda añadir un servidor MCP remoto por Streamable HTTP y enviar una cabecera personalizada puede usar Gradiently con la misma URL y la misma cabecera. Que el tuyo pueda depende del cliente y de su versión.
- Los clientes que se configuran con un archivo JSON suelen aceptar la estructura de abajo, que también aparece en Ajustes en Conectar un cliente MCP. Consulta la documentación de tu cliente para ver su formato exacto.
{
"mcpServers": {
"gradiently": {
"url": "https://gradiently.design/api/mcp",
"headers": { "Authorization": "Bearer gr_live_…" }
}
}
}Cómo se comportan las herramientas
- Las herramientas devuelven texto JSON.
inspect_designtambién devuelve una imagen PNG. Los fallos devuelven un mensaje de error. - Las herramientas que necesitan una marca aceptan un
personalityopcional (su id o slug). Sin él, usan la primera marca del espacio de trabajo. - Las herramientas que guardan un diseño devuelven su enlace al Estudio, la dirección
/del diseño en gradiently.design.studio/ <id> - Varias herramientas buscan primero tus marcas mediante
/, que necesitaapi/ me workspaces:readydesigns:read. Esas herramientas indican ambos permisos abajo. - Una llamada a una herramienta cuenta para el límite de uso de tu clave una vez por la petición MCP y una vez por cada petición a la API que hace la herramienta.
Marks
search_marksQué hace
Entradas
q, tone (dark o light), limit (de 1 a 120, 24 por defecto), todos opcionalesPermisos
marks:readget_markQué hace
Entradas
code (un código o un id)Permisos
marks:readlist_marksQué hace
Entradas
Permisos
marks:readclaim_markQué hace
Entradas
codePermisos
marks:read, marks:claimexport_markQué hace
Entradas
mark, width, height, personalityPermisos
workspaces:read, designs:read, designs:writerestore_mark_versionQué hace
Entradas
mark, versionPermisos
brand:generateupdate_mark_versionQué hace
Entradas
mark, version, label, starredPermisos
brand:generatedelete_mark_versionQué hace
Entradas
mark, versionPermisos
brand:generateUna reserva que requiere pago falla con un mensaje que indica que hay que pasar por caja; termínala en Gradiently. Una clave no puede pagar nada.
Marcas y espacio de trabajo
list_personalitiesQué hace
Entradas
Permisos
workspaces:read, designs:readcreate_personalityQué hace
Entradas
namePermisos
personalities:writeget_brand_profileQué hace
Entradas
personalityPermisos
workspaces:read, designs:readupdate_brand_profileQué hace
Entradas
personality, profilePermisos
workspaces:read, designs:read, personalities:writemy_workspaceQué hace
Entradas
Permisos
workspaces:read, designs:read, marks:readlist_workspacesQué hace
Entradas
cursorPermisos
workspaces:readinvite_memberQué hace
Entradas
workspaceId, email, role (admin, editor o viewer)Permisos
members:writetone acepta hasta tres de calm, bold, warm, cool, playful, luxe, natural, technical, editorial y nocturnal; una petición con más se rechaza. colours acepta hasta ocho colores hex y count pide de una a ocho propuestas; por encima de eso, la petición también se rechaza. Para adoptar una propuesta, envía exactamente la entrada que la generó con la key de la propuesta: el servidor vuelve a crear la propuesta a partir de esa entrada y nunca se fía de una receta enviada por el cliente.
Diseñar
Para crear diseños originales, pide a tu IA conectada que lea el perfil de marca y get_design_guidance, diseñe con draw_design, examine la imagen real con inspect_design y refine con edit_design. Dibujar, editar e inspeccionar directamente no consume créditos de IA de Gradiently. Siguen aplicándose los límites de tu proveedor y los permisos de cuenta y exportación. Un dibujo puede incluir ilustraciones vectoriales propias del anfitrión, SVG depurado, gráficos nativos, gráficos de la biblioteca y fotos con licencia; todo sigue siendo editable en el Studio. La búsqueda y la importación de fotos acceden a Openverse, un catálogo externo.
get_design_guidanceQué hace
Entradas
purpose, topicPermisos
draw_designQué hace
Entradas
drawing, personality, mark, designId, page, titlePermisos
designs:write, workspaces:read, designs:read, marks:readinspect_designQué hace
Entradas
id, page, maxDimensionPermisos
designs:readfind_iconsQué hace
Entradas
query, limitPermisos
find_graphicsQué hace
Entradas
query, limitPermisos
find_photosQué hace
Entradas
query, countPermisos
designs:readimport_photoQué hace
Entradas
idPermisos
designs:writedesignPide al propio Designer de Gradiently que cree un diseño, o que cambie uno, a partir de una petición en lenguaje natural. Lee el perfil de marca y el Mark, diseña, revisa y guarda. Utiliza créditos de IA de Gradiently.Entradas
request, personality, size, designId, scope, selectionPermisos
workspaces:read, designs:read, designs:writecreate_designsQué hace
Entradas
brief, items (size, brief, title), title, personality, mark, waitPermisos
workspaces:read, designs:read, designs:writeget_design_setQué hace
Entradas
idPermisos
designs:readstop_design_setQué hace
Entradas
idPermisos
designs:writecompose_designQué hace
Entradas
composition, personality, designId, titlePermisos
workspaces:read, designs:read, designs:writelist_sizesQué hace
Entradas
Permisos
create_designQué hace
Entradas
form, size, copy, look, personalityPermisos
workspaces:read, designs:read, designs:writedesign y create_designs gastan los créditos de IA del espacio de trabajo, igual que el Designer en el Estudio. Si el saldo es demasiado bajo, fallan con un mensaje que lo indica; recarga en Ajustes › Créditos de IA. Cada persona puede tener como máximo dos conjuntos en curso a la vez, y un conjunto terminado se puede consultar durante unos veinte minutos. Los diseños en sí se conservan.
Una composición indica un size (el id de un tamaño predefinido como ig-post, x-post o li-banner, o {w, h} en píxeles), un layout (statement, editorial, poster, split, stat, quote, list, event o minimal) y blocks en orden de lectura, cada uno con un role como headline, body o cta y su text.
{
"composition": {
"size": "ig-post",
"layout": "event",
"blocks": [
{ "role": "eyebrow", "text": "Summer supper club" },
{ "role": "headline", "text": "Long table on the roof" },
{ "role": "details", "text": "", "items": ["Saturday 21 June", "7pm till late"] },
{ "role": "cta", "text": "Book a seat" }
]
}
}compose_design. La respuesta incluye el id del diseño, su enlace al Estudio, los problemas de la revisión y los elementos que ha colocado.Editar y exportar
list_designsQué hace
Entradas
personalityPermisos
workspaces:read, designs:readget_designQué hace
Entradas
id, page, kind, name, textPermisos
designs:readedit_designQué hace
Entradas
id, ops, pagePermisos
designs:writeupdate_design_textQué hace
Entradas
id, text (id de elemento a palabras)Permisos
designs:read, designs:writeresize_copiesQué hace
Entradas
id, sizesPermisos
designs:read, designs:writewear_markQué hace
Entradas
mark, y design o personalityPermisos
render_designQué hace
Entradas
id, width, height, format, pagePermisos
designs:readexport_design_linkQué hace
/ d/ <id>, que puede abrir cualquiera que lo tenga.Entradas
idPermisos
designs:writewear_mark en un diseño necesita designs:read y designs:write. Convertir un Mark en el Mark de una marca necesita workspaces:read, designs:read y personalities:write, y un Mark del que seas titular con una licencia activa. Indicar el Mark por su código también necesita marks:read.
render_design acepta width y height de 1 a 4096 píxeles y format png o pdf. page empieza en 0: en PNG se renderiza por defecto la primera página y en PDF todas. Un PDF mantiene cada página a su tamaño del Estudio, así que el tamaño que pidas debe coincidir. Renderizar requiere la misma licencia de exportación para el Mark del diseño que el Estudio, y nunca publica ni cambia el diseño.
Vídeo, audio y subtítulos
Usa find_uploads para encontrar referencias de fuentes autorizadas y después edit_design con add_video, update_video, split_video, add_audio, update_audio, split_audio, remove_audio, set_element_timing, set_captions o remove_captions. Nunca inventes la duración de una fuente. Los cortes de vídeo y los tiempos de los elementos usan segundos de la página; los inicios y cortes de audio y los subtítulos usan segundos del documento. El audio no alarga las escenas. Los subtítulos aceptan entradas con tiempos o contenido SRT/WebVTT; no hay transcripción automática. get_design devuelve la cronología completa y las pistas. export_captions devuelve contenido SRT/WebVTT en partes de hasta 100 subtítulos y 48.000 caracteres; usa nextOffset para la siguiente parte.
Peticiones de ejemplo
- «Busca en el Mercado Marks oscuros con cromo y muéstrame los tres más cercanos al verde azulado profundo.» Usa
search_marks. - «Cambia el titular del diseño 4f1c… por “Abrimos a las siete” y haz copias para una historia de Instagram y una publicación de X.» Usa
get_design,update_design_textyresize_copies. - «Renderiza el diseño 4f1c… como PNG de 1080 por 1350 y guárdalo en launch.png.» Usa
render_design. - «Haz un póster para nuestra fiesta del solsticio en la azotea, el 21 de junio, del atardecer al amanecer.» Usa
design, que necesitaworkspaces:read.
La referencia completa de los endpoints que hay detrás de estas herramientas está en Referencia de la API. Para cualquier otra cosa, envíanos una solicitud.