Gradiently voor ontwikkelaars

Bouw met Gradiently

Gebruik de API en de MCP-server van Gradiently, zodat je code of je AI-assistent Marks kan zoeken en ontwerpen kan maken die in de Studio openen.

Bijgewerkt 1 oktober 2026

Gradiently biedt je twee ingangen. Met de MCP-server kan een AI-assistent zoals Claude Code de tools van Gradiently gebruiken terwijl je met hem praat. Met de API roept je eigen code dezelfde endpoints rechtstreeks aan. Beide authenticeren met een API-key die bij één workspace hoort, en beide doorlopen dezelfde controles als de app: rollen in de workspace, Marklicenties, AI-credits en limieten.

Wat je kunt doen

  • De Markt doorzoeken en het volledige recept van elke openbare Mark lezen.
  • Merkkandidaten genereren op basis van een naam en een beschrijving, en er daarna een overnemen: een concept-Mark, een merk en drie startontwerpen in één stap.
  • Ontwerpen maken met de eigen Designer van Gradiently, met de layout-engine of vanuit een template, en een link terugkrijgen die in de Studio opent.
  • Opgeslagen ontwerpen per element bewerken, hun tekst wijzigen, kopieën in andere formaten opslaan en er een andere Mark op zetten.
  • Een opgeslagen ontwerp renderen naar PNG of PDF, of er een bekijklink voor publiceren.
  • Markrecepten smeden op basis van een bedoeling, hun kleur en leesbaarheid laten beoordelen, en versies van je concepten bewaren.

MCP of de API

MCP-server

  • Voor AI-assistenten die externe MCP-servers ondersteunen.
  • Eén adres: https://gradiently.design/api/mcp.
  • Tools zoeken je merk op, slaan ontwerpen op en geven Studio-links voor je terug.
  • Het beste als je werk in gewone woorden wilt vragen.

API

  • Voor scripts, back-ends en automatiseringen.
  • JSON via HTTPS onder https://gradiently.design/api.
  • Jij kiest het merk, stuurt het ontwerpdocument en verwerkt elk antwoord.
  • Het beste als je exacte, herhaalbare controle nodig hebt.

De MCP-tools zijn gebouwd op de API. Een toolaanroep doet dezelfde requests als je code zou doen, met dezelfde key, dus hij telt mee voor dezelfde limieten en faalt met dezelfde meldingen.

Snel aan de slag

  1. 1

    Maak een key aan

    Open in Gradiently Instellingen › API en agents, kies de workspace, geef de key een naam naar de plek waar je hem gebruikt, kies wat hij mag doen en klik op Key aanmaken. Kopieer de key zodra hij verschijnt: hij wordt maar één keer getoond. Alleen eigenaren en beheerders kunnen keys aanmaken.

  2. 2

    Koppel je assistent

    Voeg Gradiently in Claude Code toe als externe MCP-server, met je key in de Authorization-header (het commando staat hieronder). Andere clients staan op MCP en AI-assistenten.

  3. 3

    Vraag iets

    Probeer “Genereer drie merkrichtingen voor een kleine bakkerij die Hearth heet, rustig en warm, en neem daarna de eerste over.” De assistent roept generate_brand en adopt_brand aan, en je krijgt een nieuw merk met een eigen concept-Mark en startontwerpen in je workspace.

bash
export GRADIENTLY_API_KEY="gr_live_…"

claude mcp add --transport http gradiently https://gradiently.design/api/mcp \
  --header "Authorization: Bearer $GRADIENTLY_API_KEY"
Bewaar de key in een omgevingsvariabele of een secret manager, nooit in een bestand dat je commit.

Wil je in plaats daarvan de API aanroepen, stuur dan dezelfde header mee met elke request:

bash
curl https://gradiently.design/api/marks?q=harbour \
  -H "Authorization: Bearer $GRADIENTLY_API_KEY"
Voor zoeken in de Markt heb je een key nodig met het recht Marks zoeken (marks:read).

Hoe een key handelt

Een key handelt als de persoon die hem heeft aangemaakt, binnen de ene workspace waarvoor hij is aangemaakt. Hij kan nooit bij een andere workspace, ook niet bij een waar zijn maker lid van is. Hij werkt alleen zolang zijn maker nog eigenaar of beheerder van die workspace is en diens account actief is; wordt die persoon verwijderd, teruggezet of uitgeschakeld, dan stopt de key met werken.

  • Ontwerpen, merken en uploads die een key maakt, horen bij de workspace, precies alsof zijn maker ze in de app had gemaakt.
  • Marks die een key claimt, staan op naam van zijn maker, nooit van de workspace, en een eventuele licentie blijft van die persoon.
  • Werk van de Designer dat een key start, gebruikt de AI-credits van de workspace, net als de Designer in de Studio.
  • Een key kan geen keys beheren, het account wijzigen, bij facturering komen of een Mark weggeven. API-keys en rechten somt op wat hij nooit kan.

De rest van de documentatie

  • MCP en AI-assistenten: Claude Code en andere clients koppelen, elke tool met zijn invoer en rechten, en voorbeeldprompts.
  • API-referentie: de basis-URL, authenticatie, elk endpoint dat een key kan aanroepen, fouten, limieten en paginering.
  • API-keys en rechten: keys aanmaken, vervangen en intrekken, wat elk recht toestaat en hoe je keys veilig houdt.
  • Nieuw met MCP? Wat is MCP legt het in gewone woorden uit, en modelcontextprotocol.io heeft de specificatie.

Kom je er niet uit, of mis je iets? Stuur ons een verzoek en een mens antwoordt je.

Hulp nodig?

Stuur ons een verzoek met het onderwerp API en MCP, en een mens antwoordt je.

Een verzoek sturen