De server accepteert OAuth-toegangstokens en API-sleutels voor werkruimten. Voor beide gelden dezelfde rechten, licenties, credits en limieten. Het Model Context Protocol is een open standaard om AI-assistenten tools te geven. Gradiently draait een gehoste MCP-server. ChatGPT maakt verbinding met https://, Claude en andere clients met https://. Koppel hem één keer met een API-key, en je assistent kan de tools van Gradiently aanroepen terwijl je met hem praat. Elke tool doet dezelfde API-requests als je eigen code zou doen, dus hij heeft dezelfde rechten, licenties, credits en limieten.
Voordat je koppelt
- Maak een key aan in Instellingen › API en agents (zie API-keys en rechten). De key bepaalt in welke workspace de assistent werkt en welke tools werken.
- Een client met API-sleutel stuurt
Authorization: Bearer gr_live_…. ChatGPT en Claude sturen na het aanmelden het OAuth-token. - De server spreekt Streamable HTTP, stateless, met JSON-antwoorden. Hij heeft geen sessie nodig en er is geen aparte eventstream om te openen.
- De server accepteert OAuth-toegangstokens en API-sleutels voor werkruimten. Voor beide gelden dezelfde rechten, licenties, credits en limieten.
ChatGPT en Claude verbinden
Voeg een aangepaste connector toe met ChatGPT: https://; Claude: https:// en kies OAuth-aanmelding. Meld je aan bij Gradiently, kies een werkruimte en controleer de rechten. Alleen eigenaren en beheerders kunnen een assistent verbinden.
Verbindingen verlopen na een uur en worden tot 30 dagen automatisch vernieuwd. Trek een verbinding in via Instellingen › API en agents om toegang en vernieuwing meteen te stoppen.
Een aangepaste verbinding en een vermelding in de openbare directory zijn aparte stappen. Voor publicatie in de directory zijn beoordeling en goedkeuring door OpenAI of Anthropic nodig.
Claude Code koppelen
Voeg Gradiently toe als externe server via HTTP, met je key in de header. Bewaar de key in een omgevingsvariabele, zodat hij nooit in je shellgeschiedenis of in een gecommit bestand terechtkomt.
# 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"Start een nieuwe sessie in Claude Code en vraag om de tools van Gradiently te tonen, om de verbinding te controleren. Meldt hij een authenticatiefout, dan is de key verkeerd getypt of ingetrokken, of is zijn maker geen eigenaar of beheerder van de workspace meer.
Andere clients
Elke client die een externe MCP-server via Streamable HTTP kan toevoegen en een eigen request-header kan meesturen, kan Gradiently gebruiken met dezelfde URL en header. Of de jouwe dat kan, hangt af van de client en de versie.
- Clients die je met een JSON-bestand instelt, accepteren vaak de vorm hieronder, die ook in Instellingen staat onder Een MCP-client verbinden. Kijk in de documentatie van je client voor het precieze formaat.
{
"mcpServers": {
"gradiently": {
"url": "https://gradiently.design/api/mcp",
"headers": { "Authorization": "Bearer gr_live_…" }
}
}
}Hoe de tools werken
- De tools geven JSON-tekst terug.
inspect_designgeeft ook een PNG-afbeelding terug. Bij een fout krijg je een foutmelding. - Tools die een merk nodig hebben, nemen een optionele
personality(het id of de slug). Zonder merk gebruiken ze het eerste merk van de workspace. - Tools die een ontwerp opslaan, geven de Studio-link terug: het adres
/van het ontwerp op gradiently.design.studio/ <id> - Verschillende tools zoeken eerst je merken op via
/, waarvoor zowelapi/ me workspaces:readalsdesigns:readnodig is. Die tools noemen hieronder beide rechten. - Een toolaanroep telt mee voor de limiet van je key: één keer voor de MCP-request en één keer voor elke API-request die de tool doet.
Marks
search_marksWat hij doet
Invoer
q, tone (dark of light), limit (1 tot 120, standaard 24), allemaal optioneelRechten
marks:readget_markWat hij doet
Invoer
code (een code of een id)Rechten
marks:readlist_marksWat hij doet
Invoer
Rechten
marks:readclaim_markWat hij doet
Invoer
codeRechten
marks:read, marks:claimexport_markWat hij doet
Invoer
mark, width, height, personalityRechten
workspaces:read, designs:read, designs:writerestore_mark_versionWat hij doet
Invoer
mark, versionRechten
brand:generateupdate_mark_versionWat hij doet
Invoer
mark, version, label, starredRechten
brand:generatedelete_mark_versionWat hij doet
Invoer
mark, versionRechten
brand:generateEen claim waarvoor betaald moet worden, faalt met een melding dat er afgerekend moet worden; rond hem af in Gradiently. Een key kan nergens voor betalen.
Merken en workspace
list_personalitiesWat hij doet
Invoer
Rechten
workspaces:read, designs:readcreate_personalityWat hij doet
Invoer
nameRechten
personalities:writeget_brand_profileWat hij doet
Invoer
personalityRechten
workspaces:read, designs:readupdate_brand_profileWat hij doet
Invoer
personality, profileRechten
workspaces:read, designs:read, personalities:writemy_workspaceWat hij doet
Invoer
Rechten
workspaces:read, designs:read, marks:readlist_workspacesWat hij doet
Invoer
cursorRechten
workspaces:readinvite_memberWat hij doet
Invoer
workspaceId, email, role (admin, editor of viewer)Rechten
members:writetone accepteert hoogstens drie van calm, bold, warm, cool, playful, luxe, natural, technical, editorial en nocturnal; een request met meer wordt geweigerd. colours accepteert tot acht hexkleuren en count vraagt om één tot acht kandidaten; meer dan dat wordt ook geweigerd. Om een kandidaat over te nemen, stuur je precies de invoer die hem genereerde, met de key van de kandidaat: de server maakt de kandidaat opnieuw op basis van die invoer en vertrouwt nooit een recept dat de client stuurt.
Ontwerpen
Vraag je verbonden AI voor origineel werk om het merkprofiel en get_design_guidance te lezen, met draw_design te ontwerpen, de echte afbeelding met inspect_design te bekijken en met edit_design te verfijnen. Direct tekenen, bewerken en bekijken gebruikt geen Gradiently-AI-credits. De gebruikslimieten van je aanbieder en je account- en exportrechten blijven gelden. Een tekening kan eigen vectorillustraties van de host, opgeschoonde SVG, echte grafieken, bibliotheekafbeeldingen en gelicentieerde foto's bevatten; alles blijft bewerkbaar in de Studio. Foto's zoeken en importeren gebeurt via Openverse, een externe catalogus.
get_design_guidanceWat hij doet
Invoer
purpose, topicRechten
draw_designWat hij doet
Invoer
drawing, personality, mark, designId, page, titleRechten
designs:write, workspaces:read, designs:read, marks:readinspect_designWat hij doet
Invoer
id, page, maxDimensionRechten
designs:readfind_iconsWat hij doet
Invoer
query, limitRechten
find_graphicsWat hij doet
Invoer
query, limitRechten
find_photosWat hij doet
Invoer
query, countRechten
designs:readimport_photoWat hij doet
Invoer
idRechten
designs:writedesignVraagt de eigen Designer van Gradiently om op basis van een gewone vraag een ontwerp te maken of te wijzigen. Hij leest het merkprofiel en de Mark, ontwerpt, beoordeelt en slaat op. Gebruikt Gradiently-AI-credits.Invoer
request, personality, size, designId, scope, selectionRechten
workspaces:read, designs:read, designs:writecreate_designsWat hij doet
Invoer
brief, items (size, brief, title), title, personality, mark, waitRechten
workspaces:read, designs:read, designs:writeget_design_setWat hij doet
Invoer
idRechten
designs:readstop_design_setWat hij doet
Invoer
idRechten
designs:writecompose_designWat hij doet
Invoer
composition, personality, designId, titleRechten
workspaces:read, designs:read, designs:writelist_sizesWat hij doet
Invoer
Rechten
create_designWat hij doet
Invoer
form, size, copy, look, personalityRechten
workspaces:read, designs:read, designs:writedesign en create_designs gebruiken de AI-credits van de workspace, net als de Designer in de Studio. Is het saldo te laag, dan falen ze met een melding die dat zegt; waardeer op in Instellingen › AI-credits. Per persoon lopen er hoogstens twee reeksen tegelijk, en een afgeronde reeks blijft ongeveer twintig minuten leesbaar. De ontwerpen zelf blijven bestaan.
Een compositie noemt een size (een formaat-id zoals ig-post, x-post of li-banner, of {w, h} in pixels), een layout (statement, editorial, poster, split, stat, quote, list, event of minimal) en blocks in leesvolgorde, elk met een role zoals headline, body of cta en de bijbehorende 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. Het antwoord bevat het id van het ontwerp, de Studio-link, punten uit de beoordeling en de elementen die zijn geplaatst.Bewerken en exporteren
list_designsWat hij doet
Invoer
personalityRechten
workspaces:read, designs:readget_designWat hij doet
Invoer
id, page, kind, name, textRechten
designs:readedit_designWat hij doet
Invoer
id, ops, pageRechten
designs:writeupdate_design_textWat hij doet
Invoer
id, text (element-id naar tekst)Rechten
designs:read, designs:writeresize_copiesWat hij doet
Invoer
id, sizesRechten
designs:read, designs:writewear_markWat hij doet
Invoer
mark, en design of personalityRechten
render_designWat hij doet
Invoer
id, width, height, format, pageRechten
designs:readexport_design_linkWat hij doet
/ d/ <id>, die iedereen met de link kan openen.Invoer
idRechten
designs:writewear_mark op een ontwerp heeft designs:read en designs:write nodig. Een Mark de Mark van een merk maken vraagt om workspaces:read, designs:read en personalities:write, en om een Mark die jij houdt met een actieve licentie. Noem je de Mark bij zijn code, dan is ook marks:read nodig.
render_design accepteert width en height van 1 tot 4096 pixels en format png of pdf. page telt vanaf 0: PNG rendert standaard de eerste pagina en PDF alle pagina’s. Een PDF houdt elke pagina op het formaat uit de Studio, dus het formaat dat je vraagt, moet daarbij passen. Voor renderen is dezelfde exportlicentie voor de Mark van het ontwerp nodig als in de Studio, en het ontwerp wordt nooit gepubliceerd of gewijzigd.
Video, audio en ondertitels
Gebruik find_uploads om toegestane bronverwijzingen te vinden en daarna edit_design met add_video, update_video, split_video, add_audio, update_audio, split_audio, remove_audio, set_element_timing, set_captions of remove_captions. Verzin nooit de duur van een bron. Videosplitsingen en elementtijden gebruiken seconden binnen de pagina; audiostarts, audiosplitsingen en ondertitels gebruiken seconden van het hele document. Audio verlengt scènes niet. Ondertitels accepteren opgegeven tekst met tijden of SRT/WebVTT-inhoud; automatische transcriptie is niet beschikbaar. get_design geeft de volledige tijdlijn en tracks terug. export_captions geeft SRT/WebVTT-bestandsinhoud in delen van maximaal 100 ondertitels en 48.000 tekens; gebruik nextOffset voor het volgende deel.
Voorbeeldprompts
- “Zoek donkere Marks met chroom erin in de Markt en laat me de drie zien die het dichtst bij diep petrol liggen.” Gebruikt
search_marks. - “Verander de kop van ontwerp 4f1c… in ‘Deuren open om zeven uur’ en maak kopieën voor een Instagramstory en een X-post.” Gebruikt
get_design,update_design_textenresize_copies. - “Render ontwerp 4f1c… als PNG van 1080 bij 1350 en sla het op als launch.png.” Gebruikt
render_design. - “Maak een poster voor ons zonnewendefeest op het dak, 21 juni, van zonsondergang tot zonsopgang.” Gebruikt
design, waarvoorworkspaces:readnodig is.
De volledige referentie voor de endpoints achter deze tools staat op API-referentie. Voor al het andere kun je ons een verzoek sturen.