MercadoExplorarPruébalo
Precios
Iniciar sesiónEmpezar
Desarrolladores

MCP y asistentes de IA

Gradiently ofrece una API HTTP y un servidor MCP alojado. Conecta un asistente con OAuth o una clave API limitada a un espacio.

Actualizado el 11 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

Antes de conectarConectar ChatGPT y ClaudeConectar Claude CodeOtros clientesCómo se comportan las herramientasMarksMarcas y espacio de trabajoDiseñarEditar y exportarVídeo, audio y subtítulosPeticiones de ejemplo

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://gradiently.design/api/mcp/chatgpt, y Claude y otros clientes a https://gradiently.design/api/mcp. 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://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.

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.

bash
# 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.
json
{
  "mcpServers": {
    "gradiently": {
      "url": "https://gradiently.design/api/mcp",
      "headers": { "Authorization": "Bearer gr_live_…" }
    }
  }
}

Deja margen para llamadas largas

La mayoría de las herramientas responden en segundos. render_design, inspect_design y export_mark pueden tardar hasta tres minutos, design hasta unos cinco, y create_designs con wait hasta unos cuatro. Si tu cliente tiene un ajuste de tiempo de espera para herramientas, súbelo en consecuencia.

Cómo se comportan las herramientas

  • Las herramientas devuelven texto JSON. inspect_design también devuelve una imagen PNG. Los fallos devuelven un mensaje de error.
  • Las herramientas que necesitan una marca aceptan un personality opcional (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 /studio/<id> del diseño en gradiently.design.
  • Varias herramientas buscan primero tus marcas mediante /api/me, que necesita workspaces:read y designs: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.

Los permisos que conviene dar a un asistente

Una clave creada en Ajustes empieza con designs:read, designs:write, marks:read, brand:generate y workspaces:read: suficiente para todas las herramientas de diseño. Añade marks:claim para reservar Marks, personalities:write para crear marcas o cambiar su Mark y su perfil, y members:write para enviar invitaciones.

Marks

search_marks

Qué hace

Busca en el Mercado público por nombre o código. Devuelve colores, materiales, estado y titular.

Entradas

q, tone (dark o light), limit (de 1 a 120, 24 por defecto), todos opcionales

Permisos

marks:read
get_mark

Qué hace

Un Mark y su receta completa.

Entradas

code (un código o un id)

Permisos

marks:read
list_marks

Qué hace

Los Marks reservados para este espacio de trabajo, con el estado de su licencia, y tus borradores en él.

Entradas

ninguna

Permisos

marks:read
claim_mark

Qué hace

Reserva un Mark disponible. El titular es el creador de la clave, nunca el espacio de trabajo.

Entradas

code

Permisos

marks:read, marks:claim
export_mark

Qué hace

Renderiza un Mark por sí solo como PNG, hasta 4096 px por lado.

Entradas

mark, width, height, personality

Permisos

workspaces:read, designs:read, designs:write
restore_mark_version

Qué hace

Vuelve a poner una versión como borrador. Antes, el estado actual se guarda como versión.

Entradas

mark, version

Permisos

brand:generate
update_mark_version

Qué hace

Cambia el nombre de una versión o la marca con estrella. Las versiones con estrella se conservan.

Entradas

mark, version, label, starred

Permisos

brand:generate
delete_mark_version

Qué hace

Elimina una versión, nunca la publicada.

Entradas

mark, version

Permisos

brand:generate
HerramientaQué haceEntradasPermisos
search_marksBusca en el Mercado público por nombre o código. Devuelve colores, materiales, estado y titular.q, tone (dark o light), limit (de 1 a 120, 24 por defecto), todos opcionalesmarks:read
get_markUn Mark y su receta completa.code (un código o un id)marks:read
list_marksLos Marks reservados para este espacio de trabajo, con el estado de su licencia, y tus borradores en él.ningunamarks:read
claim_markReserva un Mark disponible. El titular es el creador de la clave, nunca el espacio de trabajo.codemarks:read, marks:claim
export_markRenderiza un Mark por sí solo como PNG, hasta 4096 px por lado.mark, width, height, personalityworkspaces:read, designs:read, designs:write
restore_mark_versionVuelve a poner una versión como borrador. Antes, el estado actual se guarda como versión.mark, versionbrand:generate
update_mark_versionCambia el nombre de una versión o la marca con estrella. Las versiones con estrella se conservan.mark, version, label, starredbrand:generate
delete_mark_versionElimina una versión, nunca la publicada.mark, versionbrand:generate

Una 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_personalities

Qué hace

Las marcas del espacio de trabajo, con sus ids.

Entradas

ninguna

Permisos

workspaces:read, designs:read
create_personality

Qué hace

Crea una marca con nombre.

Entradas

name

Permisos

personalities:write
get_brand_profile

Qué hace

Qué es una marca, para quién es, su tono, lo que hace y lo que evita, y sus fuentes.

Entradas

personality

Permisos

workspaces:read, designs:read
update_brand_profile

Qué hace

Sustituye el perfil de una marca. El Designer lo lee antes de cada diseño.

Entradas

personality, profile

Permisos

workspaces:read, designs:read, personalities:write
my_workspace

Qué hace

Tú, las marcas del espacio de trabajo con los códigos de sus Marks, y los Marks reservados para él.

Entradas

ninguna

Permisos

workspaces:read, designs:read, marks:read
list_workspaces

Qué hace

El espacio de trabajo de la clave y tu rol en él.

Entradas

cursor

Permisos

workspaces:read
invite_member

Qué hace

Envía por correo una invitación de siete días para unirse al espacio de trabajo.

Entradas

workspaceId, email, role (admin, editor o viewer)

Permisos

members:write
HerramientaQué haceEntradasPermisos
list_personalitiesLas marcas del espacio de trabajo, con sus ids.ningunaworkspaces:read, designs:read
create_personalityCrea una marca con nombre.namepersonalities:write
get_brand_profileQué es una marca, para quién es, su tono, lo que hace y lo que evita, y sus fuentes.personalityworkspaces:read, designs:read
update_brand_profileSustituye el perfil de una marca. El Designer lo lee antes de cada diseño.personality, profileworkspaces:read, designs:read, personalities:write
my_workspaceTú, las marcas del espacio de trabajo con los códigos de sus Marks, y los Marks reservados para él.ningunaworkspaces:read, designs:read, marks:read
list_workspacesEl espacio de trabajo de la clave y tu rol en él.cursorworkspaces:read
invite_memberEnvía por correo una invitación de siete días para unirse al espacio de trabajo.workspaceId, email, role (admin, editor o viewer)members:write

tone 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_guidance

Qué hace

Dirección artística escrita y revisada: el nivel de calidad, las capacidades de dibujo, el método de concepto y el ciclo de revisión, con temas más profundos como ilustración, datos y tipografía. No son plantillas ni entrenamiento de modelos.

Entradas

purpose, topic

Permisos

cualquier clave
draw_design

Qué hace

Dibuja un diseño original y editable con tu IA conectada: texto, formas, ilustraciones vectoriales propias, SVG, gráficos nativos, gráficos de biblioteca, fotos, ventanas de la Mark y tablas. Solo vuelve a dibujar la página seleccionada.

Entradas

drawing, personality, mark, designId, page, title

Permisos

designs:write, workspaces:read, designs:read, marks:read
inspect_design

Qué hace

Devuelve una imagen PNG real que el asistente puede revisar y mejorar. Los tamaños más pequeños son la página completa reducida, como la muestra un feed.

Entradas

id, page, maxDimension

Permisos

designs:read
find_icons

Qué hace

Encuentra nombres válidos de iconos integrados.

Entradas

query, limit

Permisos

cualquier clave
find_graphics

Qué hace

Encuentra los gráficos originales de Gradiently, que se pueden recolorear, para usarlos como detalle de apoyo.

Entradas

query, limit

Permisos

cualquier clave
find_photos

Qué hace

Busca fotos con licencia en Openverse y devuelve miniaturas que el asistente puede ver. Indica cuándo una miniatura no está disponible. No se guarda nada.

Entradas

query, count

Permisos

designs:read
import_photo

Qué hace

Copia la foto elegida en las subidas del espacio de trabajo con su atribución, dentro de tu cuota de subidas.

Entradas

id

Permisos

designs:write
designPide 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, selection

Permisos

workspaces:read, designs:read, designs:write
create_designs

Qué hace

Crea un conjunto de hasta doce diseños a partir de un solo brief, en segundo plano. Utiliza créditos de IA de Gradiently.

Entradas

brief, items (size, brief, title), title, personality, mark, wait

Permisos

workspaces:read, designs:read, designs:write
get_design_set

Qué hace

El progreso de un conjunto y el enlace al Estudio de cada diseño en cuanto existe.

Entradas

id

Permisos

designs:read
stop_design_set

Qué hace

Detiene un conjunto en curso. Los diseños ya creados siguen guardados.

Entradas

id

Permisos

designs:write
compose_design

Qué hace

Maqueta tus textos con el motor de maquetación y guarda el diseño. Devuelve los problemas de la revisión que hay que corregir.

Entradas

composition, personality, designId, title

Permisos

workspaces:read, designs:read, designs:write
list_sizes

Qué hace

Cada tamaño predefinido, con su tamaño en píxeles.

Entradas

ninguna

Permisos

cualquier clave
create_design

Qué hace

Crea un diseño a partir de una forma (en blanco por defecto), un tamaño predefinido y textos asociados a los ids de los elementos.

Entradas

form, size, copy, look, personality

Permisos

workspaces:read, designs:read, designs:write
HerramientaQué haceEntradasPermisos
get_design_guidanceDirección artística escrita y revisada: el nivel de calidad, las capacidades de dibujo, el método de concepto y el ciclo de revisión, con temas más profundos como ilustración, datos y tipografía. No son plantillas ni entrenamiento de modelos.purpose, topiccualquier clave
draw_designDibuja un diseño original y editable con tu IA conectada: texto, formas, ilustraciones vectoriales propias, SVG, gráficos nativos, gráficos de biblioteca, fotos, ventanas de la Mark y tablas. Solo vuelve a dibujar la página seleccionada.drawing, personality, mark, designId, page, titledesigns:write, workspaces:read, designs:read, marks:read
inspect_designDevuelve una imagen PNG real que el asistente puede revisar y mejorar. Los tamaños más pequeños son la página completa reducida, como la muestra un feed.id, page, maxDimensiondesigns:read
find_iconsEncuentra nombres válidos de iconos integrados.query, limitcualquier clave
find_graphicsEncuentra los gráficos originales de Gradiently, que se pueden recolorear, para usarlos como detalle de apoyo.query, limitcualquier clave
find_photosBusca fotos con licencia en Openverse y devuelve miniaturas que el asistente puede ver. Indica cuándo una miniatura no está disponible. No se guarda nada.query, countdesigns:read
import_photoCopia la foto elegida en las subidas del espacio de trabajo con su atribución, dentro de tu cuota de subidas.iddesigns:write
designPide 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.request, personality, size, designId, scope, selectionworkspaces:read, designs:read, designs:write
create_designsCrea un conjunto de hasta doce diseños a partir de un solo brief, en segundo plano. Utiliza créditos de IA de Gradiently.brief, items (size, brief, title), title, personality, mark, waitworkspaces:read, designs:read, designs:write
get_design_setEl progreso de un conjunto y el enlace al Estudio de cada diseño en cuanto existe.iddesigns:read
stop_design_setDetiene un conjunto en curso. Los diseños ya creados siguen guardados.iddesigns:write
compose_designMaqueta tus textos con el motor de maquetación y guarda el diseño. Devuelve los problemas de la revisión que hay que corregir.composition, personality, designId, titleworkspaces:read, designs:read, designs:write
list_sizesCada tamaño predefinido, con su tamaño en píxeles.ningunacualquier clave
create_designCrea un diseño a partir de una forma (en blanco por defecto), un tamaño predefinido y textos asociados a los ids de los elementos.form, size, copy, look, personalityworkspaces:read, designs:read, designs:write

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

json
{
  "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" }
    ]
  }
}
Entrada para 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_designs

Qué hace

Los diseños guardados de una marca, con enlaces al Estudio.

Entradas

personality

Permisos

workspaces:read, designs:read
get_design

Qué hace

El tamaño, las páginas y cada elemento de un diseño con sus propiedades. Filtra los diseños largos por página, tipo, nombre o texto.

Entradas

id, page, kind, name, text

Permisos

designs:read
edit_design

Qué hace

Cambia un diseño con hasta 100 operaciones, como lo haría una persona en el Estudio, y lo guarda.

Entradas

id, ops, page

Permisos

designs:write
update_design_text

Qué hace

Sustituye las palabras de los elementos de texto elegidos y conserva la maquetación.

Entradas

id, text (id de elemento a palabras)

Permisos

designs:read, designs:write
resize_copies

Qué hace

Guarda copias en hasta ocho tamaños más, recolocadas como lo hace el Estudio. El original no cambia.

Entradas

id, sizes

Permisos

designs:read, designs:write
wear_mark

Qué hace

Pone un Mark en un diseño, o lo convierte en el Mark de una marca para los diseños nuevos.

Entradas

mark, y design o personality

Permisos

ver abajo
render_design

Qué hace

Renderiza un diseño guardado en PNG o PDF con el motor del Estudio. Devuelve el archivo en base64.

Entradas

id, width, height, format, page

Permisos

designs:read
export_design_link

Qué hace

Publica un enlace de visualización, /d/<id>, que puede abrir cualquiera que lo tenga.

Entradas

id

Permisos

designs:write
HerramientaQué haceEntradasPermisos
list_designsLos diseños guardados de una marca, con enlaces al Estudio.personalityworkspaces:read, designs:read
get_designEl tamaño, las páginas y cada elemento de un diseño con sus propiedades. Filtra los diseños largos por página, tipo, nombre o texto.id, page, kind, name, textdesigns:read
edit_designCambia un diseño con hasta 100 operaciones, como lo haría una persona en el Estudio, y lo guarda.id, ops, pagedesigns:write
update_design_textSustituye las palabras de los elementos de texto elegidos y conserva la maquetación.id, text (id de elemento a palabras)designs:read, designs:write
resize_copiesGuarda copias en hasta ocho tamaños más, recolocadas como lo hace el Estudio. El original no cambia.id, sizesdesigns:read, designs:write
wear_markPone un Mark en un diseño, o lo convierte en el Mark de una marca para los diseños nuevos.mark, y design o personalityver abajo
render_designRenderiza un diseño guardado en PNG o PDF con el motor del Estudio. Devuelve el archivo en base64.id, width, height, format, pagedesigns:read
export_design_linkPublica un enlace de visualización, /d/<id>, que puede abrir cualquiera que lo tenga.iddesigns:write

wear_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_text y resize_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 necesita workspaces: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.

¿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