# Gradiently MCP: anslut Claude, ChatGPT eller valfri MCP-klient

[Canonical HTML page](https://gradiently.design/sv/guide/connect-ai-assistant)

Gradiently talar MCP, så en AI-assistent kan söka Marks, läsa ditt varumärke och göra designer som öppnas i din Studio. Här är uppsättningen på klarspråk, och hur du håller den säker.

## The short version

- Gradiently kör en värdbaserad MCP-server på https://gradiently.design/api/mcp som vilken MCP-klient som helst kan ansluta till, om den kan skicka en Authorization-header.
- Du ansluter med en API-nyckel som en ägare eller admin på arbetsytan skapar i Inställningar, under API och agenter, och som skickas som en Bearer-token.
- Varje nyckel tillhör en arbetsyta och har bara de behörigheter som kryssades i när den skapades, till exempel att läsa designer eller söka Marks.
- När en assistent är ansluten kan den söka Marks, läsa din varumärkesprofil, göra och redigera designer och ändra deras storlek, och varje design öppnas i Studio.
- En nyckel visas en gång, kan återkallas när som helst och flyttar aldrig en Marks ägarskap till någon annan.

För att använda **Gradiently MCP**-servern skapar du en API-nyckel i **Inställningar › API och agenter** och lägger sedan till den värdbaserade slutpunkten `https://gradiently.design/api/mcp` i din MCP-klient, med headern `Authorization: Bearer <din nyckel>`. Det är hela anslutningen. Därefter kan en assistent som Claude söka Marks, läsa ditt varumärke, göra designer och ändra dem, och varje design den gör öppnas i din Studio som vilken annan design som helst.

MCP, Model Context Protocol, är en öppen standard som låter AI-assistenter använda riktiga verktyg. Om idén är ny förklarar [vad MCP är](https://gradiently.design/sv/guide/what-is-mcp) den med enkla ord, och protokollets egen webbplats [modelcontextprotocol.io](https://modelcontextprotocol.io) har specifikationen. Den fullständiga tekniska referensen för Gradiently-servern finns i [utvecklardokumentationen](https://gradiently.design/sv/developers/mcp).

## Det här behöver du innan du börjar

- **Ett Gradiently-konto** och en arbetsyta där du är **ägare eller admin**. Bara ägare och admins kan skapa eller återkalla nycklar.
- **En MCP-klient som kan ansluta till en fjärrserver över HTTP** och skicka en egen `Authorization`-header. Claude Code kan det, och många skrivbords- och redigeringsklienter också.
- **Ett säkert ställe för nyckeln**, till exempel en lösenordshanterare eller klientens hemlighetslagring. Den visas bara en gång.

## Steg 1: skapa en begränsad API-nyckel

1. **Öppna Inställningar › API och agenter** Välj den arbetsyta som assistenten ska arbeta i med väljaren högst upp. En nyckel agerar alltid bara i den arbetsyta som utfärdade den.
2. **Namnge den efter var den används** ”Claude Desktop” eller ”Marknadsföringsagent”. Namnet är hur du vet vilken du ska återkalla senare.
3. **Kryssa bara i det den behöver** Behörigheterna listas nedan. Fyra är ikryssade som standard, **Säkra Marks** är det inte.
4. **Skapa och kopiera den direkt** Nyckeln visas en gång, i sin helhet. Kopiera den till din lösenordshanterare innan du stänger dialogrutan. Efteråt visar Inställningar bara dess första tecken, när den senast användes och hur många behörigheter den har.

| Behörighet | Vad den låter assistenten göra |
| --- | --- |
| Läsa designer | Lista och öppna designer på arbetsytan |
| Skapa och redigera designer | Göra nya designer och ändra dem |
| Söka Marks | Slå upp Marks på Marknaden |
| Säkra Marks | Säkra en Mark för den här arbetsytan (av som standard) |
| Generera varumärken | Skapa varumärkesförslag utifrån en beskrivning |

De behörigheter en nyckel kan ha, så som Inställningar namnger dem. Ge den minsta uppsättning som gör jobbet.

## Steg 2: lägg till slutpunkten i din klient

Samma sida visar ett färdigt utdrag under **Anslut en MCP-klient**, med en kopieringsknapp. Klienter som läser en JSON-konfiguration tar det som det är, med din nyckel i stället för `YOUR_KEY`.

```json
{
  "mcpServers": {
    "gradiently": {
      "url": "https://gradiently.design/api/mcp",
      "headers": { "Authorization": "Bearer YOUR_KEY" }
    }
  }
}
```

Konfigurationen från Inställningar › API och agenter. Håll riktiga nycklar borta från filer som du delar eller checkar in.

I **Claude Code** lägger du till servern från terminalen. Förvara nyckeln i en miljövariabel i stället för att skriva in den i skalets historik.

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

Så lägger du till Gradiently i Claude Code över HTTP.

Andra assistenter, däribland ChatGPT, kan ansluta så snart deras app, abonnemang och arbetsyteinställningar tillåter en egen MCP-fjärrserver med en auktoriseringsheader. Stödet skiljer sig mellan klienter och ändras över tid, så titta i klientens egna hjälpsidor. [Att göra designer i ditt varumärke från ChatGPT](https://gradiently.design/sv/guide/design-with-chatgpt) tar upp vad du ska leta efter. När den är ansluten ber du assistenten lista sina Gradiently-verktyg för att bekräfta att det fungerade.

## Vad din assistent kan göra när den är ansluten

Servern erbjuder samma åtgärder som du har i produkten, genom samma behörigheter. Grupperade efter jobb ser de ut så här:

| Jobb | Vad assistenten kan göra |
| --- | --- |
| Hitta | Söka Marks på namn, kod eller ton, läsa en Marks recept, lista dina Marks och hitta mallar att utgå från |
| Designa | Be Gradiently egen Designer göra eller ändra en design utifrån en vanlig förfrågan, göra en serie designer utifrån en brief, utgå från en mall och redigera text och element |
| Ändra storlek | Spara kopior av en design i andra storlekar, bredvid originalet, som förblir oförändrat |
| Varumärke | Läsa och uppdatera ett varumärkes profil, generera varumärkesförslag och sätta upp ett med en Mark och startdesigner |
| Marks | Smida ett Mark-recept utifrån en beskrivning och spara det som ditt privata utkast, lägga en Mark på en design, säkra en Mark om nyckeln tillåter det |
| Dela och exportera | Slå på en länk med enbart visning för en design, eller rendera den som PNG eller PDF när Marken är säkrad |

Varje design som assistenten gör sparas på din arbetsyta och kommer tillbaka med en länk som öppnar den i Studio.

Vanliga förfrågningar fungerar bäst. Assistenten lämnar dem vidare till Designer, som läser din varumärkesprofil och varumärkets Mark innan den komponerar något. Precis som i Studio mäts Designers arbete i AI-krediter.

En stående evenemangsaffisch för en solståndsfest på taket mot en glödande gradientbakgrund

Vad ”en affisch till vår solståndsfest på taket, 21 juni, från solnedgång till soluppgång” kan bli: en sparad design på ditt varumärkes Mark, redo att öppna och justera.

- ”Gör sex inlägg till vår höstlansering i vårt varumärke, stående format för Instagram.”
- ”Ta gårdagens tillkännagivande och gör en story och en X-header av det.”
- ”Hitta tre mörka Marks med siden som material och berätta koderna för mig.”
- ”Uppdatera vår varumärkesprofil: vi låter lugna och exakta, aldrig säljiga.”

För en fullständigare genomgång med Claude specifikt, se [att designa med Claude via Gradiently](https://gradiently.design/sv/guide/design-with-claude). Om du vill att assistenten ska hålla sig till varumärket visar [varumärkesriktlinjer som din AI-assistent kan följa](https://gradiently.design/sv/guide/brand-guidelines-for-ai) hur du skriver den varumärkesprofil den läser.

## Så håller du anslutningen säker

### Undvik

- En nyckel med alla behörigheter, delad av alla verktyg
- Att klistra in en nyckel i en chatt, ett dokument eller ett arkiv
- Att lämna kvar nycklar för verktyg du slutat använda
- Att kryssa i Säkra Marks för en agent som bara designar

### Gör så här

- En nyckel per klient, namngiven efter var den körs
- Att förvara den i en lösenordshanterare eller hemlighetslagring
- Att återkalla oanvända nycklar i Inställningar, de slutar fungera direkt
- Att ge den minsta uppsättning behörigheter som fungerar

Några garantier gäller oavsett vad klienten gör. En nyckel fungerar bara i den arbetsyta som utfärdade den. Den agerar enligt samma regler som personen som skapade den, så den kan inte göra något som deras roll inte kan. En nyckel överför aldrig en Marks ägarskap till arbetsytan eller någon annan. Privata designer förblir privata: en länk med enbart visning finns bara när du ber om en. Och om personen som skapade en nyckel tas bort från arbetsytan eller förlorar sin adminroll slutar även hens nycklar att fungera.

> **Att arbeta i ett team** Nycklar tillhör en arbetsyta, så en agents designer hamnar där dina lagkamrater kan se och kommentera dem. [Att arbeta med ett team i Gradiently](https://gradiently.design/sv/guide/teams-and-workspaces) tar upp roller och delning.

## FAQ

### Vilken är Gradiently MCP-slutpunkten?

Den värdbaserade slutpunkten är `https://gradiently.design/api/mcp`. Varje förfrågan kräver headern `Authorization: Bearer` följt av en API-nyckel från Inställningar › API och agenter.

### Vem kan skapa en Gradiently API-nyckel?

Ägare och admins på en arbetsyta. Varje nyckel tillhör just den arbetsytan och har bara de behörigheter som kryssades i när den skapades.

### Fungerar det med ChatGPT?

Det fungerar med vilken MCP-klient som helst som kan ansluta till en HTTP-fjärrserver och skicka en auktoriseringsheader. Om ChatGPT kan det beror på app, abonnemang och arbetsyteinställningar, så titta i dess aktuella hjälpsidor.

### Vad händer om min nyckel läcker?

Återkalla den i Inställningar › API och agenter. Allt som använder den slutar fungera direkt, och du kan skapa en ny nyckel.

### Kan en assistent säkra Marks åt mig?

Bara om dess nyckel har behörigheten Säkra Marks, som är av som standard. Att säkra är gratis medan Gradiently lanseras.