Gradiently heeft een HTTP-API en een gehoste MCP-server. Verbind een assistent via OAuth of met een API-sleutel voor een werkruimte. De server accepteert OAuth-toegangstokens en API-sleutels voor werkruimten. Voor beide gelden dezelfde rechten, licenties, credits en limieten.
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.
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
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
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.
# 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"Wil je in plaats daarvan de API aanroepen, stuur dan dezelfde header mee met elke request:
curl https://gradiently.design/api/marks?q=harbour \
-H "Authorization: Bearer $GRADIENTLY_API_KEY"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.