Gradiently MCP: conecta Claude, ChatGPT o cualquier cliente MCP

Para usar el servidor MCP de Gradiently, crea una clave de API en Ajustes › API y agentes y añade después el endpoint alojado https://gradiently.design/api/mcp a tu cliente MCP con la cabecera Authorization: Bearer <tu clave>. Esa es toda la conexión. A partir de ahí, un asistente como Claude puede buscar Marks, leer tu marca, crear diseños y cambiarlos, y cada diseño que crea se abre en tu estudio como cualquier otro.

MCP, el Model Context Protocol, es un estándar abierto que permite a los asistentes de IA usar herramientas reales. Si la idea es nueva, qué es MCP lo explica con palabras sencillas, y el sitio del propio protocolo, modelcontextprotocol.io, tiene la especificación. La referencia técnica completa del servidor de Gradiently está en la documentación para desarrolladores.

Lo que necesitas antes de empezar

• Una cuenta de Gradiently y un espacio de trabajo del que seas propietario o administrador. Solo los propietarios y administradores pueden crear o revocar claves.
• Un cliente MCP que pueda conectarse a un servidor remoto por HTTP y enviar una cabecera Authorization personalizada. Claude Code puede; muchos clientes de escritorio y de editor también.
• Un lugar seguro para la clave, como un gestor de contraseñas o el almacén de secretos de tu cliente. Solo se muestra una vez.

Paso 1: crea una clave de API con permisos acotados

1. 1

   Abre Ajustes › API y agentes

   Elige con el selector de arriba el espacio de trabajo en el que debe trabajar el asistente. Una clave solo actúa en el espacio de trabajo que la emitió.

2. 2

   Ponle el nombre del lugar donde se usa

   «Claude Desktop» o «Agente de marketing». El nombre es lo que te dirá cuál revocar más adelante.

3. 3

   Marca solo lo que necesita

   Los permisos se enumeran abajo. Cuatro vienen marcados por defecto; Reservar Marks no.

4. 4

   Créala y cópiala ahora

   La clave aparece una sola vez, completa. Cópiala en tu gestor de contraseñas antes de cerrar el cuadro. Después, Ajustes solo muestra sus primeros caracteres, cuándo se usó por última vez y cuántos permisos tiene.

Paso 2: añade el endpoint a tu cliente

La misma página muestra un fragmento listo para copiar en Conectar un cliente MCP, con un botón de copiar. Los clientes que leen una configuración JSON lo aceptan tal cual; pon tu clave en lugar de YOUR_KEY.

{
  "mcpServers": {
    "gradiently": {
      "url": "https://gradiently.design/api/mcp",
      "headers": { "Authorization": "Bearer YOUR_KEY" }
    }
  }
}

En Claude Code, añade el servidor desde tu terminal. Guarda la clave en una variable de entorno en lugar de escribirla en el historial de tu shell.

claude mcp add --transport http gradiently https://gradiently.design/api/mcp \
  --header "Authorization: Bearer $GRADIENTLY_API_KEY"

Otros asistentes, incluido ChatGPT, pueden conectarse allí donde su app, su plan y los ajustes de su espacio de trabajo permitan un servidor MCP remoto personalizado con cabecera de autorización. La compatibilidad varía entre clientes y cambia con el tiempo, así que consulta las páginas de ayuda de tu cliente; crear diseños de tu marca desde ChatGPT explica en qué fijarte. Una vez conectado, pide al asistente que enumere sus herramientas de Gradiently para confirmar que funcionó.

Lo que puede hacer tu asistente una vez conectado

El servidor expone las mismas acciones que tienes en el producto, con los mismos permisos. Agrupadas por tarea, son así:

Las peticiones sencillas funcionan mejor. El asistente se las pasa al Designer, que lee el perfil de tu marca y el Mark de la marca antes de componer nada. Como en el estudio, el trabajo del Designer se mide en créditos de IA.

• «Haz seis publicaciones para nuestro lanzamiento de otoño con nuestra marca, en vertical para Instagram.»
• «Toma el anuncio de ayer y haz con él una historia y una cabecera para X.»
• «Encuentra tres Marks oscuros con material de seda y dime sus códigos.»
• «Actualiza el perfil de nuestra marca: sonamos tranquilos y precisos, nunca comerciales.»

Para un recorrido más completo con Claude en concreto, mira diseñar con Claude a través de Gradiently. Si quieres que el asistente respete tu marca, las pautas de marca que tu asistente de IA pueda seguir muestran cómo escribir el perfil de marca que lee.

Mantener segura la conexión

Unas cuantas garantías se mantienen haga lo que haga el cliente. Una clave solo funciona en el espacio de trabajo que la emitió. Actúa con las mismas reglas que la persona que la creó, así que no puede hacer nada que su rol no pueda. Una clave nunca transfiere la propiedad de un Mark al espacio de trabajo ni a nadie más. Los diseños privados siguen siendo privados: un enlace de solo lectura solo existe cuando lo pides. Y si la persona que creó una clave sale del espacio de trabajo o pierde su rol de administrador, sus claves dejan de funcionar también.