MarchéExplorerEssayer
Tarifs
Se connecterCommencer

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 4 octobre 2026

Documentation développeurs

  • Vue d’ensemble
  • MCP et assistants IA
  • Référence de l’API
  • Clés API et permissions

Sur cette page

Ce que vous pouvez faireMCP ou l’APIDémarrage rapideComment agit une cléLe reste de la documentation

Gradiently propose une API HTTP et un serveur MCP hébergé. Connectez un assistant avec OAuth ou une clé API limitée à un espace. Le serveur accepte les jetons d’accès OAuth et les clés API d’espace. Les mêmes autorisations, licences, crédits et limites s’appliquent aux deux.

Ajoutez un connecteur personnalisé avec ChatGPT: https://gradiently.design/api/mcp/chatgpt; Claude: https://gradiently.design/api/mcp et choisissez la connexion OAuth. Connectez-vous à Gradiently, choisissez un espace et vérifiez les autorisations. Seuls les propriétaires et administrateurs peuvent connecter un assistant. Les connexions expirent après une heure et se renouvellent automatiquement pendant 30 jours au maximum. Révoquez une connexion dans Paramètres › API et agents pour arrêter immédiatement son accès et son renouvellement.

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.

Les permissions décident de ce qui fonctionne

Chaque clé porte des permissions, et chaque outil ou point de terminaison en exige certaines. Une nouvelle clé démarre avec les cinq dont la plupart des outils ont besoin, et vous pouvez ajouter ou retirer n’importe laquelle des huit. Clés API et permissions les liste toutes, et chaque outil de MCP et assistants IA indique les permissions qu’il demande.

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.

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"
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

Trouvez le style qui n’est qu’à vous.

Chaque Mark est un fond vivant avec un seul propriétaire. Essayez un Mark encore disponible et réservez le vôtre quand vous le sentez.

Commencer à créerVoir l’offre de lancement

Marks encore à réserver

50sur 1 000

950 réservés à ce jourTrouver le vôtre

Vérifier un certificat

Saisissez un numéro de certificat ou le code d’un Mark pour voir à qui il appartient.

Fonctionne avec ChatGPT et Claude

Demandez une création à votre IA. Elle la réalise dans votre Mark, prête à modifier.

ChatGPTClaude
Comment se connecter

Produit

  • Marché
  • Explorer
  • Tarifs
  • Packs de lancement
  • Certificats

Apprendre

  • Guide pratique
  • Centre d’aide
  • Nouveautés

Développeurs

  • Vue d’ensemble
  • ChatGPT et Claude
  • Référence de l’API
  • Clés API

Entreprise

  • À propos
  • Nous contacter
  • Se connecter

Mentions légales

  • Conditions
  • Confidentialité
  • Remboursements
  • Protection des Marks
  • Cookies
  • Toutes les politiques
Parcourez les lettres. Chacune porte un vrai Mark.Touchez une lettre pour voir son Mark.Un seul nom. Dix Marks à l’intérieur.
© 2026 Gradiently