MCP og AI-assistenter

Model Context Protocol er en åben standard for at give AI-assistenter værktøjer. Gradiently kører en hostet MCP-server på https://gradiently.design/api/mcp. Forbind den én gang med en API-nøgle, så kan din assistent kalde Gradientlys værktøjer, mens du taler med den. Hvert værktøj laver de samme API-forespørgsler, som din egen kode ville, så det har de samme tilladelser, licenser, kreditter og grænser.

Før du forbinder

• Opret en nøgle i Indstillinger › API og agenter (se API-nøgler og tilladelser). Nøglen afgør, hvilket arbejdsområde assistenten arbejder i, og hvilke værktøjer der virker.
• Hver forespørgsel til serveren skal have nøglen med som Authorization: Bearer gr_live_…, også den første. Uden den svarer serveren 401.
• Serveren taler Streamable HTTP, tilstandsløst, med JSON-svar. Den kræver ingen session og har ingen separat hændelsesstrøm, der skal åbnes.
• Serveren accepterer kun API-nøgler. Den tilbyder ikke login med OAuth.

Forbind Claude Code

Tilføj Gradiently som ekstern server over HTTP med din nøgle i headeren. Gem nøglen i en miljøvariabel, så den aldrig havner i din shell-historik eller i en fil, der bliver committet.

export GRADIENTLY_API_KEY="gr_live_…"

claude mcp add --transport http gradiently https://gradiently.design/api/mcp \
  --header "Authorization: Bearer $GRADIENTLY_API_KEY"

Start en ny session i Claude Code, og bed den om at vise Gradientlys værktøjer for at tjekke forbindelsen. Melder den en godkendelsesfejl, er nøglen skrevet forkert, tilbagekaldt, eller dens skaber er ikke længere ejer eller admin af arbejdsområdet.

Andre klienter

Enhver klient, der kan tilføje en ekstern MCP-server over Streamable HTTP og sende en brugerdefineret header, kan bruge Gradiently med samme URL og header. Om din kan, afhænger af klienten og dens version.

• Claude Desktop og claude.ai tilføjer eksterne servere som brugerdefinerede connectors. Lader formularen dig angive en Authorization-header, så brug URL’en og headeren ovenfor. Tilbyder den kun login med OAuth, kan Gradiently ikke forbindes dér endnu.
• ChatGPT og andre assistenter: samme regel. Hvor klienten understøtter eksterne MCP-servere med en bearer-header, forbinder du den med URL’en og din nøgle.
• Klienter, der konfigureres med en JSON-fil, accepterer ofte formatet nedenfor, som også vises i Indstillinger under Tilslut en MCP-klient. Tjek din klients dokumentation for det præcise format.

{
  "mcpServers": {
    "gradiently": {
      "url": "https://gradiently.design/api/mcp",
      "headers": { "Authorization": "Bearer gr_live_…" }
    }
  }
}

Sådan opfører værktøjerne sig

• Hvert værktøj returnerer sit resultat som JSON-tekst. Når noget fejler, returnerer værktøjet i stedet API’ens fejlbesked, fx en manglende tilladelse eller en ukendt skabelon.
• Værktøjer, der skal bruge et brand, tager en valgfri personality (dens id eller slug). Uden den bruger de arbejdsområdets første brand.
• Værktøjer, der gemmer et design, returnerer dets link til Studiet, designets adresse /studio/<id> på gradiently.design.
• Flere værktøjer slår først dine brands op via /api/me, som kræver både workspaces:read og designs:read. Disse værktøjer viser begge tilladelser nedenfor.
• Et værktøjskald tæller mod din nøgles hastighedsgrænse én gang for MCP-forespørgslen og én gang for hver API-forespørgsel, værktøjet laver.

Marks

Kræver det betaling at sikre sig en Mark, fejler kaldet med en besked om, at det kræver checkout; gør det færdigt i Gradiently. En nøgle kan ikke betale for noget.

Brands og arbejdsområde

tone tager op til tre af calm, bold, warm, cool, playful, luxe, natural, technical, editorial og nocturnal; en forespørgsel med flere afvises. colours tager op til otte hexfarver, og count beder om et til otte forslag; flere end det afvises også. For at vælge et forslag sender du præcis det input, der genererede det, sammen med forslagets key: serveren laver forslaget igen ud fra det input og stoler aldrig på en opskrift sendt af klienten.

Design

design og create_designs bruger arbejdsområdets AI-kreditter, ligesom Designer gør i Studiet. Er saldoen for lav, fejler de med en besked om det; fyld op i Indstillinger › AI-kreditter. Højst to serier kører ad gangen pr. person, og en færdig serie kan læses i omkring tyve minutter. Selve designene bliver.

En komposition angiver en size (et id på en forudindstilling som ig-post, x-post eller li-banner, eller {w, h} i pixels), et layout (statement, editorial, poster, split, stat, quote, list, event eller minimal) og blocks i læserækkefølge, hver med en role som headline, body eller cta og sin 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" }
    ]
  }
}

Redigering og eksport

wear_mark på et design kræver designs:read og designs:write. At gøre en Mark til et brands Mark kræver workspaces:read, designs:read og personalities:write og en Mark, du ejer med en aktiv licens. Angiver du Marken med dens kode, kræves også marks:read.

render_design tager width og height fra 1 til 4096 pixels og format png eller pdf. page tælles fra 0: PNG gengiver som standard den første side og PDF alle sider. En PDF bevarer hver side i dens størrelse fra Studiet, så den størrelse, du beder om, skal passe. Gengivelse kræver samme eksportlicens til designets Mark som i Studiet, og den udgiver eller ændrer aldrig designet.

Eksempler på prompts

• »Find mørke Marks i Markedet med krom i, og vis mig de tre, der ligger tættest på dyb petroleum.« Bruger search_marks.
• »Generér brandretninger til Hearth, et bageri i nabolaget, roligt og varmt, og vælg den med den blødeste palet.« Bruger generate_brand og adopt_brand.
• »Smed en Mark, der hedder Night Harbour: en tom bund, marineblå til natriumorange, ét stille lag korn. Ret alt, hvad gennemgangen påpeger, og gem den så.« Bruger make_mark og save_mark.
• »Skift overskriften på design 4f1c… til ›Dørene åbner klokken syv‹, og lav kopier til en Instagram-story og et opslag på X.« Bruger get_design, update_design_text og resize_copies.
• »Gengiv design 4f1c… som en PNG på 1080 gange 1350, og gem den som launch.png.« Bruger render_design.
• »Lav en plakat til vores solhvervsfest på taget, 21. juni, fra solnedgang til solopgang.« Bruger design, som kræver workspaces:read.

Hele referencen for de endpoints, der ligger bag disse værktøjer, står på API-reference. Til alt andet kan du sende os en forespørgsel.