MarktErkundenAnprobieren
Preise
AnmeldenLoslegen
Entwickler

API-Schlüssel und Scopes

Mit einem API-Schlüssel arbeitet ein Tool oder KI-Assistent in einem Arbeitsbereich als die Person, die ihn erstellt hat, beschränkt auf die Scopes, die du wählst. Behandle ihn wie ein Passwort.

Aktualisiert am 4. Oktober 2026

Entwicklerdokumentation

  • Überblick
  • MCP und KI-Assistenten
  • API-Referenz
  • API-Schlüssel und Scopes

Auf dieser Seite

Einen Schlüssel erstellenScopesEinen Schlüssel rotierenEinen Schlüssel widerrufenWas ein Schlüssel nie kannSchlüssel sicher aufbewahren

Der Server akzeptiert OAuth-Zugriffstoken und API-Schlüssel für Arbeitsbereiche. Für beide gelten dieselben Berechtigungen, Lizenzen, Credits und Limits. Ein Schlüssel gehört zu einem Arbeitsbereich, handelt als der Inhaber oder Admin, der ihn erstellt hat, und erreicht nur die Endpunkte, die seine Scopes erlauben. Schlüssel beginnen mit gr_live_, gefolgt von 43 Buchstaben, Ziffern, Bindestrichen und Unterstrichen.

Füge einen benutzerdefinierten Connector mit ChatGPT: https://gradiently.design/api/mcp/chatgpt; Claude: https://gradiently.design/api/mcp 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.

Einen Schlüssel erstellen

  1. 1

    API und Agenten öffnen

    Geh in Gradiently zu Einstellungen › API und Agenten und wähl den Arbeitsbereich, für den der Schlüssel ist. Nur Inhaber und Admins dieses Arbeitsbereichs können Schlüssel erstellen.

  2. 2

    Ihn benennen

    Gib ihm unter Schlüssel erstellen im Feld Name einen Namen danach, wo du ihn einsetzt, etwa Claude Code oder Nächtlicher Export, damit du später weißt, welchen du widerrufen musst.

  3. 3

    Festlegen, was er kann

    Wähl unter Was er kann die Berechtigungen aus, die er braucht, mindestens eine. Der nächste Abschnitt erklärt jede davon.

  4. 4

    Ihn einmal kopieren

    Wähl Schlüssel erstellen. Der Schlüssel erscheint unter Kopiere deinen Schlüssel jetzt, und das ist das einzige Mal, dass er angezeigt wird. Kopier ihn in einen Passwort-Manager oder deinen Secret-Speicher und wähl dann Ich hab ihn gespeichert.

Wer einen Schlüssel erstellt, bekommt eine E-Mail, wenn er erstellt und wenn er widerrufen wird, mit seinem Namen, dem Anfang des Schlüssels und seinen Berechtigungen. Die Liste in den Einstellungen zeigt für jeden aktiven Schlüssel den Namen, den Anfang des Schlüssels, wann er zuletzt verwendet wurde und wie viele Berechtigungen er hat.

Scopes

Ein Scope ist eine Berechtigung. Eine Anfrage braucht jeden Scope, den ihr Endpunkt nennt, und jedes MCP-Werkzeug braucht die Scopes aller Anfragen, die es stellt. Vergib nur, was die Aufgabe braucht.

designs:read

In den Einstellungen

Designs lesen

Was er erlaubt

Marken, Designs, Vorschaubilder und Uploads lesen, Designs rendern und Designer-Reihen verfolgen.
designs:write

In den Einstellungen

Designs erstellen und bearbeiten

Was er erlaubt

Designs erstellen, ändern, duplizieren, teilen und löschen, Bilder hochladen und löschen und den Designer ausführen.
marks:read

In den Einstellungen

Marks suchen

Was er erlaubt

Den Markt durchsuchen, Marks und deine Entwürfe lesen, Rezepte bauen und prüfen und Versionen von Marks lesen.
marks:claim

In den Einstellungen

Marks sichern

Was er erlaubt

Einen verfügbaren Mark oder einen, den ein anderer Inhaber anbietet, für den Ersteller des Schlüssels sichern.
brand:generate

In den Einstellungen

Marken generieren

Was er erlaubt

Marken generieren und übernehmen, Mark-Entwürfe speichern und ändern und Versionen von Marks verwalten.
workspaces:read

In den Einstellungen

Arbeitsbereich lesen

Was er erlaubt

Den Arbeitsbereich, seine Mitglieder und sein Audit-Log lesen. Zusammen mit designs:read auch /api/me lesen.
personalities:write

In den Einstellungen

Marken bearbeiten

Was er erlaubt

Marken erstellen, umbenennen und löschen und den Mark, das Profil und den Stil einer Marke ändern.
members:write

In den Einstellungen

Mitglieder einladen

Was er erlaubt

Einladungen in den Arbeitsbereich verschicken.
ScopeIn den EinstellungenWas er erlaubt
designs:readDesigns lesenMarken, Designs, Vorschaubilder und Uploads lesen, Designs rendern und Designer-Reihen verfolgen.
designs:writeDesigns erstellen und bearbeitenDesigns erstellen, ändern, duplizieren, teilen und löschen, Bilder hochladen und löschen und den Designer ausführen.
marks:readMarks suchenDen Markt durchsuchen, Marks und deine Entwürfe lesen, Rezepte bauen und prüfen und Versionen von Marks lesen.
marks:claimMarks sichernEinen verfügbaren Mark oder einen, den ein anderer Inhaber anbietet, für den Ersteller des Schlüssels sichern.
brand:generateMarken generierenMarken generieren und übernehmen, Mark-Entwürfe speichern und ändern und Versionen von Marks verwalten.
workspaces:readArbeitsbereich lesenDen Arbeitsbereich, seine Mitglieder und sein Audit-Log lesen. Zusammen mit designs:read auch /api/me lesen.
personalities:writeMarken bearbeitenMarken erstellen, umbenennen und löschen und den Mark, das Profil und den Stil einer Marke ändern.
members:writeMitglieder einladenEinladungen in den Arbeitsbereich verschicken.

Mit den Standardwerten starten

Ein neuer Schlüssel startet mit designs:read, designs:write, marks:read, brand:generate und workspaces:read, was das Gestalten mit einem KI-Assistenten abdeckt. Füg marks:claim, personalities:write oder members:write nur hinzu, wenn der Schlüssel Marks sichern, Marken ändern oder Leute einladen soll.

Bei neuen Schlüsseln sind „Designs lesen“, „Designs erstellen und bearbeiten“, „Marks suchen“, „Marken generieren“ und „Arbeitsbereich lesen“ vorausgewählt. Marks sichern bleibt aus, bis du es wählst, denn beim Sichern wirst du, der Ersteller des Schlüssels, zum Halter eines Marks.

Einen Schlüssel rotieren

Schlüssel laufen nicht ab, und Name und Scopes eines Schlüssels lassen sich nach dem Erstellen nicht ändern. Um einen Schlüssel zu rotieren oder zu ändern, was er kann, ersetze ihn:

  1. 1

    Den neuen Schlüssel erstellen

    Erstelle einen Schlüssel mit den gewünschten Scopes und einem Namen, an dem du ihn vom alten unterscheiden kannst.

  2. 2

    Deine Tools umstellen

    Setz den neuen Schlüssel überall ein, wo der alte verwendet wurde: in deinem MCP-Client, deinem Secret-Speicher oder deinen Deployment-Einstellungen.

  3. 3

    Den alten Schlüssel widerrufen

    Sobald sich das Datum hinter verwendet am beim alten Schlüssel in der Liste nicht mehr ändert, widerrufe ihn.

Einen Schlüssel widerrufen

Wähl unter Einstellungen › API und Agenten neben dem Schlüssel Widerrufen und bestätige mit Schlüssel widerrufen. Alles, was ihn verwendet, hört sofort auf zu funktionieren, und das lässt sich nicht rückgängig machen. Inhaber und Admins des Arbeitsbereichs können jeden seiner Schlüssel widerrufen.

Ein Schlüssel hört auch von selbst auf zu funktionieren, wenn sein Ersteller den Arbeitsbereich verlässt, unter Admin herabgestuft wird oder sein Konto deaktiviert wird. Schlüssel, die eine Person erstellt hat, werden widerrufen, wenn sie aus dem Arbeitsbereich entfernt oder herabgestuft wird.

Was ein Schlüssel nie kann

Manches braucht immer eine bei Gradiently angemeldete Person, egal welche Scopes der Schlüssel hat:

  • Schlüssel erstellen, auflisten oder widerrufen.
  • Das Konto ändern: Profil, E-Mail, Passwort, Anmeldesitzungen oder das Konto löschen.
  • Auf die Abrechnung zugreifen: Tarife, Checkout, Zahlungen, Aufladungen von KI-Credits, Guthaben und Auszahlungen. Ein Sichern oder Kauf, der eine Zahlung braucht, hält an und verlangt den Checkout in Gradiently.
  • Einen Mark weitergeben: ihn an jemand anderen übertragen, freigeben, zum Verkauf anbieten, verlängern oder veröffentlichen.
  • Das Halten oder die Lizenz eines Marks auf den Arbeitsbereich übertragen. Marks, die ein Schlüssel sichert, hält sein Ersteller, und jede Lizenz bleibt bei ihm.
  • Ändern, wer im Arbeitsbereich ist oder welche Rollen die Mitglieder haben, oder den Arbeitsbereich umbenennen, übertragen oder löschen. Mit members:write kann er nur Einladungen verschicken.
  • Auf einen anderen Arbeitsbereich als seinen eigenen zugreifen, auch nicht auf einen, zu dem sein Ersteller gehört.
  • Die Administration von Gradiently nutzen.

Schlüssel sicher aufbewahren

Das solltest du lassen

  • Einen Schlüssel in ein Repository committen oder in eine gemeinsam genutzte Konfigurationsdatei einfügen.
  • Einen Schlüssel in eine Webseite, eine mobile App oder irgendetwas packen, das auf dem Gerät eines anderen läuft.
  • Einen Schlüssel zwischen Personen oder Tools teilen.
  • Einen Schlüssel per E-Mail oder Chat verschicken.
  • „Marks sichern“ bei einem Schlüssel eingeschaltet lassen, der nichts sichert.

Das solltest du tun

  • Einen Schlüssel pro Tool oder Assistent anlegen und danach benennen.
  • Die wenigsten Scopes vergeben, mit denen die Aufgabe klappt.
  • Schlüssel in einem Passwort-Manager, einem Secret-Speicher oder einer Umgebungsvariable aufbewahren.
  • Einen Schlüssel sofort widerrufen, wenn er durchgesickert sein könnte, und dann einen neuen erstellen.
  • Ab und zu die Daten der letzten Verwendung prüfen und Schlüssel widerrufen, die niemand nutzt.

Gradiently speichert von jedem Schlüssel nur einen Hash und seinen Anfang für die Anzeige, ein verlorener Schlüssel lässt sich also nicht noch einmal anzeigen: Widerrufe ihn und erstelle einen neuen. Wenn du glaubst, dass ein Schlüssel missbraucht wurde, widerrufe ihn und sag uns Bescheid.

Brauchst du Hilfe?

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

Anfrage senden

Finde den Look, der nur dir gehört.

Jeder Mark ist ein lebendiger Hintergrund mit einem Besitzer. Probiere einen noch freien Mark und sichere dir deinen, wenn es sich richtig anfühlt.

Jetzt gestaltenZum Launch-Angebot

Marks noch zu sichern

50von 1.000

950 bisher gesichertFinde deinen

Zertifikat prüfen

Gib eine Zertifikatsnummer oder den Code eines Marks ein, um zu sehen, wem er gehört.

Funktioniert mit ChatGPT und Claude

Bitte deine KI um ein Design. Sie macht es in deinem Mark, bereit zum Bearbeiten.

ChatGPTClaude
So verbindest du sie

Produkt

  • Markt
  • Erkunden
  • Preise
  • Launch-Pakete
  • Zertifikate

Lernen

  • Leitfaden
  • Hilfe-Center
  • Neuigkeiten

Entwickler

  • Überblick
  • ChatGPT und Claude
  • API-Referenz
  • API-Schlüssel

Unternehmen

  • Über uns
  • Kontakt
  • Anmelden

Rechtliches

  • Nutzungsbedingungen
  • Datenschutz
  • Erstattungen
  • Mark-Schutz
  • Cookies
  • Alle Richtlinien
Fahr über die Buchstaben. Jeder trägt einen echten Mark.Tippe auf einen Buchstaben, um seinen Mark zu sehen.Ein Name. Zehn Marks darin.
© 2026 Gradiently