Der Server akzeptiert OAuth-Zugriffstoken und API-Schlüssel für Arbeitsbereiche. Für beide gelten dieselben Berechtigungen, Lizenzen, Credits und Limits. Das Model Context Protocol ist ein offener Standard, um KI-Assistenten Werkzeuge zu geben. Gradiently betreibt einen gehosteten MCP-Server. ChatGPT verbindet sich mit https://, Claude und andere Clients mit https://. Verbinde ihn einmal mit einem API-Schlüssel, und dein Assistent kann die Werkzeuge von Gradiently aufrufen, während du mit ihm sprichst. Jedes Werkzeug stellt dieselben API-Anfragen, die dein eigener Code stellen würde, und hat daher dieselben Berechtigungen, Lizenzen, Credits und Limits.
Bevor du dich verbindest
- Erstelle einen Schlüssel unter Einstellungen › API und Agenten (siehe API-Schlüssel und Scopes). Der Schlüssel entscheidet, in welchem Arbeitsbereich der Assistent arbeitet und welche Werkzeuge funktionieren.
- Ein Client mit API-Schlüssel sendet
Authorization: Bearer gr_live_…. ChatGPT und Claude senden nach der Anmeldung das OAuth-Token. - Der Server spricht Streamable HTTP, zustandslos, mit JSON-Antworten. Er braucht keine Sitzung und hat keinen separaten Event-Stream, den du öffnen müsstest.
- Der Server akzeptiert OAuth-Zugriffstoken und API-Schlüssel für Arbeitsbereiche. Für beide gelten dieselben Berechtigungen, Lizenzen, Credits und Limits.
ChatGPT und Claude verbinden
Füge einen benutzerdefinierten Connector mit ChatGPT: https://; Claude: https:// hinzu und wähle die OAuth-Anmeldung. Melde dich bei Gradiently an, wähle einen Arbeitsbereich und prüfe die Berechtigungen. Nur Inhaber und Administratoren können einen Assistenten verbinden.
Verbindungen laufen nach einer Stunde ab und werden bis zu 30 Tage lang automatisch erneuert. Widerrufe eine Verbindung unter Einstellungen › API und Agenten, um Zugriff und Erneuerung sofort zu stoppen.
Eine eigene Verbindung und ein Eintrag im öffentlichen Verzeichnis sind getrennte Schritte. Der Verzeichniseintrag erfordert die Prüfung und Genehmigung durch OpenAI oder Anthropic.
Claude Code verbinden
Füg Gradiently als Remote-Server über HTTP hinzu, mit deinem Schlüssel im Header. Bewahr den Schlüssel in einer Umgebungsvariable auf, damit er nie in deinem Shell-Verlauf oder einer committeten Datei landet.
# 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"Starte eine neue Sitzung in Claude Code und bitte es, die Werkzeuge von Gradiently aufzulisten, um die Verbindung zu prüfen. Meldet es einen Authentifizierungsfehler, wurde der Schlüssel falsch eingegeben oder widerrufen, oder sein Ersteller ist kein Inhaber oder Admin des Arbeitsbereichs mehr.
Andere Clients
Jeder Client, der einen Remote-MCP-Server über Streamable HTTP hinzufügen und einen eigenen Request-Header senden kann, kann Gradiently mit derselben URL und demselben Header nutzen. Ob deiner das kann, hängt vom Client und seiner Version ab.
- Clients, die über eine JSON-Datei konfiguriert werden, akzeptieren oft die Form unten, die auch in den Einstellungen unter Einen MCP-Client verbinden steht. Das genaue Format findest du in der Dokumentation deines Clients.
{
"mcpServers": {
"gradiently": {
"url": "https://gradiently.design/api/mcp",
"headers": { "Authorization": "Bearer gr_live_…" }
}
}
}Wie sich die Werkzeuge verhalten
- Die Werkzeuge liefern JSON-Text.
inspect_designliefert außerdem ein PNG-Bild. Bei Fehlern wird eine Fehlermeldung zurückgegeben. - Werkzeuge, die eine Marke brauchen, nehmen optional
personality(ihre ID oder ihren Slug). Ohne diese Angabe nutzen sie die erste Marke des Arbeitsbereichs. - Werkzeuge, die ein Design speichern, geben seinen Studio-Link zurück, die Adresse
/des Designs auf gradiently.design.studio/ <id> - Mehrere Werkzeuge schlagen deine Marken zuerst über
/nach, was sowohlapi/ me workspaces:readals auchdesigns:readbraucht. Bei diesen Werkzeugen stehen unten beide Scopes. - Ein Werkzeugaufruf zählt gegen das Ratenlimit deines Schlüssels einmal für die MCP-Anfrage und einmal für jede API-Anfrage, die das Werkzeug stellt.
Marks
search_marksWas es tut
Eingaben
q, tone (dark oder light), limit (1 bis 120, Standard 24), alle optionalScopes
marks:readget_markWas es tut
Eingaben
code (ein Code oder eine ID)Scopes
marks:readlist_marksWas es tut
Eingaben
Scopes
marks:readclaim_markWas es tut
Eingaben
codeScopes
marks:read, marks:claimexport_markWas es tut
Eingaben
mark, width, height, personalityScopes
workspaces:read, designs:read, designs:writerestore_mark_versionWas es tut
Eingaben
mark, versionScopes
brand:generateupdate_mark_versionWas es tut
Eingaben
mark, version, label, starredScopes
brand:generatedelete_mark_versionWas es tut
Eingaben
mark, versionScopes
brand:generateEin Sichern, das eine Zahlung braucht, scheitert mit dem Hinweis, dass ein Checkout nötig ist; schließ es in Gradiently ab. Ein Schlüssel kann nichts bezahlen.
Marken und Arbeitsbereich
list_personalitiesWas es tut
Eingaben
Scopes
workspaces:read, designs:readcreate_personalityWas es tut
Eingaben
nameScopes
personalities:writeget_brand_profileWas es tut
Eingaben
personalityScopes
workspaces:read, designs:readupdate_brand_profileWas es tut
Eingaben
personality, profileScopes
workspaces:read, designs:read, personalities:writemy_workspaceWas es tut
Eingaben
Scopes
workspaces:read, designs:read, marks:readlist_workspacesWas es tut
Eingaben
cursorScopes
workspaces:readinvite_memberWas es tut
Eingaben
workspaceId, email, role (admin, editor oder viewer)Scopes
members:writetone nimmt bis zu drei der Werte calm, bold, warm, cool, playful, luxe, natural, technical, editorial und nocturnal an; eine Anfrage mit mehr wird abgelehnt. colours nimmt bis zu acht Hex-Farben an, und count fordert einen bis acht Vorschläge an; mehr davon wird ebenfalls abgelehnt. Um einen Vorschlag zu übernehmen, schick genau die Eingabe, die ihn erzeugt hat, zusammen mit dem key des Vorschlags: Der Server erzeugt den Vorschlag aus dieser Eingabe neu und vertraut nie einem Rezept, das der Client schickt.
Gestalten
Für eigene Designs soll deine verbundene KI das Markenprofil und get_design_guidance lesen, mit draw_design gestalten, das echte Bild mit inspect_design prüfen und mit edit_design verfeinern. Direktes Zeichnen, Bearbeiten und Prüfen verbraucht keine Gradiently-KI-Credits. Die Nutzungslimits deines Anbieters sowie Konto- und Exportberechtigungen gelten weiterhin. Eine Zeichnung kann eigene Vektorillustrationen des Hosts, bereinigtes SVG, echte Diagramme, Grafiken aus der Bibliothek und lizenzierte Fotos enthalten; alles bleibt im Studio bearbeitbar. Fotosuche und -import greifen auf Openverse zu, einen externen Katalog.
get_design_guidanceWas es tut
Eingaben
purpose, topicScopes
draw_designWas es tut
Eingaben
drawing, personality, mark, designId, page, titleScopes
designs:write, workspaces:read, designs:read, marks:readinspect_designWas es tut
Eingaben
id, page, maxDimensionScopes
designs:readfind_iconsWas es tut
Eingaben
query, limitScopes
find_graphicsWas es tut
Eingaben
query, limitScopes
find_photosWas es tut
Eingaben
query, countScopes
designs:readimport_photoWas es tut
Eingaben
idScopes
designs:writedesignBittet den Designer von Gradiently, aus einer einfachen Anfrage ein Design zu machen oder eines zu ändern. Er liest das Markenprofil und den Mark, gestaltet, prüft und speichert. Verwendet Gradiently-KI-Credits.Eingaben
request, personality, size, designId, scope, selectionScopes
workspaces:read, designs:read, designs:writecreate_designsWas es tut
Eingaben
brief, items (size, brief, title), title, personality, mark, waitScopes
workspaces:read, designs:read, designs:writeget_design_setWas es tut
Eingaben
idScopes
designs:readstop_design_setWas es tut
Eingaben
idScopes
designs:writecompose_designWas es tut
Eingaben
composition, personality, designId, titleScopes
workspaces:read, designs:read, designs:writelist_sizesWas es tut
Eingaben
Scopes
create_designWas es tut
Eingaben
form, size, copy, look, personalityScopes
workspaces:read, designs:read, designs:writedesign und create_designs verbrauchen die KI-Credits des Arbeitsbereichs, so wie der Designer im Studio. Ist das Guthaben zu niedrig, scheitern sie mit einer entsprechenden Meldung; lade unter Einstellungen › KI-Credits auf. Pro Person laufen höchstens zwei Reihen gleichzeitig, und eine fertige Reihe bleibt etwa zwanzig Minuten lang abrufbar. Die Designs selbst bleiben erhalten.
Eine Komposition nennt eine size (die ID einer Vorgabe wie ig-post, x-post oder li-banner, oder {w, h} in Pixeln), ein layout (statement, editorial, poster, split, stat, quote, list, event oder minimal) und blocks in Lesereihenfolge, jeweils mit einer role wie headline, body oder cta und ihrem text.
{
"composition": {
"size": "ig-post",
"layout": "event",
"blocks": [
{ "role": "eyebrow", "text": "Summer supper club" },
{ "role": "headline", "text": "Long table on the roof" },
{ "role": "details", "text": "", "items": ["Saturday 21 June", "7pm till late"] },
{ "role": "cta", "text": "Book a seat" }
]
}
}compose_design. Die Antwort enthält die ID des Designs, seinen Studio-Link, Prüfhinweise und die platzierten Elemente.Bearbeiten und exportieren
list_designsWas es tut
Eingaben
personalityScopes
workspaces:read, designs:readget_designWas es tut
Eingaben
id, page, kind, name, textScopes
designs:readedit_designWas es tut
Eingaben
id, ops, pageScopes
designs:writeupdate_design_textWas es tut
Eingaben
id, text (Element-ID zu Worten)Scopes
designs:read, designs:writeresize_copiesWas es tut
Eingaben
id, sizesScopes
designs:read, designs:writewear_markWas es tut
Eingaben
mark, und design oder personalityScopes
render_designWas es tut
Eingaben
id, width, height, format, pageScopes
designs:readexport_design_linkWas es tut
/ d/ <id>, den jeder öffnen kann, der ihn hat.Eingaben
idScopes
designs:writewear_mark auf einem Design braucht designs:read und designs:write. Um einen Mark zum Mark einer Marke zu machen, braucht es workspaces:read, designs:read und personalities:write sowie einen Mark, den du mit aktiver Lizenz hältst. Wenn du den Mark über seinen Code angibst, brauchst du außerdem marks:read.
render_design nimmt width und height von 1 bis 4096 Pixeln und format png oder pdf. page zählt ab 0: PNG rendert standardmäßig die erste Seite, PDF alle Seiten. Ein PDF behält jede Seite in ihrer Größe aus dem Studio, die angefragte Größe muss also passen. Zum Rendern braucht es für den Mark des Designs dieselbe Exportlizenz wie im Studio, und das Design wird dabei nie veröffentlicht oder verändert.
Video, Audio und Untertitel
Finde mit find_uploads zugelassene Quellen und nutze dann edit_design mit add_video, update_video, split_video, add_audio, update_audio, split_audio, remove_audio, set_element_timing, set_captions oder remove_captions. Schätze niemals die Quelldauer. Videoschnitte und Elementzeiten verwenden Sekunden innerhalb der Seite; Audiostarts, Audioschnitte und Untertitel verwenden Sekunden im gesamten Dokument. Audio verlängert die Szenen nicht. Untertitel nehmen vorgegebene Einträge mit Zeiten oder SRT/WebVTT-Inhalt an; automatische Transkription ist nicht verfügbar. get_design liefert die gesamte Zeitleiste und alle Spuren. export_captions gibt SRT/WebVTT-Dateiinhalte in Teilen mit höchstens 100 Untertiteln und 48.000 Zeichen zurück; nextOffset führt zum nächsten Teil.
Beispiel-Prompts
- „Finde dunkle Marks mit Chrom im Markt und zeig mir die drei, die Dunkelpetrol am nächsten kommen.“ Nutzt
search_marks. - „Ändere die Überschrift in Design 4f1c… zu ‚Einlass ab sieben‘ und mach Kopien für eine Instagram-Story und einen X-Post.“ Nutzt
get_design,update_design_textundresize_copies. - „Rendere Design 4f1c… als PNG mit 1080 mal 1350 und speichere es als launch.png.“ Nutzt
render_design. - „Mach ein Poster für unsere Sonnwendparty auf der Dachterrasse, 21. Juni, von Sonnenuntergang bis Sonnenaufgang.“ Nutzt
design, dasworkspaces:readbraucht.
Die vollständige Referenz der Endpunkte hinter diesen Werkzeugen steht unter API-Referenz. Für alles andere schick uns eine Anfrage.