Gradiently pour les développeurs

Construire avec Gradiently

Utilisez l’API et le serveur MCP de Gradiently pour que votre code, ou votre assistant IA, recherche des Marks et réalise des créations qui s’ouvrent dans le Studio.

Mise à jour le 1 octobre 2026

Gradiently vous offre deux points d’entrée. Le serveur MCP permet à un assistant IA comme Claude Code d’utiliser les outils de Gradiently pendant que vous lui parlez. L’API permet à votre propre code d’appeler directement les mêmes points de terminaison. Tous deux s’authentifient avec une clé API qui appartient à un espace de travail, et passent par les mêmes contrôles que l’application : rôles de l’espace de travail, licences des Marks, crédits IA et limites de débit.

Ce que vous pouvez faire

  • Rechercher dans le Marché et lire la recette complète de n’importe quel Mark public.
  • Générer des propositions de marque à partir d’un nom et d’une description, puis en adopter une : un Mark brouillon, une marque et trois créations de départ en une seule étape.
  • Réaliser des créations avec le Designer de Gradiently, avec le moteur de mise en page ou à partir d’un modèle, et récupérer un lien qui s’ouvre dans le Studio.
  • Modifier des créations enregistrées élément par élément, changer leurs mots, en enregistrer des copies dans d’autres tailles et leur appliquer un autre Mark.
  • Rendre une création enregistrée en PNG ou en PDF, ou publier un lien de consultation.
  • Forger des recettes de Mark à partir d’une intention, vérifier leur couleur et leur lisibilité, et garder des versions de vos brouillons.

MCP ou l’API

Serveur MCP

  • Pour les assistants IA qui prennent en charge les serveurs MCP distants.
  • Une seule adresse : https://gradiently.design/api/mcp.
  • Les outils trouvent votre marque, enregistrent les créations et vous renvoient des liens Studio.
  • Idéal pour demander du travail avec des mots simples.

API

  • Pour les scripts, les back ends et les automatisations.
  • Du JSON sur HTTPS sous https://gradiently.design/api.
  • Vous choisissez la marque, envoyez le document de création et traitez chaque réponse.
  • Idéal quand il vous faut un contrôle exact et reproductible.

Les outils MCP reposent sur l’API. Un appel d’outil fait les mêmes requêtes que votre code, avec la même clé : il compte donc dans les mêmes limites et échoue avec les mêmes messages.

Démarrage rapide

  1. 1

    Créez une clé

    Dans Gradiently, ouvrez Paramètres › API et agents, choisissez l’espace de travail, nommez la clé selon l’endroit où vous l’utiliserez, choisissez ce qu’elle peut faire et sélectionnez Créer la clé. Copiez la clé quand elle apparaît : elle ne s’affiche qu’une fois. Seuls les propriétaires et admins peuvent créer des clés.

  2. 2

    Connectez votre assistant

    Dans Claude Code, ajoutez Gradiently comme serveur MCP distant avec votre clé dans l’en-tête Authorization (la commande est ci-dessous). Les autres clients sont traités dans MCP et assistants IA.

  3. 3

    Demandez quelque chose

    Essayez « Génère trois directions de marque pour une petite boulangerie appelée Hearth, calme et chaleureuse, puis adopte la première. » L’assistant appelle generate_brand et adopt_brand, et vous obtenez dans votre espace de travail une nouvelle marque avec son propre Mark brouillon et ses créations de départ.

bash
export GRADIENTLY_API_KEY="gr_live_…"

claude mcp add --transport http gradiently https://gradiently.design/api/mcp \
  --header "Authorization: Bearer $GRADIENTLY_API_KEY"
Gardez la clé dans une variable d’environnement ou un gestionnaire de secrets, jamais dans un fichier que vous committez.

Pour appeler l’API à la place, envoyez le même en-tête avec chaque requête :

bash
curl https://gradiently.design/api/marks?q=harbour \
  -H "Authorization: Bearer $GRADIENTLY_API_KEY"
Rechercher dans le Marché demande une clé avec la permission Rechercher des Marks (marks:read).

Comment agit une clé

Une clé agit au nom de la personne qui l’a créée, dans le seul espace de travail pour lequel elle a été créée. Elle ne peut jamais atteindre un autre espace de travail, même si son créateur en fait partie. Elle ne fonctionne que tant que son créateur est propriétaire ou admin de cet espace de travail et que son compte est actif ; s’il est retiré, rétrogradé ou désactivé, la clé cesse de fonctionner.

  • Les créations, marques et imports réalisés par une clé appartiennent à l’espace de travail, exactement comme si son créateur les avait faits dans l’application.
  • Les Marks réservés par une clé sont détenus par son créateur, jamais par l’espace de travail, et toute licence reste la sienne.
  • Le travail du Designer lancé par une clé consomme les crédits IA de l’espace de travail, comme le Designer dans le Studio.
  • Une clé ne peut pas gérer les clés, modifier le compte, accéder à la facturation ni céder un Mark. Clés API et permissions liste ce qu’elle ne peut jamais faire.

Le reste de la documentation

  • MCP et assistants IA : connecter Claude Code et d’autres clients, chaque outil avec ses entrées et ses permissions, et des exemples de demandes.
  • Référence de l’API : l’URL de base, l’authentification, chaque point de terminaison qu’une clé peut appeler, les erreurs, les limites de débit et la pagination.
  • Clés API et permissions : créer, renouveler et révoquer des clés, ce que permet chaque permission et comment protéger vos clés.
  • Vous découvrez MCP ? Qu’est-ce que MCP l’explique avec des mots simples, et modelcontextprotocol.io contient la spécification.

Bloqué, ou il vous manque quelque chose ? Envoyez-nous une demande et une personne vous répondra.

Besoin d’un coup de main ?

Envoyez-nous une demande avec le sujet API et MCP, et une personne vous répondra.

Envoyer une demande