Kort fortalt
- Gradiently driver en hostet MCP-server på https://gradiently.design/api/mcp, som enhver MCP-klient, der kan sende en Authorization-header, kan forbinde til.
- Du forbinder med en API-nøgle, som en ejer eller admin af arbejdsområdet opretter under Indstillinger, API og agenter, og som sendes som Bearer-token.
- Hver nøgle hører til ét arbejdsområde og har kun de tilladelser, der blev sat kryds ved, da den blev lavet, som at læse designs eller søge i Marks.
- Når den er forbundet, kan en assistent søge i Marks, læse din brandprofil, lave og redigere designs og ændre deres størrelse, og hvert design åbner i Studio.
- En nøgle vises kun én gang, kan tilbagekaldes når som helst og flytter aldrig ejerskabet af et Mark til nogen anden.
På denne side
For at bruge Gradiently MCP-serveren opretter du en API-nøgle under Indstillinger › API og agenter og føjer derefter den hostede endpoint https://gradiently.design/api/mcp til din MCP-klient med headeren Authorization: Bearer <din nøgle>. Det er hele forbindelsen. Derefter kan en assistent som Claude søge i Marks, læse dit brand, lave designs og ændre dem, og hvert design, den laver, åbner i dit Studio som alle andre.
MCP, Model Context Protocol, er en åben standard, der lader AI-assistenter bruge rigtige værktøjer. Er idéen ny, forklarer hvad MCP er den med enkle ord, og protokollens eget site på modelcontextprotocol.io har specifikationen. Den fulde tekniske reference til Gradiently-serveren findes i udviklerdokumentationen.
Det skal du bruge, før du går i gang
- En Gradiently-konto og et arbejdsområde, hvor du er ejer eller admin. Kun ejere og admins kan oprette eller tilbagekalde nøgler.
- En MCP-klient, der kan forbinde til en ekstern server over HTTP og sende en brugerdefineret
Authorization-header. Claude Code kan det, og det kan mange desktop- og editorklienter også. - Et sikkert sted til nøglen, som en adgangskodeadministrator eller din klients hemmelige lager. Den vises kun én gang.
Trin 1: opret en afgrænset API-nøgle
- 1
Åbn Indstillinger › API og agenter
Vælg det arbejdsområde, assistenten skal arbejde i, med vælgeren øverst. En nøgle virker kun i det arbejdsområde, der har udstedt den.
- 2
Navngiv den efter, hvor den bruges
“Claude Desktop” eller “Marketingagent”. Navnet er sådan, du senere ved, hvilken du skal tilbagekalde.
- 3
Sæt kun kryds ved det, den skal bruge
Tilladelserne er anført herunder. Fire er valgt som standard, Sikr dig Marks er ikke.
- 4
Opret, og kopiér den nu
Nøglen vises én gang i sin helhed. Kopiér den ind i din adgangskodeadministrator, før du lukker dialogen. Bagefter viser Indstillinger kun de første tegn, hvornår den sidst blev brugt, og hvor mange tilladelser den har.
| Tilladelse | Hvad den lader assistenten gøre |
|---|---|
| Læs designs | Vise og åbne designs i arbejdsområdet |
| Opret og redigér designs | Lave nye designs og ændre dem |
| Søg Marks | Slå Marks op på Markedet |
| Sikr dig Marks | Sikre sig et Mark for dette arbejdsområde (slået fra som standard) |
| Generér brands | Lave brand-forslag ud fra en beskrivelse |
Trin 2: føj endpointet til din klient
Den samme side viser et færdigt uddrag under Tilslut en MCP-klient med en kopiknap. Klienter, der læser en JSON-konfiguration, tager det, som det er. Sæt din nøgle i stedet for YOUR_KEY.
{
"mcpServers": {
"gradiently": {
"url": "https://gradiently.design/api/mcp",
"headers": { "Authorization": "Bearer YOUR_KEY" }
}
}
}I Claude Code føjer du serveren til fra din terminal. Opbevar nøglen i en miljøvariabel i stedet for at skrive den i din shellhistorik.
claude mcp add --transport http gradiently https://gradiently.design/api/mcp \
--header "Authorization: Bearer $GRADIENTLY_API_KEY"Andre assistenter, herunder ChatGPT, kan forbinde, hvor deres app, abonnement og arbejdsområdeindstillinger tillader en brugerdefineret ekstern MCP-server med en autorisationsheader. Understøttelsen er forskellig mellem klienter og ændrer sig over tid, så tjek din klients egne hjælpesider. Sådan laver du design i dit brand fra ChatGPT beskriver, hvad du skal kigge efter. Når den er forbundet, kan du bede assistenten om at vise sine Gradiently-værktøjer for at bekræfte, at det virkede.
Hvad din assistent kan, når den er forbundet
Serveren udstiller de samme handlinger, som du har i produktet, med de samme tilladelser. Grupperet efter opgave ser de sådan ud:
| Opgave | Hvad assistenten kan |
|---|---|
| Finde | Søge i Marks efter navn, kode eller tone, læse et Marks opskrift, vise dine Marks og finde skabeloner at starte fra |
| Designe | Bede Designer i Gradiently om at lave eller ændre et design ud fra en almindelig anmodning, lave et sæt designs ud fra én brief, starte fra en skabelon og redigere tekst og elementer |
| Ændre størrelse | Gemme kopier af et design i andre størrelser ved siden af originalen, som forbliver uændret |
| Brand | Læse og opdatere et brands profil, generere brand-forslag og sætte et op med et Mark og startdesigns |
| Marks | Forge en Mark-opskrift ud fra en beskrivelse og gemme den som dit private udkast, lægge et Mark på et design og sikre sig et Mark, hvis nøglen tillader det |
| Del og eksportér | Slå et visningslink til et design til eller gengive det som PNG eller PDF, når Marken er sikret |
Almindelige anmodninger virker bedst. Assistenten giver dem videre til Designer, som læser din brandprofil og brandets Mark, før den komponerer noget. Som i Studio måles Designers arbejde i AI-kreditter.
Det, “en plakat til vores solhvervsfest på taget, 21. juni, fra solnedgang til solopgang” kan komme tilbage som: et gemt design på dit brands Mark, klar til at åbne og justere.
- “Lav seks opslag til vores efterårslancering i vores brand, i højformat til Instagram.”
- “Tag gårsdagens bekendtgørelse, og lav en story og en X-header ud af den.”
- “Find tre mørke Marks med et silkemateriale, og fortæl mig deres koder.”
- “Opdatér vores brandprofil: vi lyder rolige og præcise, aldrig salgsagtige.”
For en mere udførlig gennemgang specifikt med Claude, se design med Claude gennem Gradiently. Vil du have assistenten til at blive i dit brand, viser brandguidelines, din AI-assistent kan følge, hvordan du skriver den brandprofil, den læser.
Sådan holder du forbindelsen sikker
Undgå
- Én nøgle med alle tilladelser, delt af alle værktøjer
- At sætte en nøgle ind i en chat, et dokument eller et repository
- At lade nøgler til værktøjer, du er holdt op med at bruge, ligge
- At sætte kryds ved Sikr dig Marks til en agent, der kun designer
Gør
- Én nøgle pr. klient, navngivet efter, hvor den kører
- Opbevar den i en adgangskodeadministrator eller et hemmeligt lager
- Tilbagekald ubrugte nøgler i Indstillinger. De holder op med det samme
- Giv det mindste sæt tilladelser, der virker
Et par garantier gælder, uanset klienten. En nøgle virker kun i det arbejdsområde, der har udstedt den. Den handler efter de samme regler som personen, der oprettede den, så den kan ikke gøre noget, personens rolle ikke kan. En nøgle overfører aldrig ejerskabet af et Mark til arbejdsområdet eller nogen anden. Private designs forbliver private: et visningslink findes kun, når du beder om et. Og fjernes den person, der oprettede en nøgle, fra arbejdsområdet, eller mister vedkommende sin adminrolle, holder personens nøgler også op med at virke.
Spørgsmål, folk stiller
Hvad er Gradiently MCP-endpointet?
Den hostede endpoint er https://gradiently.design/api/mcp. Hver forespørgsel kræver headeren Authorization: Bearer efterfulgt af en API-nøgle fra Indstillinger › API og agenter.
Hvem kan oprette en Gradiently API-nøgle?
Ejere og admins af et arbejdsområde. Hver nøgle hører til netop det ene arbejdsområde og har kun de tilladelser, der blev valgt, da den blev oprettet.
Virker det med ChatGPT?
Det virker med enhver MCP-klient, der kan forbinde til en ekstern HTTP-server og sende en autorisationsheader. Om ChatGPT kan, afhænger af den app, det abonnement og de arbejdsområdeindstillinger, du bruger, så tjek dens aktuelle hjælpesider.
Hvad sker der, hvis min nøgle lækker?
Tilbagekald den i Indstillinger › API og agenter. Alt, der bruger den, holder op med at virke med det samme, og du kan oprette en ny nøgle.
Kan en assistent sikre sig Marks for mig?
Kun hvis dens nøgle har tilladelsen Sikr dig Marks, som er slået fra som standard. At sikre sig et Mark er gratis, mens Gradiently lanceres.
Skrevet af Gradiently
Holdet bag Gradiently, et designværktøj bygget om Marks: levende gradienter, der får alt, du designer, til at ligne dig.
Se vores profil


