Die Kurzfassung
- Gradiently betreibt einen gehosteten MCP-Server unter https://gradiently.design/api/mcp, mit dem sich jeder MCP-Client verbinden kann, der einen Authorization-Header senden kann.
- Du verbindest dich mit einem API-Schlüssel, den ein Inhaber oder Admin des Arbeitsbereichs in den Einstellungen unter API und Agenten erstellt und der als Bearer-Token gesendet wird.
- Jeder Schlüssel gehört zu einem Arbeitsbereich und trägt nur die Berechtigungen, die beim Erstellen angekreuzt wurden, etwa Designs lesen oder Marks suchen.
- Nach der Verbindung kann ein Assistent Marks suchen, dein Markenprofil lesen, Designs erstellen, bearbeiten und in der Größe ändern, und jedes Design öffnet sich im Studio.
- Ein Schlüssel wird nur einmal angezeigt, lässt sich jederzeit widerrufen und überträgt nie das Eigentum an einem Mark auf jemand anderen.
Auf dieser Seite
Um den Gradiently-MCP-Server zu nutzen, erstelle in Einstellungen › API und Agenten einen API-Schlüssel und trage dann den gehosteten Endpunkt https://gradiently.design/api/mcp mit dem Header Authorization: Bearer <dein Schlüssel> in deinen MCP-Client ein. Das ist die ganze Verbindung. Danach kann ein Assistent wie Claude Marks suchen, deine Marke lesen, Designs erstellen und ändern, und jedes Design, das er macht, öffnet sich wie jedes andere in deinem Studio.
MCP, das Model Context Protocol, ist ein offener Standard, mit dem KI-Assistenten echte Werkzeuge nutzen können. Ist dir die Idee neu, erklärt Was ist MCP sie in einfachen Worten, und die Seite des Protokolls unter modelcontextprotocol.io enthält die Spezifikation. Die vollständige technische Referenz zum Gradiently-Server steht in den Entwicklerdokumenten.
Was du vor dem Start brauchst
- Ein Gradiently-Konto und einen Arbeitsbereich, in dem du Inhaber oder Admin bist. Nur Inhaber und Admins können Schlüssel erstellen oder widerrufen.
- Einen MCP-Client, der sich per HTTP mit einem entfernten Server verbinden und einen eigenen `Authorization`-Header senden kann. Claude Code kann das; viele Desktop- und Editor-Clients ebenfalls.
- Einen sicheren Ort für den Schlüssel, etwa einen Passwort-Manager oder den Geheimspeicher deines Clients. Er wird nur einmal angezeigt.
Schritt 1: einen begrenzten API-Schlüssel erstellen
- 1
Öffne Einstellungen › API und Agenten
Wähle oben mit der Auswahl den Arbeitsbereich, in dem der Assistent arbeiten soll. Ein Schlüssel wirkt immer nur in dem Arbeitsbereich, der ihn ausgestellt hat.
- 2
Benenne ihn danach, wo er genutzt wird
„Claude Desktop“ oder „Marketing-Agent“. Am Namen erkennst du später, welchen du widerrufen musst.
- 3
Kreuze nur an, was er braucht
Die Berechtigungen stehen unten in der Liste. Vier sind standardmäßig angekreuzt; Marks sichern nicht.
- 4
Erstellen und jetzt kopieren
Der Schlüssel erscheint einmal vollständig. Kopiere ihn in deinen Passwort-Manager, bevor du den Dialog schließt. Danach zeigen die Einstellungen nur seine ersten Zeichen, wann er zuletzt genutzt wurde und wie viele Berechtigungen er hat.
| Berechtigung | Was sie dem Assistenten erlaubt |
|---|---|
| Designs lesen | Designs im Arbeitsbereich auflisten und öffnen |
| Designs erstellen und bearbeiten | Neue Designs erstellen und ändern |
| Marks suchen | Marks im Markt nachschlagen |
| Marks sichern | Einen Mark für diesen Arbeitsbereich sichern (standardmäßig aus) |
| Marken generieren | Aus einer Beschreibung Markenvorschläge erstellen |
Schritt 2: den Endpunkt in deinem Client eintragen
Dieselbe Seite zeigt unter Einen MCP-Client verbinden einen fertigen Ausschnitt mit Kopierknopf. Clients, die eine JSON-Konfiguration lesen, übernehmen ihn unverändert; setze deinen Schlüssel anstelle von YOUR_KEY ein.
{
"mcpServers": {
"gradiently": {
"url": "https://gradiently.design/api/mcp",
"headers": { "Authorization": "Bearer YOUR_KEY" }
}
}
}In Claude Code fügst du den Server im Terminal hinzu. Halte den Schlüssel in einer Umgebungsvariable, statt ihn in den Verlauf deiner Shell zu tippen.
claude mcp add --transport http gradiently https://gradiently.design/api/mcp \
--header "Authorization: Bearer $GRADIENTLY_API_KEY"Andere Assistenten, darunter ChatGPT, können sich verbinden, wo ihre App, ihr Tarif und ihre Arbeitsbereichseinstellungen einen benutzerdefinierten entfernten MCP-Server mit Autorisierungs-Header erlauben. Die Unterstützung unterscheidet sich je Client und ändert sich mit der Zeit, sieh also in den Hilfeseiten deines Clients nach; Markenkonforme Designs aus ChatGPT erstellen zeigt, worauf du achten solltest. Nach der Verbindung bitte den Assistenten, seine Gradiently-Werkzeuge aufzulisten, um zu bestätigen, dass es geklappt hat.
Was dein Assistent nach der Verbindung kann
Der Server stellt dieselben Aktionen bereit, die du im Produkt hast, über dieselben Berechtigungen. Nach Aufgaben gruppiert sehen sie so aus:
| Aufgabe | Was der Assistent tun kann |
|---|---|
| Finden | Marks nach Name, Code oder Ton suchen; das Rezept eines Marks lesen; deine Marks auflisten; Vorlagen als Ausgangspunkt finden |
| Gestalten | Den Designer von Gradiently ein Design aus einer einfachen Anfrage erstellen oder ändern lassen; aus einem Briefing ein Set von Designs machen; von einer Vorlage ausgehen; Text und Elemente bearbeiten |
| Größe ändern | Kopien eines Designs in anderen Größen neben dem Original speichern, das unverändert bleibt |
| Marke | Das Profil einer Marke lesen und aktualisieren; Markenvorschläge generieren und eine Marke mit einem Mark und Starter-Designs einrichten |
| Marks | Ein Mark-Rezept aus einer Beschreibung in der Forge erstellen und als privaten Entwurf speichern; einen Mark auf ein Design legen; einen Mark sichern, wenn der Schlüssel es erlaubt |
| Teilen und exportieren | Einen Link nur zum Ansehen für ein Design einschalten oder es als PNG oder PDF rendern, wenn der Mark gesichert ist |
Einfache Anfragen funktionieren am besten. Der Assistent gibt sie an den Designer weiter, der dein Markenprofil und den Mark der Marke liest, bevor er etwas zusammenstellt. Wie im Studio wird die Arbeit des Designers in KI-Credits gemessen.
Was „ein Plakat für unsere Sonnenwendparty auf dem Dach, 21. Juni, von Sonnenuntergang bis Sonnenaufgang“ ergeben kann: ein gespeichertes Design auf dem Mark deiner Marke, bereit zum Öffnen und Anpassen.
- „Mach sechs Posts für unseren Herbst-Launch in unserer Marke, Hochformat für Instagram.“
- „Nimm die Ankündigung von gestern und mach daraus eine Story und ein X-Header-Bild.“
- „Finde drei dunkle Marks mit Seidenmaterial und nenne mir ihre Codes.“
- „Aktualisiere unser Markenprofil: Wir klingen ruhig und präzise, nie werblich.“
Eine ausführlichere Anleitung speziell mit Claude findest du in Mit Claude über Gradiently gestalten. Soll der Assistent markenkonform bleiben, zeigt Markenrichtlinien, denen dein KI-Assistent folgt, wie du das Markenprofil schreibst, das er liest.
Die Verbindung sicher halten
Vermeiden
- Ein Schlüssel mit allen Berechtigungen, von jedem Tool geteilt
- Einen Schlüssel in einen Chat, ein Dokument oder ein Repository einfügen
- Schlüssel für Tools liegen lassen, die du nicht mehr nutzt
- Marks sichern für einen Agenten ankreuzen, der nur gestaltet
Besser
- Ein Schlüssel pro Client, benannt danach, wo er läuft
- Im Passwort-Manager oder Geheimspeicher ablegen
- Ungenutzte Schlüssel in den Einstellungen widerrufen; sie enden sofort
- Die kleinste Menge an Berechtigungen vergeben, die funktioniert
Einige Zusagen gelten, egal was der Client tut. Ein Schlüssel funktioniert nur in dem Arbeitsbereich, der ihn ausgestellt hat. Er handelt nach denselben Regeln wie die Person, die ihn erstellt hat, kann also nichts, was ihre Rolle nicht kann. Ein Schlüssel überträgt nie das Eigentum an einem Mark auf den Arbeitsbereich oder jemand anderen. Private Designs bleiben privat: Einen Link nur zum Ansehen gibt es nur, wenn du ihn verlangst. Und wird die Person, die einen Schlüssel erstellt hat, aus dem Arbeitsbereich entfernt oder verliert ihre Admin-Rolle, hören auch ihre Schlüssel auf zu funktionieren.
Häufige Fragen
Wie lautet der Gradiently-MCP-Endpunkt?
Der gehostete Endpunkt ist https://gradiently.design/api/mcp. Jede Anfrage braucht den Header Authorization: Bearer gefolgt von einem API-Schlüssel aus Einstellungen › API und Agenten.
Wer kann einen Gradiently-API-Schlüssel erstellen?
Inhaber und Admins eines Arbeitsbereichs. Jeder Schlüssel gehört zu genau diesem Arbeitsbereich und trägt nur die Berechtigungen, die beim Erstellen angekreuzt wurden.
Funktioniert es mit ChatGPT?
Es funktioniert mit jedem MCP-Client, der sich mit einem entfernten HTTP-Server verbinden und einen Autorisierungs-Header senden kann. Ob ChatGPT das kann, hängt von App, Tarif und Arbeitsbereichseinstellungen ab, sieh also in den aktuellen Hilfeseiten nach.
Was passiert, wenn mein Schlüssel offengelegt wird?
Widerrufe ihn in Einstellungen › API und Agenten. Alles, was ihn nutzt, hört sofort auf zu funktionieren, und du kannst einen neuen Schlüssel erstellen.
Kann ein Assistent Marks für mich sichern?
Nur wenn sein Schlüssel die Berechtigung Marks sichern hat, die standardmäßig aus ist. Das Sichern ist kostenlos, solange Gradiently startet.
Geschrieben von Gradiently
Das Team hinter Gradiently, einem Designtool rund um Marks: lebendige Farbverläufe, durch die alles, was du gestaltest, nach dir aussieht.
Unser Profil ansehen
