Gradiently für Entwickler

Mit Gradiently entwickeln

Mit der API und dem MCP-Server von Gradiently kann dein Code oder dein KI-Assistent Marks suchen und Designs erstellen, die sich im Studio öffnen.

Aktualisiert am 1. Oktober 2026

Gradiently bietet dir zwei Zugänge. Mit dem MCP-Server kann ein KI-Assistent wie Claude Code die Werkzeuge von Gradiently nutzen, während du mit ihm sprichst. Mit der API ruft dein eigener Code dieselben Endpunkte direkt auf. Beide authentifizieren sich mit einem API-Schlüssel, der zu einem Arbeitsbereich gehört, und beide durchlaufen dieselben Prüfungen wie die App: Rollen im Arbeitsbereich, Lizenzen für Marks, KI-Credits und Ratenlimits.

Was du tun kannst

  • Den Markt durchsuchen und das vollständige Rezept jedes öffentlichen Marks lesen.
  • Markenvorschläge aus einem Namen und einer Beschreibung generieren und einen davon übernehmen: ein Mark-Entwurf, eine Marke und drei Startdesigns in einem Schritt.
  • Designs mit dem Designer von Gradiently, mit der Layout-Engine oder aus einer Vorlage erstellen und einen Link zurückbekommen, der sich im Studio öffnet.
  • Gespeicherte Designs Element für Element bearbeiten, ihre Texte ändern, Kopien in anderen Größen speichern und ihnen einen anderen Mark geben.
  • Ein gespeichertes Design als PNG oder PDF rendern oder einen Ansichtslink dafür veröffentlichen.
  • Mark-Rezepte aus einer Absicht schmieden, Farbe und Lesbarkeit prüfen lassen und Versionen deiner Entwürfe aufbewahren.

MCP oder die API

MCP-Server

  • Für KI-Assistenten, die Remote-MCP-Server unterstützen.
  • Eine Adresse: https://gradiently.design/api/mcp.
  • Werkzeuge finden deine Marke, speichern Designs und geben dir Studio-Links zurück.
  • Am besten, wenn du Aufgaben in einfachen Worten stellen willst.

API

  • Für Skripte, Back-Ends und Automatisierungen.
  • JSON über HTTPS unter https://gradiently.design/api.
  • Du wählst die Marke, schickst das Design-Dokument und verarbeitest jede Antwort.
  • Am besten, wenn du genaue, wiederholbare Kontrolle brauchst.

Die MCP-Werkzeuge bauen auf der API auf. Ein Werkzeugaufruf stellt dieselben Anfragen, die dein Code stellen würde, mit demselben Schlüssel. Er zählt also gegen dieselben Limits und scheitert mit denselben Meldungen.

Schnellstart

  1. 1

    Einen Schlüssel erstellen

    Öffne in Gradiently Einstellungen › API und Agenten, wähl den Arbeitsbereich, benenne den Schlüssel danach, wo du ihn einsetzt, leg fest, was er kann, und wähl Schlüssel erstellen. Kopier den Schlüssel, sobald er erscheint: Er wird nur einmal angezeigt. Nur Inhaber und Admins können Schlüssel erstellen.

  2. 2

    Deinen Assistenten verbinden

    Füg Gradiently in Claude Code als Remote-MCP-Server hinzu, mit deinem Schlüssel im Authorization-Header (der Befehl steht unten). Andere Clients findest du unter MCP und KI-Assistenten.

  3. 3

    Um etwas bitten

    Probier „Generiere drei Markenrichtungen für eine kleine Bäckerei namens Hearth, ruhig und warm, und übernimm dann die erste.“ Der Assistent ruft generate_brand und adopt_brand auf, und du bekommst in deinem Arbeitsbereich eine neue Marke mit eigenem Mark-Entwurf und Startdesigns.

bash
export GRADIENTLY_API_KEY="gr_live_…"

claude mcp add --transport http gradiently https://gradiently.design/api/mcp \
  --header "Authorization: Bearer $GRADIENTLY_API_KEY"
Bewahr den Schlüssel in einer Umgebungsvariable oder einem Secret-Manager auf, nie in einer Datei, die du committest.

Um stattdessen die API aufzurufen, schick bei jeder Anfrage denselben Header mit:

bash
curl https://gradiently.design/api/marks?q=harbour \
  -H "Authorization: Bearer $GRADIENTLY_API_KEY"
Die Suche im Markt braucht einen Schlüssel mit der Berechtigung „Marks suchen“ (marks:read).

Wie ein Schlüssel handelt

Ein Schlüssel handelt als die Person, die ihn erstellt hat, innerhalb des einen Arbeitsbereichs, für den er erstellt wurde. Er kann nie auf einen anderen Arbeitsbereich zugreifen, auch nicht auf einen, zu dem sein Ersteller gehört. Er funktioniert nur, solange sein Ersteller Inhaber oder Admin dieses Arbeitsbereichs ist und sein Konto aktiv ist; wird die Person entfernt, herabgestuft oder deaktiviert, hört der Schlüssel auf zu funktionieren.

  • Designs, Marken und Uploads, die ein Schlüssel erstellt, gehören dem Arbeitsbereich, genau so, als hätte sein Ersteller sie in der App gemacht.
  • Marks, die ein Schlüssel sichert, hält sein Ersteller, nie der Arbeitsbereich, und jede Lizenz bleibt bei ihm.
  • Arbeit des Designers, die ein Schlüssel startet, verbraucht die KI-Credits des Arbeitsbereichs, wie der Designer im Studio.
  • Ein Schlüssel kann keine Schlüssel verwalten, das Konto ändern, auf die Abrechnung zugreifen oder einen Mark weitergeben. API-Schlüssel und Scopes listet auf, was er nie kann.

Die übrige Dokumentation

  • MCP und KI-Assistenten: Claude Code und andere Clients verbinden, jedes Werkzeug mit seinen Eingaben und Scopes, und Beispiel-Prompts.
  • API-Referenz: die Basis-URL, die Authentifizierung, jeder Endpunkt, den ein Schlüssel aufrufen kann, Fehler, Ratenlimits und Paginierung.
  • API-Schlüssel und Scopes: Schlüssel erstellen, rotieren und widerrufen, was jeder Scope erlaubt und wie du Schlüssel sicher aufbewahrst.
  • Neu bei MCP? Was ist MCP erklärt es in einfachen Worten, und modelcontextprotocol.io hat die Spezifikation.

Kommst du nicht weiter, oder fehlt dir etwas? Schick uns eine Anfrage, und ein Mensch antwortet dir.

Brauchst du Hilfe?

Schick uns eine Anfrage mit dem Thema „API und MCP“, und ein Mensch antwortet dir.

Anfrage senden