L’essentiel en bref
- Gradiently exploite un serveur MCP hébergé à https://gradiently.design/api/mcp auquel peut se connecter tout client MCP capable d’envoyer un en-tête Authorization.
- Vous vous connectez avec une clé d’API créée par un propriétaire ou un administrateur d’espace de travail dans les Paramètres, sous API et agents, envoyée comme jeton Bearer.
- Chaque clé appartient à un seul espace de travail et ne porte que les autorisations cochées à sa création, comme lire des designs ou chercher des Marks.
- Une fois connecté, un assistant peut chercher des Marks, lire votre profil de marque, créer, modifier et redimensionner des designs, et chaque design s’ouvre dans le Studio.
- Une clé s’affiche une seule fois, peut être révoquée à tout moment, et ne transfère jamais la propriété d’un Mark à quelqu’un d’autre.
Sur cette page
Pour utiliser le serveur MCP de Gradiently, créez une clé d’API dans Paramètres › API et agents, puis ajoutez le point d’accès hébergé https://gradiently.design/api/mcp à votre client MCP avec l’en-tête Authorization: Bearer <votre clé>. C’est toute la connexion. Dès lors, un assistant comme Claude peut chercher des Marks, lire votre marque, créer des designs et les modifier, et chaque design qu’il crée s’ouvre dans votre Studio comme n’importe quel autre.
MCP, le Model Context Protocol, est un standard ouvert qui permet aux assistants IA d’utiliser de vrais outils. Si l’idée est nouvelle, ce qu’est MCP l’explique simplement, et le site du protocole, modelcontextprotocol.io, contient la spécification. La référence technique complète du serveur de Gradiently se trouve dans la documentation développeur.
Ce qu’il vous faut avant de commencer
- Un compte Gradiently et un espace de travail dont vous êtes propriétaire ou administrateur. Seuls les propriétaires et les administrateurs peuvent créer ou révoquer des clés.
- Un client MCP capable de se connecter à un serveur distant en HTTP et d’envoyer un en-tête
Authorizationpersonnalisé. Claude Code le fait ; beaucoup de clients de bureau et d’éditeurs aussi. - Un endroit sûr pour la clé, comme un gestionnaire de mots de passe ou le stockage secret de votre client. Elle ne s’affiche qu’une fois.
Étape 1 : créer une clé d’API restreinte
- 1
Ouvrez Paramètres › API et agents
Choisissez l’espace de travail dans lequel l’assistant doit travailler avec le sélecteur en haut. Une clé n’agit jamais que dans l’espace de travail qui l’a émise.
- 2
Nommez-la d’après l’endroit où elle sert
« Claude Desktop » ou « Agent marketing ». Le nom vous dira laquelle révoquer plus tard.
- 3
Cochez seulement ce qu’il lui faut
Les autorisations sont listées ci-dessous. Quatre sont cochées par défaut ; Réserver des Marks ne l’est pas.
- 4
Créez, puis copiez-la maintenant
La clé s’affiche une seule fois, en entier. Copiez-la dans votre gestionnaire de mots de passe avant de fermer la boîte de dialogue. Ensuite, les Paramètres n’affichent que ses premiers caractères, la date de dernière utilisation et le nombre d’autorisations.
| Autorisation | Ce qu’elle permet à l’assistant |
|---|---|
| Lire les créations | Lister et ouvrir les designs de l’espace de travail |
| Créer et modifier des créations | Créer de nouveaux designs et les modifier |
| Rechercher des Marks | Chercher des Marks dans le Marché |
| Réserver des Marks | Réserver un Mark pour cet espace de travail (désactivé par défaut) |
| Générer des marques | Créer des candidats de marque à partir d’une description |
Étape 2 : ajouter le point d’accès à votre client
La même page affiche un extrait prêt à l’emploi sous Connecter un client MCP, avec un bouton de copie. Les clients qui lisent une configuration JSON le prennent tel quel ; mettez votre clé à la place de YOUR_KEY.
{
"mcpServers": {
"gradiently": {
"url": "https://gradiently.design/api/mcp",
"headers": { "Authorization": "Bearer YOUR_KEY" }
}
}
}Dans Claude Code, ajoutez le serveur depuis votre terminal. Gardez la clé dans une variable d’environnement plutôt que de la taper dans l’historique de votre shell.
claude mcp add --transport http gradiently https://gradiently.design/api/mcp \
--header "Authorization: Bearer $GRADIENTLY_API_KEY"D’autres assistants, dont ChatGPT, peuvent se connecter partout où leur application, leur offre et leurs réglages d’espace de travail autorisent un serveur MCP distant personnalisé avec un en-tête d’autorisation. La prise en charge varie selon les clients et change avec le temps : consultez l’aide de votre client ; créer des designs fidèles à la marque depuis ChatGPT indique quoi chercher. Une fois connecté, demandez à l’assistant de lister ses outils Gradiently pour confirmer que ça marche.
Ce que votre assistant peut faire une fois connecté
Le serveur expose les mêmes actions que dans le produit, avec les mêmes autorisations. Regroupées par tâche, elles se présentent ainsi :
| Tâche | Ce que l’assistant peut faire |
|---|---|
| Trouver | Chercher des Marks par nom, code ou ton ; lire la recette d’un Mark ; lister vos Marks ; trouver des modèles de départ |
| Créer | Demander au Designer de Gradiently de créer ou de modifier un design à partir d’une demande simple ; créer une série de designs à partir d’un seul brief ; partir d’un modèle ; modifier textes et éléments |
| Redimensionner | Enregistrer des copies d’un design dans d’autres tailles, à côté de l’original, qui reste inchangé |
| Marque | Lire et mettre à jour le profil d’une marque ; générer des candidats de marque et en configurer un avec un Mark et des designs de départ |
| Marks | Forger une recette de Mark à partir d’une description et l’enregistrer comme brouillon privé ; poser un Mark sur un design ; réserver un Mark si la clé le permet |
| Partager et exporter | Activer un lien en lecture seule pour un design, ou le rendre en PNG ou en PDF quand le Mark est réservé |
Les demandes simples marchent le mieux. L’assistant les confie au Designer, qui lit votre profil de marque et le Mark de la marque avant de composer quoi que ce soit. Comme dans le Studio, le travail du Designer se mesure en crédits d’IA.
Ce que peut donner « une affiche pour notre fête du solstice sur le toit, le 21 juin, du coucher au lever du soleil » : un design enregistré sur le Mark de votre marque, prêt à être ouvert et retouché.
- « Crée six posts pour notre lancement d’automne dans notre marque, en portrait pour Instagram. »
- « Reprends l’annonce d’hier et crée-en une story et un en-tête X. »
- « Trouve trois Marks sombres avec une matière soie et donne-moi leurs codes. »
- « Mets à jour notre profil de marque : nous parlons avec calme et précision, jamais de façon commerciale. »
Pour un pas-à-pas plus complet avec Claude en particulier, voyez créer avec Claude via Gradiently. Si vous voulez que l’assistant reste fidèle à la marque, des consignes de marque que votre assistant IA peut suivre montre comment écrire le profil de marque qu’il lit.
Garder la connexion sûre
À éviter
- Une clé avec toutes les autorisations, partagée par tous les outils
- Coller une clé dans un chat, un document ou un dépôt
- Laisser des clés d’outils que vous n’utilisez plus
- Cocher Réserver des Marks pour un agent qui ne fait que créer
À faire
- Une clé par client, nommée d’après l’endroit où elle tourne
- La ranger dans un gestionnaire de mots de passe ou un coffre de secrets
- Révoquer les clés inutilisées dans les Paramètres ; elles s’arrêtent aussitôt
- Accorder le plus petit ensemble d’autorisations qui marche
Quelques garanties tiennent quel que soit le client. Une clé ne fonctionne que dans l’espace de travail qui l’a émise. Elle agit selon les mêmes règles que la personne qui l’a créée : elle ne peut rien faire que son rôle n’autorise pas. Une clé ne transfère jamais la propriété d’un Mark à l’espace de travail ni à quelqu’un d’autre. Les designs privés restent privés : un lien en lecture seule n’existe que si vous en demandez un. Et si la personne qui a créé une clé est retirée de l’espace de travail ou perd son rôle d’administrateur, ses clés cessent aussi de fonctionner.
Les questions qu’on nous pose
Quel est le point d’accès MCP de Gradiently ?
Le point d’accès hébergé est https://gradiently.design/api/mcp. Chaque requête a besoin de l’en-tête Authorization: Bearer suivi d’une clé d’API issue de Paramètres › API et agents.
Qui peut créer une clé d’API Gradiently ?
Les propriétaires et les administrateurs d’un espace de travail. Chaque clé appartient à cet unique espace de travail et ne porte que les autorisations cochées à sa création.
Cela fonctionne-t-il avec ChatGPT ?
Cela fonctionne avec tout client MCP capable de se connecter à un serveur HTTP distant et d’envoyer un en-tête d’autorisation. Que ChatGPT le puisse dépend de l’application, de l’offre et des réglages d’espace de travail que vous utilisez : consultez ses pages d’aide actuelles.
Que se passe-t-il si ma clé fuit ?
Révoquez-la dans Paramètres › API et agents. Tout ce qui l’utilise s’arrête aussitôt, et vous pouvez créer une nouvelle clé.
Un assistant peut-il réserver des Marks pour moi ?
Seulement si sa clé a l’autorisation Réserver des Marks, désactivée par défaut. La réservation est gratuite pendant le lancement de Gradiently.
Écrit par Gradiently
L’équipe derrière Gradiently, un outil de création construit autour des Marks : des dégradés vivants qui donnent à tout ce que vous créez votre propre signature.
Voir notre profil
